核心功能
Diagram Generator 是一款基于MCP(Model Context Protocol)协议的架构图生成工具,能够将结构化JSON描述转换为可视化图表。该skill支持三种主流图表格式:
- Draw.io:专业架构图,支持复杂网络拓扑与容器嵌套
- Mermaid:代码驱动型流程图、时序图、类图、ER图
- Excalidraw:手绘风格白板草图,适合快速原型与协作
显著优点
1. 结构化驱动:通过JSON协议精确控制元素位置、样式与层级关系,避免手动拖拽的低效
2. 多格式输出:一套数据可适配三种渲染引擎,满足不同场景需求(技术文档/演示文稿/协作白板)
3. 智能布局:支持坐标精确定位(相对父容器)或自动网格布局(设置坐标为0)
4. 网络拓扑专用:内置4级嵌套模型(Environment→Datacenter→Zone→Device)及设备颜色规范,适合云基础设施可视化
5. 配置管理:通过init_config()预设输出路径,简化重复调用
局限性与风险
- 学习成本:需掌握JSON Schema与坐标系统(特别是相对坐标规则),新手易因父容器基准错误导致布局混乱
- 外部依赖:依赖
mcp-diagram-generatornpm包或本地Node环境,网络/路径配置失败会阻断工作流 - 错误排查:Schema校验错误、目录不存在、扩展名错误等常见问题需查阅
setup-and-troubleshooting.md文档 - 非实时编辑:生成后需在外部工具(Draw.io Desktop/Mermaid Live Editor/Excalidraw)二次调整,无法所见即所得
适用人群
- 架构师/DevOps:绘制云基础设施、微服务拓扑
- 技术写作者:在文档中嵌入标准化Mermaid图表
- 产品经理:快速生成Excalidraw风格原型图
安全提示
来源为社区MCP服务器(NPM包mcp-diagram-generator),属于T2级可信度——代码开源可审计但无企业背书。执行环境涉及Node.js进程调用,建议隔离配置、审查输入JSON防止路径遍历攻击。