项目简介

Draw.io MCP 服务器是一个遵循 Model Context Protocol (MCP) 标准的后端服务，旨在将流行的图示工具 Draw.io (diagrams.net) 的强大功能暴露给 AI 代理系统。通过这个服务器，AI 可以通过结构化的方式理解和操作 Draw.io 图表。

主要功能点

该服务器通过提供以下工具实现对 Draw.io 图表的控制和信息提取：

• 获取选中元素: 获取当前在 Draw.io 中选中的图表元素（如图形或连线）的详细信息。
• 获取图形库分类: 查看 Draw.io 图形库中可用的分类列表。
• 获取分类下图形: 获取指定分类下的所有图形详细信息。
• 根据名称获取图形: 在整个图形库中按名称查找特定图形的信息。
• 添加矩形: 在图表中指定位置添加一个矩形图形，可自定义尺寸、文本和样式。
• 添加连线: 在两个现有图表元素之间创建一条连线，可添加文本和样式。
• 根据 ID 删除元素: 根据元素的唯一 ID 删除图表中的图形或连线。
• 根据图形名称添加元素: 在图表中根据图形库中的特定图形名称添加一个新的图形元素，可自定义位置、尺寸、文本和样式。

安装步骤

1. 安装 Node.js: 确保系统已安装 Node.js (版本 18 或更高)。
2. 安装 Draw.io MCP 浏览器扩展: 前往 Draw.io (app.diagrams.net) 网页版，并安装配套的浏览器扩展（如 Chrome Web Store 或 Firefox Add-ons 中的 "Draw.io MCP Extension"）。确保扩展连接成功（通常扩展图标会显示指示）。
3. 配置 MCP 客户端: 你需要一个支持 MCP 协议的客户端（如 Claude Desktop 或 oterm）来与服务器连接。

服务器配置

MCP 服务器通常由 MCP 客户端负责启动和管理连接。你需要在 MCP 客户端的配置文件中添加如下格式的配置信息（具体的配置文件的位置和语法请参考你的 MCP 客户端文档），告诉客户端如何启动 Draw.io MCP 服务器：

• 服务器名称 (server name): 一个唯一的标识符，例如 'drawio'。
• 启动命令 (command): 指定用于启动服务器的可执行命令。根据你的包管理器，可以是 'npx' 或 'pnpm'。
• 命令参数 (args): 指定传递给启动命令的参数。对于 'npx' 或 'pnpm'，通常是 '-y' (或 'dlx' 对于 pnpm) 和服务器包的名称 'drawio-mcp-server'。

例如，一个典型的配置项会包含服务器名称、command 和 args 三部分，客户端通过执行指定的 command 和 args 来启动这个 MCP 服务器进程。

基本使用方法

1. 确保 Draw.io 在浏览器中打开，并且 Draw.io MCP 浏览器扩展已安装并连接成功。
2. 配置并启动你的 MCP 客户端（通常客户端启动时会自动根据配置启动 MCP 服务器）。
3. 使用与你的 MCP 客户端集成的 LLM，通过调用服务器暴露的工具（如上述主要功能点列表中的工具）来与 Draw.io 图表进行交互。LLM 可以根据你的指令调用相应的工具来查询图表信息或修改图表内容。