@processon/mcp-server-processon-node

🧠 基于 Node.js + TypeScript 实现的 ProcessOn MCP Server，支持从 Markdown 内容自动生成思维导图。

📦 项目地址

• GitHub: https://github.com/liqi888/mcp-server-processon-node

• npm: https://www.npmjs.com/package/@processon/mcp-server-processon-node

⚙️ 环境变量配置

• 服务通过环境变量读取 ProcessOn 配置信息：

变量名	是否必须	说明
PROCESSON_API_KEY	✅ 是	你的 ProcessOn API 密钥（可在 www.processon.com 账户中心 获取）
BASE_URL	❌ 否	自定义 API 地址（默认使用官方地址）

• 在项目根目录下创建 .env 文件，或通过环境变量方式传入以下配置：

# 必填，用于调用 ProcessOn 接口
PROCESSON_API_KEY=你的 API Key

# 可选，自定义 ProcessOn 服务地址
BASE_URL=https://www.processon.com

---

🧠 支持的工具能力（Tools）

1. check

• 作用：检查当前配置的 PROCESSON_API_KEY 是否生效。
• 输入参数：无
• 返回：当前 API_BASE 和 API_KEY 的拼接值

---

2. createProcessOnMind

• 作用：根据 Markdown 内容生成思维导图，并返回可视化链接。
• 输入参数：
  • title: string，思维导图文件名
  • content: string，Markdown 内容，支持二级以上标题和列表格式
• 输出结果：成功返回 https://www.processon.com/mindmap/xxxxxx 的可访问地址

---

🧰 本地开发与调试（项目开发或维护者使用）

1. 将GitHub项目下载到本地

mcp-server-processon-node/
├── src/                        # 源代码目录（TypeScript 源文件）
│   └── index.ts                # 服务主入口，定义 MCP 方法、注册 Handler 等
├── chatmcp.yaml                # MCP 配置文件，用于描述服务元信息、能力、参数
├── package.json                # NPM 项目配置文件，定义依赖、脚本、元数据
├── package-lock.json           # 锁定依赖版本，确保构建一致性
├── tsconfig.json               # TypeScript 编译配置文件
└── README.md                   # 项目说明文档（功能简介、安装、用法等）
       

2. 终端进入到项目根目录执行以下命令

# 安装依赖
npm install

# 本地开发时持续监听构建
npm run watch

# 构建项目
npm run build

# 使用 npm link 注册本地命令
npm link

3. Cherry Studio 本地配置示例：

• 说明：启动成功后即可在右侧工具栏中看到 check 和 createProcessOnMind 两个工具接口。

"processon_mind_local": {
    "name": "ProcessOn_CreateMind",
    "type": "stdio",
    "description": "ProcessOn创建思维导图",
    "isActive": true,
    "registryUrl": "",
    "command": "npx",
    "args": [
      "mcp-server-processon-node"
    ],
    "env": {
      "PROCESSON_API_KEY": "{YOU PROCESSON_API_KEY}"
    }
}

4. 打包发布到 npm

# 登录
npm login

# 发布
npm publish --access public

---

🧩 Cherry Studio 正式包配置示例：

字段	值
类型	标准输入/输出（stdio）
命令	npx
参数	@processon/mcp-server-processon-node@latest
环境变量	PROCESSON_API_KEY={YOU PROCESSON_API_KEY}

说明：

1. @latest 可以替换成具体的版本号（例如 @1.0.9）

2. 你的 ProcessOn API 密钥可在 www.processon.com 账户中心获取

# 底层实际执行命令

npx @processon/mcp-server-processon-node@latest

3. 启动成功后即可在右侧工具栏中看到 check 和 createProcessOnMind 两个工具接口。

4. JSON配置示例

"processon_mind_online": {
    "name": "ProcessOn_CreateMind",
    "type": "stdio",
    "description": "ProcessOn创建思维导图",
    "isActive": true,
    "registryUrl": "",
    "command": "npx",
    "args": [
      "@processon/mcp-server-processon-node@latest"
    ],
    "env": {
      "PROCESSON_API_KEY": "{YOU PROCESSON_API_KEY}"
    }
}

---

🚀 安装使用

方式一：通过 npx 启动（推荐）

npx @processon/mcp-server-processon-node@latest

⚠️ 若执行卡在 dotenv 提示不动，建议手动指定版本并添加环境变量 .env 文件。

---

方式二：全局安装后使用

npm install -g @processon/mcp-server-processon-node

# 启动服务
mcp-server-processon-node

---

方式三：作为依赖引入到 Node 项目中

npm install @processon/mcp-server-processon-node

---

📄 License

MIT © 2025 琪天大圣