mcp -processon-node

This MCP server integrates ProcessOn into an MCP (Model Context Protocol) workflow. It exposes two capabilities: check and createProcessOnMind. The check tool validates your ProcessOn API key is usable by querying the API_BASE and API_KEY combination, helping you verify authentication and configuration. The createProcessOnMind tool accepts Markdown content and a title, generating a ProcessOn mind map from the content and returning a shareable ProcessOn mind map URL. To use these tools, you need to provide your ProcessOn API key via the PROCESSON_API_KEY environment variable (and optionally customize the API base via BASE_URL). When running, the server will expose its MCP interfaces and accept input according to the defined tool signatures, enabling you to quickly convert Markdown outlines into visual mind maps on ProcessOn.

Prerequisites:

• Node.js (recommended version matching the project requirements) and npm installed on your machine.
• Access to a ProcessOn API key (PROCESSON_API_KEY).

Installation steps:

1. Install the MCP server package (via npx or your preferred method):

# Using npx (recommended per project README)
npx @processon/mcp-server-processon-node@latest

2. Alternatively, install globally or locally as a dependency in your own project:

# Global install (optional)
npm install -g @processon/mcp-server-processon-node
# Run after global install
mcp-server-processon-node

3. Prepare configuration:

• Create a .env file or export environment variables, at minimum:

export PROCESSON_API_KEY=your_processon_api_key
# Optional
export BASE_URL=https://www.processon.com

4. Run the server and verify tools are available (check the MCP interface and the createProcessOnMind capability).

Notes:

• If you encounter dotenv loading delays, pin to a specific version and ensure your environment variables are set before starting the process.

Tips and notes:

• Make sure PROCESSON_API_KEY is valid and has the necessary permissions in ProcessOn account settings.
• If BASE_URL is not set, the server will default to the official ProcessOn API endpoint.
• When using npx, @latest can be replaced with a specific version tag to ensure stability.
• The createProcessOnMind tool expects Markdown with at least level-2 headings and list items to generate a meaningful mind map.
• If you run into network or API rate limits, consider adding retry logic or rate limiting in your integration.
• In development, you can use npm link or local builds to test changes quickly.