draw-mcp
为Claude Code设计的draw.io XML生成与验证工具,确保图表质量。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:draw-mcp。 它的用途是:为Claude Code设计的draw.io XML生成与验证工具,确保图表质量。 完整的 Skill 内容见:https://321skill.com/skills/draw-mcp/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“创建一个展示微服务架构的组件图,包含API网关、用户服务和订单服务。”,它会生成结构清晰、样式规范、符合验证规则的draw.io XML代码。您也可以说:“为这个流程图添加泳道,区分前端和后端。”,AI会应用预设的容器和布局规则来生成高质量的图表。
介绍
draw-mcp解决了在AI辅助下生成draw.io图表时,XML代码质量参差不齐、布局混乱、风格不统一的问题。它通过一个包含31条规则的验证器,对生成的图表进行严格检查,确保其结构正确、样式规范,并支持多种预设和验证模式。
使用方式非常简单,在Claude Code中安装该Skill后,当您要求AI绘制流程图、架构图等图表时,它会自动应用此技能生成符合规范的draw.io XML代码。您还可以使用其CLI工具对已有的.drawio文件进行离线验证,支持标准、严格、生产等多种模式,并可集成到CI/CD流程中。
该工具非常适合需要产出高质量、可维护、风格统一的生产级技术图表(如系统架构图、流程图、网络拓扑图)的团队和个人。尤其适合对图表细节有严格要求,或需要在团队间共享和协作的场景。
建议开发者从‘standard’模式开始使用,在个人开发阶段快速验证。在代码审查或CI流水线中切换到‘strict’模式。对于需要严格遵循团队设计规范(如字体、颜色、间距)的正式文档,则使用‘production’模式并配合预设文件。注意,它不提供实时预览功能,预览仍需依赖draw.io桌面版或VS Code扩展。
核心特点
与官方draw.io MCP服务器(输出图片/JSON)和Mermaid.js(文本DSL)不同,draw-mcp专注于生成原生、像素级精确的draw.io XML,并通过多达31条规则(涵盖结构、样式、布局、安全等10个模块)进行严格的质量验证,确保图表可直接用于生产环境。
注意事项
不适合需要实时可视化预览、自动布局或转换Mermaid/CSV格式的场景。
常见问题
draw-mcp和官方的draw.io MCP服务器有什么区别?
官方服务器用于快速预览和格式转换(如图片、Mermaid),而draw-mcp专注于生成高质量、可直接编辑和用于生产的原生draw.io XML文件,并提供严格的代码级验证。
如何验证一个已有的.drawio文件?
安装CLI工具后,使用命令 `draw-mcp-validate your-diagram.drawio` 即可,支持指定验证模式(如--mode strict)和输出格式(如--format json)。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/draw-mcp/raw/index.md 读取 draw-mcp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/draw-mcp/raw/index.md(查看排版版本)