pace-mcp

让 AI 助手（CodeBuddy / WorkBuddy）直接操作浏览器里打开的 PACE 编辑器画架构图。

链路：AI →（MCP 工具）→ pace-mcp（本机 127.0.0.1:8765）→（WebSocket）→ 编辑器页面 → 引擎 API

页面即执行端，无需后端、无需域名与证书。

在 CodeBuddy 里配置

在用户级 ~/.codebuddy/mcp.json（或项目 .codebuddy/mcp.json）加入：

{
  "mcpServers": {
    "pace": {
      "command": "npx",
      "args": ["-y", "pace-mcp@latest"],
      "type": "stdio"
    }
  }
}

需要本机 Node.js ≥ 18（无需 clone 仓库、无需 npm install）。

本地开发/调试时改用源码启动：

{
  "mcpServers": {
    "pace": {
      "command": "node",
      "args": ["/绝对路径/sigma-canvas/pace-mcp/bin/pace-mcp.js"],
      "type": "stdio"
    }
  }
}

⚠️ 改完配置或升级包版本后，请完全重启 CodeBuddy（仅「重载窗口」可能复用旧的 MCP 子进程，导致新工具不生效）。

使用

1. 浏览器打开编辑器：https://pace.pages.woa.com/playground/?ai=1（?ai=1 打开即自动接入），或点右上角 AI 按钮手动接入；
2. 在 CodeBuddy 里说：

用 pace 给我画一个「负载均衡 + 两台云服务器 + 云数据库 MySQL」的最小架构

AI 会依次调用 pace_status → pace_add_nodes → pace_connect → pace_fit_view，画布实时出现图元。

工具清单

• pace_status / pace_list_assets / pace_get_graph
• pace_add_nodes / pace_add_groups / pace_connect
• pace_move_nodes / pace_group_nodes / pace_select_nodes
• pace_set_text / pace_delete
• pace_fit_view / pace_set_mode / pace_set_theme（浅色/暗色）/ pace_set_flow（连线流动效果）
• pace_undo / pace_redo
• pace_new_diagram（新建空白架构图）/ pace_list_diagrams（列出已保存的图）/ pace_open_diagram（切换图）
• pace_export（导出 Detail/SVG/PNG 到 ~/Downloads）/ pace_clear

安全边界

• 只监听 127.0.0.1，外部机器无法连接；
• 校验 WS 握手的 Origin，默认只放行 pace.pages.woa.com 与本地 5275；
• 只有用户在页面上显式接入（点按钮或 ?ai=1）才建立会话。

参数

node bin/pace-mcp.js --port 8899
node bin/pace-mcp.js --origin https://my.pace.example.com