diagram-generator

📊 JSON 一键生成专业架构图

开发榜 #9

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

收藏
78.2k
安装
28.9k
版本
1.1.4
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能评估

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 内容

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