● 官方 jgraph ⚡ 即开即用

draw.io MCP

Name: draw.io MCP MCP Server
Author: jgraph

First-party draw.io MCP — Claude authors and edits .drawio diagrams as XML, validates against the schema, and exports to PNG/SVG.

draw.io's official MCP lets Claude work with its native XML diagram format. Use it to generate architecture diagrams from prose, edit existing diagrams via instructions, validate XML, and export to SVG/PNG for embedding in PRs and docs.

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

Generate diagrams from natural-language description
Edit existing .drawio XML in place
Validate against draw.io schema
Export PNG / SVG / PDF
Mermaid → drawio conversion
Library of common shape stencils

实时演示

实际使用效果

就绪

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "drawio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jgraph/drawio-mcp"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "drawio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jgraph/drawio-mcp"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "drawio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jgraph/drawio-mcp"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "drawio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jgraph/drawio-mcp"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "drawio-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@jgraph/drawio-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "drawio-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@jgraph/drawio-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add drawio-mcp -- npx -y @jgraph/drawio-mcp

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： draw.io MCP

Generate an architecture diagram from a README

👤 Developers ⏱ ~15 min intermediate

何时使用： PR adds a new service; you want a diagram for the design doc.

步骤

Describe

Paste the README prose; ask for an architecture diagram.✓ 已复制

→ XML drawio generated
Validate

drawio_validate the XML.✓ 已复制

→ Schema OK
Export

Export to SVG; embed in the design doc.✓ 已复制

→ SVG ready to commit

结果： Diagram lives in repo as both .drawio (editable) and .svg (renderable).

组合

与其他 MCP 搭配，撬动十倍杠杆

drawio-mcp + filesystem

Save .drawio + .svg next to the doc that references them

Combine drawio-mcp with filesystem: Save .drawio + .svg next to the doc that references them✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
generate_diagram	(see docs)	NL → drawio XML	1 call
edit_diagram	(see docs)	Apply instructions to existing XML	1 call
validate	(see docs)	Schema-check XML	1 call
export	(see docs)	Render to PNG / SVG / PDF	1 call

成本与限制

运行它的成本

API 配额: N/A (local rendering)
每次调用 Token 数: XML is moderate size
费用: Free OSS
提示: Keep .drawio source in repo; commit .svg next to it for previews

安全

权限、密钥、影响范围

凭据存储： No credentials

数据出站： None (local)

故障排查

常见错误与修复

Validation fails on generated XML

Ask the model to regenerate citing the schema; common issues: missing geometry parents

Exported SVG huge

Use --simplify; flatten transforms before export

替代方案

draw.io MCP 对比其他方案

替代方案	何时用它替代	权衡
Mermaid (text-only)	Simple flow / sequence diagrams	Less control over layout
Excalidraw MCP	You prefer hand-drawn aesthetic	Different file format

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills