diagram-generator

📊 AI驱动·多格式架构图一键生成

developer-tools榜 #22

AI驱动的多格式图表生成器,支持drawio、mermaid、excalidraw,通过独立MCP服务器减少token消耗,适合技术架构可视化

收藏
46.1k
安装
21.9k
版本
1.0.1
CLS 安全性认证2026-05-09
点击查看完整报告 >

使用说明

Diagram Generator 综合评估

核心用法

Diagram Generator是一款专业的多格式图表生成与编辑工具,支持drawio、mermaid、excalidraw三种主流格式。用户通过自然语言描述需求,系统自动生成结构化JSON描述并委托给独立的MCP服务器(mcp-diagram-generator)完成文件生成,有效减少大模型的token消耗并保证输出一致性。

工作流程:理解用户需求 → 选择最佳格式 → 生成JSON Schema → 调用MCP服务器 → 自动保存至指定目录。

支持的图表类型:流程图、时序图、类图、ER图、思维导图、架构图、网络拓扑图(4层嵌套结构)等。

显著优点

1. Token优化设计:通过独立MCP server执行实际生成任务,避免大模型直接处理复杂图形数据,显著降低API调用成本
2. 多格式灵活选择:mermaid适合快速代码化输出,drawio适合复杂精细编辑,excalidraw适合手绘风格草图

3. 自动配置管理:v1.0.1+版本支持自动创建目录、默认路径管理(diagrams/{format}/),降低使用门槛

4. 专业网络拓扑支持:唯一支持4层嵌套容器(environment→datacenter→zone→device)的工具,满足企业级网络架构需求

5. npm一键部署:通过npx自动下载,无需手动安装

潜在缺点与局限性

1. 外部依赖强耦合:必须正确配置mcp-diagram-generator MCP server才能使用,配置错误会导致完全不可用
2. JSON Schema学习成本:复杂图表(如网络拓扑)需要理解嵌套结构和层级规范,对新手有一定门槛

3. 格式转换限制:三种格式之间无法直接互转,选择后难以无损迁移

4. 本地路径依赖:自动生成路径基于项目目录,跨项目复用需要重新配置

适合人群

  • 架构师/SRE:绘制系统架构图、网络拓扑图
  • 技术文档作者:为文档快速生成mermaid流程图
  • 产品经理:创建流程图、思维导图用于需求沟通
  • 开发团队:版本控制友好的图表生成(mermaid纯文本特性)

常规风险

  • 配置失效风险:MCP server配置错误将导致工具完全不可用
  • 路径权限问题:自动创建目录依赖文件系统写入权限
  • 嵌套结构错误:网络拓扑的4层层级关系配置错误会导致渲染异常
  • 版本兼容性:需确认mcp-diagram-generator server版本与skill版本匹配

安全解读

核心用法

Diagram Generator 是一款通过 MCP Server 架构实现的专业图表生成工具。用户以自然语言描述需求,Skill 将其转换为结构化 JSON 描述,再由独立的 mcp-diagram-generator MCP Server 完成实际文件生成。这种代理模式从根本上隔离了代码执行风险。

工作流程:提取图表类型(流程图/时序图/类图/ER图/思维导图/架构图/网络拓扑图)→ 选定输出格式 → 生成符合 JSON Schema 的结构描述 → 调用 MCP Server 生成文件。支持智能目录创建、自动命名和路径自定义。

三种输出格式

  • Mermaid:代码友好、适合版本控制,快速生成文档嵌入型图表
  • Drawio:复杂布局首选,支持嵌套容器,网络拓扑四层结构必需
  • Excalidraw:手绘风格,适合创意草图和非正式场景

显著优点

1. 顶级安全架构:纯 Markdown 文档型 Skill,无可执行代码,无危险函数调用,静态分析满分
2. Token 消耗优化:复杂图形渲染外包给 MCP Server,避免大段 XML/SVG 污染对话上下文

3. 格式智能选择:内置 format-selection-guide,根据场景自动推荐最优格式

4. 网络拓扑专长:唯一支持四层嵌套(Environment→Datacenter→Zone→Device)的自动化工具

5. 零配置开箱即用:自动创建目录结构,智能文件名生成,降低使用门槛

潜在局限

1. T3 来源可信度:维护者为个人开发者(matthewyin),缺乏知名组织背书
2. 外部依赖强耦合:核心功能完全依赖 mcp-diagram-generator MCP Server,该 Server 通过 npx 动态加载

3. 版本漂移风险:默认配置使用最新版 MCP Server,可能引入未预期变更

4. 离线场景受限:首次使用需从 npm registry 下载 MCP Server,纯离线环境需预配置

5. 复杂样式受限:精细视觉定制需手动编辑生成的 drawio 文件,自动化程度有限

适合人群

  • 技术文档作者:快速生成架构图、流程图嵌入 README 或 Wiki
  • DevOps/网络工程师:标准化绘制网络拓扑,统一团队图表规范
  • 全栈开发者:在编码对话中即时可视化系统设计与数据流
  • 敏捷团队:需要快速迭代、频繁修改图表的协作场景

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 代码执行风险 | 极低 | 无可执行代码,纯文档结构 |
| 数据泄露风险 | 极低 | 无用户数据收集,无敏感信息硬编码 |
| 供应链攻击 | 低 | 依赖 npm 官方 registry,建议锁定 MCP Server 版本 |
| MCP Server 可用性 | 中 | 需正确配置 MCP Server,配置错误会导致功能完全不可用 |

diagram-generator 内容

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