drawx-mcp-server

@drawx/mcp-server

在 Claude、Cursor 或 VS Code 中生成 draw.io 图表和架构设计。

DrawX MCP 是一个 Model Context Protocol 服务，为你的 AI 助手提供三个工具：

• generate_diagram — 一步完成：自然语言提示词 → 完整的 draw.io XML。
• architect_design — 根据简要说明生成高层设计图（可选生成 LLD 和设计文档）。
• whoami — 验证你的 API 密钥并查看剩余配额。

它在幕后调用 DrawX 公共 API，因此输出与 DrawX 网页应用完全一致。

---

要求

• Node.js 18+
• 一个 DrawX API 密钥 — 在 DrawX → Settings → API keys 中创建。密钥以 drawx_live_ 开头。API 访问是付费功能（包含在 DrawX Pro 计划中）。

安装

npm install -g @drawx/mcp-server

或者，如果你的 MCP 客户端支持 npx，则无需安装 — 直接引用 npx @drawx/mcp-server 即可。

配置 MCP 客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "drawx": {
      "command": "npx",
      "args": ["-y", "@drawx/mcp-server"],
      "env": {
        "DRAWX_API_KEY": "drawx_live_..."
      }
    }
  }
}

重启 Claude Desktop。在新的聊天中，询问 "为我绘制一个微服务结账流程" — Claude 将调用 generate_diagram 并显示生成的 XML。

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "drawx": {
      "command": "npx",
      "args": ["-y", "@drawx/mcp-server"],
      "env": { "DRAWX_API_KEY": "drawx_live_..." }
    }
  }
}

VS Code（Copilot MCP）

在工作区或用户的 settings.json 中添加：

{
  "mcp": {
    "servers": {
      "drawx": {
        "command": "npx",
        "args": ["-y", "@drawx/mcp-server"],
        "env": { "DRAWX_API_KEY": "drawx_live_..." }
      }
    }
  }
}

---

环境变量

变量	必需	用途
DRAWX_API_KEY	是	你的 DrawX API 密钥（drawx_live_...）。
DRAWX_API_BASE	否	覆盖 API 基础 URL（默认为 https://getdrawx.com/api/v1）。适用于暂存环境。

工具参考

generate_diagram

将描述转换为 draw.io XML。

输入

• prompt（字符串，必需）— 要绘制的内容。
• mode — "flash"（默认）、"pro" 或 "ultra"。在速度和质量之间进行权衡。
• previousXml — 要修改的现有 mxfile。

输出 — 助手文本：一行摘要（模型、令牌数、费用），后跟完整的 <mxfile>...</mxfile> XML（位于围栏代码块中）。将 XML 粘贴到 diagrams.net 或保存为 .drawio 文件。

architect_design

根据简要说明运行 DrawX Architect Co-Pilot。会流式传输中间进度；返回包含 hld（以及可选的 lld、doc）的 JSON 负载。

输入

• brief（字符串，必需，≥ 20 个字符）— 要设计的内容。
• depth — "hld"、"hld_lld"（默认）或 "hld_lld_doc"。
• style — "cloud_agnostic"（默认）、"aws"、"azure" 或 "gcp"。
• mode — "flash"（默认）、"pro" 或 "ultra"。

whoami

无需输入。返回你的电子邮箱、计划、API 层级和每月剩余 API 配额。

配额和速率限制

API 用量与应用内用量按单独的层级计量。Pro 订阅用户每月可进行 200 次 API 调用。速率限制为每分钟 60 个请求。免费计划不提供 API 访问 — 请在 getdrawx.com 升级。

本地开发

git clone https://github.com/SaharshPamecha/drawx-mcp-server
cd drawx-mcp-server
npm install
npm run build
DRAWX_API_KEY=drawx_live_... node dist/index.js  # runs over stdio; use an MCP inspector
npm test

许可证

MIT © 2026 DrawX