Local Draw.io MCP

本地 STDIO MCP 服务，用于让 Codex 直接创建和维护可编辑的 draw.io XML 文件。

工具

• server_info：查看版本及允许访问的目录。
• create_diagram：根据分组、节点和连线创建 .drawio。
• inspect_diagram：读取第一页的节点、连线和几何信息。
• validate_diagram：检查重复 ID、无效坐标、越界、失效连线和节点重叠。
• update_diagram：添加节点/连线，或修改已有节点。

文件中的文字只作为数据处理，不作为 MCP 指令执行。

本地运行

npm install
npm test
npm start

npm start 使用 STDIO，正常启动后会等待 MCP 客户端连接，不会显示交互式界面。

接入 Codex

在 Codex 桌面版中打开“设置 → MCP servers → Add server”，选择 STDIO，然后填写：

• Command：C:\Program Files\nodejs\node.exe
• Arguments：本项目的 src\server.mjs 绝对路径
• Working directory：本项目目录

也可复制 config.example.toml 的内容到 ~/.codex/config.toml，修改其中路径后重启 Codex。

在 Codex CLI 中可运行：

codex mcp list

在会话输入框中可使用 /mcp 查看连接状态。

路径限制

通过以下环境变量控制访问范围，Windows 下使用分号分隔多个目录：

• DRAWIO_MCP_READ_ROOTS
• DRAWIO_MCP_WRITE_ROOTS

未配置时仅允许访问本 MCP 项目目录。建议只开放项目工作区，不要把整个磁盘配置为可写。

调用示例

连接后可直接告诉 Codex：

使用 drawio MCP 创建一个包含数据平台层、预警引擎层和响应反馈层的 主动预警系统.drawio，完成后运行 validate_diagram 校验。

创建工具默认不会覆盖已有文件；需要覆盖时必须显式传入 overwrite=true。