核心用法
Diagram Generator 是一款基于 MCP（Model Context Protocol）的图表自动化生成技能，通过自然语言描述转化为结构化 JSON 规范，再由 mcp-diagram-generator 服务渲染为可视化图表。支持三大主流格式：Draw.io（.drawio）、Mermaid（.mmd）及 Excalidraw（.excalidraw），覆盖架构图、流程图、网络拓扑、时序图、类图、ER图、泳道图、思维导图等全场景。
标准工作流：
1. 意图收集：确认图表类型、输出格式、布局方向、使用场景
2. Playbook 路由：根据意图匹配专业指南（网络拓扑/架构/流程图/UML等）
3. 格式决策：智能推荐默认格式（如网络拓扑默认 Draw.io、流程图默认 Mermaid）
4. JSON 构建：遵循 Schema 规范，确保 ID 唯一、边独立顶层、容器层级合法
5. 质量门控：验证格式匹配、几何显式、层级正确
6. MCP 调用：生成文件并返回路径
显著优点
- 自然语言驱动：无需掌握复杂图表语法，描述意图即可生成
- 全格式覆盖：单一接口支持 Draw.io（复杂网络）、Mermaid（文档嵌入）、Excalidraw（白板协作）
- 结构化规范：强制 JSON Schema 验证，杜绝无效输出
- 场景智能：自动根据 Word/PPT/代码仓库/协作白板等场景优化布局
- 可扩展架构：MCP 协议支持本地/远程服务灵活部署
潜在局限
- 依赖 MCP 服务：需预先配置 Node.js 环境并启动服务，首次使用有配置成本
- 复杂布局限制：自动几何计算可能不如手动微调精细，极端复杂场景需显式坐标
- 格式专属特性：Draw.io 的高级样式、Excalidraw 的手绘绑定等特殊功能需按 Playbook 精细配置
- 无实时预览：生成后需外部工具打开查看，无内置渲染反馈
适合人群
| 角色 | 典型场景 |
|------|---------|
| 系统架构师 | 快速产出分层架构图、网络拓扑 |
| 产品经理 | 业务流程图、泳道图、决策树 |
| 开发工程师 | 类图、时序图、ER 图（直接嵌入 Markdown） |
| 运维工程师 | 数据中心、云网络拓扑可视化 |
| 技术写作者 | 文档配图自动化生成 |
常规风险
- 服务未启动：MCP 工具调用失败需检查配置并重启环境
- Schema 验证失败：常见原因为 ID 重复、边嵌套子元素、源目标不存在
- 路径权限问题：默认输出至
diagrams/{format}/，需确保写入权限 - 格式混淆：Draw.io/Mermaid/Excalidraw 扩展名需严格区分，不可混用