ProcessOn MCP Server

让 AI 助手（Claude Desktop、Codex CLI、DeepSeek Harness/dsh、Cursor、Windsurf、WorkBuddy 等）直接创建和编辑 ProcessOn 在线流程图、思维导图、时序图、ER图、甘特图等各类图表。

✨ 特性

• ⚡ 一句话安装：一条命令自动检测环境、配置所有主流 AI 客户端
• 🗺️ 支持所有 Mermaid 类型：flowchart、sequenceDiagram、classDiagram、stateDiagram-v2、erDiagram、gantt、journey、gitGraph、pie、mindmap、C4 等
• 🧠 24+ 思维导图场景：内置场景指导（PRD/OKR/WBS/读书笔记/SOP/故障树/竞品等），AI 自动匹配合适深度
• 🖼️ 对话内联预览：缩略图直接在对话中渲染，预览/编辑链接可点击
• 🔄 自动更新：使用 @latest 标签时，npx 自动拉取新版本（也可固定版本）
• 🧠 免 Skill 安装：通过 MCP instructions 字段自动下发使用指引，连接即可用

🚀 快速开始（推荐：一键安装）

在系统终端里运行这一行命令，自动安装包并配置 Claude Desktop + Codex CLI + dsh：

npx -y @qqq3qqq/processon-openapi-mcp@latest install --api-key=你的API密钥

API 密钥获取地址：https://api-v5.processon.com/demotest/admin

脚本会自动：

• 全局安装最新版包（解决首次启动慢和沙箱网络问题）
• 自动检测 node 路径（完美支持 nvm / fnm / Homebrew / 官网 pkg）
• 备份原有配置
• 写入 Claude Desktop、Codex CLI、dsh web 配置
• 输出其他客户端（Cursor/Windsurf）的配置片段

安装后按提示重启对应客户端即可使用。

测试：重启后对 AI 说「画一个用户登录流程图」。

📦 各客户端详细安装说明

如果一键安装失败，或你只想手动配置某个客户端，按以下对应章节操作。

1. Claude Desktop

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

方式 A — 稳定模式（推荐，node 直连）：

在 mcpServers 字段里添加：

{
  "mcpServers": {
    "processon": {
      "command": "/你的node绝对路径/bin/node",
      "args": ["/全局node_modules路径/@qqq3qqq/processon-openapi-mcp/dist/index.js"],
      "env": {
        "PROCESSON_API_KEY": "你的API密钥",
        "PATH": "/node所在目录:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
      }
    }
  }
}

路径获取方法（在终端运行）：

echo "node: $(which node)"
echo "mcp入口: $(npm root -g)/@qqq3qqq/processon-openapi-mcp/dist/index.js"

方式 B — npx 自动更新模式：

{
  "mcpServers": {
    "processon": {
      "command": "/你的node绝对路径/bin/npx",
      "args": ["-y", "@qqq3qqq/processon-openapi-mcp@latest"],
      "env": {
        "PROCESSON_API_KEY": "你的API密钥",
        "PATH": "/node所在目录:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin",
        "NPM_CONFIG_REGISTRY": "https://registry.npmjs.org/"
      }
    }
  }
}

⚠️ npx 模式依赖缓存，首次启动和版本更新时需要联网。如果清缓存或在沙箱严格的环境下出现 "Server disconnected"，请用方式 A。

生效： Cmd+Q（macOS）完全退出 Claude Desktop，再重新打开。

2. Codex CLI (OpenAI)

在终端运行：

codex mcp add processon --env PROCESSON_API_KEY=你的API密钥 --env PATH="$(dirname $(which node)):/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin" -- $(which node) $(npm root -g)/@qqq3qqq/processon-openapi-mcp/dist/index.js

或使用 npx 自动更新模式：

codex mcp add processon --env PROCESSON_API_KEY=你的API密钥 --env PATH="$(dirname $(which node)):/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin" -- npx -y @qqq3qqq/processon-openapi-mcp@latest

生效： 重启 Codex。

3. DeepSeek Harness (dsh web)

