mcp-server-processon-node

liqi888/mcp-server-processon-node

3.2

If you are the rightful owner of mcp-server-processon-node and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides a structured summary of a Model Context Protocol (MCP) server developed using Node.js for ProcessOn.

@processon/mcp-server-processon-node

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

📦 项目地址

⚙️ 环境变量配置

  • 服务通过环境变量读取 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

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

  2. 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 琪天大圣