diagram-generator

📊 JSON 一键生成专业架构图

开发榜 #10

通过 MCP 服务器将结构化 JSON 转换为 Draw.io、Mermaid、Excalidraw 专业图表,支持网络拓扑自动布局与多层级嵌套架构可视化

收藏
78.2k
安装
28.9k
版本
1.1.4
CLS 安全性认证2026-07-14
点击查看完整报告 >

使用说明

核心功能评估

Diagram Generator 是一款基于 MCP 协议的架构图生成工具,核心能力是将结构化 JSON 规范转换为三种主流可视化格式:Draw.io(复杂架构图)、Mermaid(流程图/时序图/类图/ER 图)、Excalidraw(手绘风格白板)。该工具特别适合需要程序化生成技术图表的场景,如 CI/CD 流水线自动生成文档、架构评审材料批量产出等。

显著优点

1. 格式覆盖全面:单一 JSON 输入可输出三种差异化格式,Draw.io 适合精确控制的专业架构图,Mermaid 适合 Markdown 嵌入,Excalidraw 适合快速头脑风暴
2. 自动布局能力:支持网格自动布局算法,对网络拓扑等复杂场景提供 4 级嵌套层级(Environment→Datacenter→Zone→Device)的数学化坐标计算

3. MCP 原生集成:作为 MCP 服务器运行,可与 Claude、Cursor 等 AI 编辑器深度集成,实现"自然语言描述→JSON→图表"的完整工作流

4. 配置管理友好:通过 init_config() 预设输出路径,避免重复参数传递

潜在局限与风险

  • 学习曲线陡峭:需掌握特定的 JSON Schema 协议,网络拓扑等高级功能需阅读 4 份参考文档才能正确使用
  • 坐标系统复杂:容器内子元素坐标需相对于父容器左上角,容易因理解偏差导致布局错乱
  • Node.js 依赖:需本地 Node 环境或依赖 npx 远程拉取,离线场景受限
  • 维护状态存疑:文档提及"占位简介",实际安全扫描未执行,长期维护稳定性需观察

适合人群

  • 技术文档工程师(需批量生成架构图)
  • DevOps/SRE 团队(自动化基础设施文档)
  • 软件架构师(快速迭代系统拓扑图)
  • 不适合:偶尔画张简单流程图的非技术用户

常规风险提示

  • 输出目录需提前创建,否则会触发 Directory Not Found 错误
  • 文件扩展名必须与目标格式严格匹配(.drawio/.mmd/.excalidraw)
  • 复杂嵌套场景建议先阅读 topology-and-layout-spec.md 中的数学公式

综合评价

工具定位精准,是"AI+图表生成"技术栈中的基础设施级组件。对于已采用 MCP 生态的团队,可显著提升技术图表的生产效率;但对于轻量用户,直接使用 Excalidraw/Mermaid 在线编辑器可能更便捷。

安全解读

核心功能与用法

Diagram Generator 是一款专为开发者设计的架构可视化工具,通过 MCP 协议调用 mcp-diagram-generator 服务器,将结构化 JSON 数据转换为三种主流图表格式:

  • Draw.io(.drawio):适合复杂系统架构图,支持嵌套容器与精确坐标布局
  • Mermaid(.mmd/.md):流程图、时序图、类图、ER图,原生支持 Markdown 渲染
  • Excalidraw(.excalidraw):手绘风格白板,适合快速原型与团队协作

使用流程简洁:选择格式 → 定义布局(手动坐标或自动网格)→ 调用 generate_diagram 生成文件。建议通过 init_config() 预配置输出路径,避免重复指定。

显著优点

1. 多格式统一接口:单一 JSON 协议驱动三种截然不同的渲染引擎,降低学习成本
2. 灵活布局策略:既支持精确几何坐标(适合网络拓扑),也支持零配置自动网格(适合快速草图)

3. 网络拓扑专项优化:内置 4 级嵌套层级(Environment → Datacenter → Zone → Device)与设备颜色定义,专为云架构设计

4. 容器感知绑定:Draw.io 模式下,边线可绑定至父容器,确保拖拽时连接关系同步移动

潜在局限

  • 外部依赖风险:核心功能依赖外部 MCP 服务器 mcp-diagram-generator,需独立评估其安全性与稳定性
  • 格式能力边界:三种格式的功能子集不尽相同,复杂布局可能在某些格式下降级渲染
  • 坐标系统复杂性:子元素坐标需相对于直接父容器计算,嵌套层级深时易出错
  • 无实时预览:生成流程为批处理模式,需导出后在外部工具查看效果

适合人群

  • 系统架构师:绘制多云环境网络拓扑、微服务依赖关系
  • 技术文档工程师:在 Markdown 中嵌入可版本控制的 Mermaid 图表
  • 产品经理与设计师:快速输出 Excalidraw 风格原型图
  • DevOps 工程师:自动化生成基础设施即代码(IaC)配套架构文档

常规风险

  • MCP 服务器版本更新可能引入破坏性变更,建议锁定版本号
  • 本地路径配置方式存在文件系统权限风险,优先使用 NPM 远程包
  • 大规模图表(数百节点)可能出现性能瓶颈,建议分页或分层设计

diagram-generator 内容

references文件夹
手动下载zip · 12.4 kB
format-selection-guide.mdtext/markdown
请选择文件