编辑 ~/.dsh/profiles/web/cordis.patch.yml，在 insert 列表里添加：

- insert:
    - id: mcp-processon
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        transport: stdio
        serverName: processon
        command: /你的node绝对路径/bin/node
        args:
          - /全局node_modules路径/@qqq3qqq/processon-openapi-mcp/dist/index.js
        env:
          PROCESSON_API_KEY: '你的API密钥'
          PATH: '/node所在目录:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin'
        toolCallTimeoutMs: 60000
        failOnStartupError: false
        reconnect:
          enabled: true
          initialDelayMs: 1000
          maxDelayMs: 30000
          maxAttempts: 10

路径获取：

echo "command: $(which node)"
echo "args[0]: $(npm root -g)/@qqq3qqq/processon-openapi-mcp/dist/index.js"

重启 dsh：

lsof -ti:3080 | xargs kill -9 2>/dev/null
cd /path/to/deepseek-harness && pnpm dsh web

💡 dsh 必须用 node 直连模式。dsh MCP 子进程沙箱网络限制严格，npx 模式会在缓存失效后启动失败。

4. Cursor

打开 Settings → MCP → Add new global MCP server，粘贴：

{
  "mcpServers": {
    "processon": {
      "command": "npx",
      "args": ["-y", "@qqq3qqq/processon-openapi-mcp@latest"],
      "env": {
        "PROCESSON_API_KEY": "你的API密钥"
      }
    }
  }
}

💡 v3.1.3+ 后 npx 直接调用包名就能正确启动 MCP server（因为包名同名 bin 入口已添加）。如果你的 PATH 里找不到 npx，改用 node 绝对路径方式（参考 Claude Desktop 方式 A）。

5. Windsurf / WorkBuddy / 其他 MCP 客户端

在工具/插件/MCP 设置中添加 stdio 类型的 server：

| 字段 | 值 | |------|-----| | Command | npx | | Args | ["-y", "@qqq3qqq/processon-openapi-mcp@latest"] | | Env | PROCESSON_API_KEY=你的密钥 |

6. 直接让 AI 客户端帮你配置

如果你在 Claude Desktop/Cursor/Codex 里打开了一个有终端权限的对话，也可以直接把这段话发给 AI，让它帮你执行安装：

请帮我安装 ProcessOn MCP server，API key 是 你的API密钥。
安装步骤：
1. 运行 npm install -g @qqq3qqq/processon-openapi-mcp@latest
2. 运行 npx -y @qqq3qqq/processon-openapi-mcp install --api-key=你的API密钥
3. 告诉我重启应用的方式

🛠️ 工具列表

| 工具名 | 功能 | |--------|------| | create_diagram | 通过 Mermaid 创建任意类型图表 | | create_mindmap | 通过 Markdown 创建思维导图 | | create_blank_diagram | 创建空白图表（仅用户明确要求空白时） | | import_diagram_file | 导入本地 drawio/vsdx/xmind/mermaid/md/dsl 等文件 | | update_diagram | 通过 fileId 覆盖更新 | | check_api_usage | 查询 API 用量 |

支持的 Mermaid 类型： flowchart、sequenceDiagram、classDiagram、stateDiagram-v2、erDiagram、gantt、journey、gitGraph、pie、mindmap、C4Context/Container/Component、requirementDiagram

支持的文件格式：

• 流程图：.mermaid .mmd .pos .posf .drawio .vsdx .vsd .vdx .dsl (swimlane)
• 思维导图：.md .posm .xmind .xls

🔧 更新版本

node 直连模式：

npm install -g @qqq3qqq/processon-openapi-mcp@latest

然后重启 AI 客户端，无需改配置。

npx 模式：无需操作，npx 缓存过期时自动拉取新版本。

📋 前置条件

• Node.js 18+
• ProcessOn API Key（从 https://api-v5.processon.com/demotest/admin 获取）

📄 API 文档

接口文档：https://api-v5.processon.com/demotest/third-party-file-convert-test.html

License

MIT