diagram-generator

⚠️ 多格式图表生成,自然语言一键出图

纯文档型图表生成工具,支持 draw.io/Mermaid/Excalidraw 三种格式,通过 MCP 服务器委派实现零代码架构,顶级安全 S+ 评级

收藏
90.8k
安装
21.7k
版本
1.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Diagram Generator 是一款专业的多格式图表生成与管理工具,支持通过自然语言描述创建和编辑 draw.ioMermaidExcalidraw 三种主流格式的图表。该 Skill 采用独特的零代码架构设计——本身仅为纯文档型接口规范(99.4% Markdown),所有实际生成功能均委托给外部 MCP 服务器 mcp-diagram-generator 执行,从而在功能完整性与安全性之间取得卓越平衡。

支持的图表类型

| 类型 | 推荐格式 | 适用场景 |
|------|---------|---------|
| 流程图 (Flowchart) | Mermaid | 快速流程可视化、文档嵌入 |
| 时序图 (Sequence) | Mermaid | 系统交互、API 调用流程 |
| 类图 (Class Diagram) | Mermaid/draw.io | UML 设计、代码结构 |
| ER 图 | Mermaid | 数据库架构设计 |
| 思维导图 (Mindmap) | Mermaid/Excalidraw | 头脑风暴、知识梳理 |
| 架构图 | draw.io | 复杂系统拓扑 |
| **网络拓扑图** | **draw.io** | 四层嵌套结构(环境→机房→区域→设备) |

显著优点

1. 顶级安全保障:安全评级 S+(满分 100),通过全部六维检测(静态分析、动态行为、依赖审计、网络流量、隐私合规、威胁情报),零依赖、零网络调用、无可执行代码。
2. 极简使用体验:支持自然语言输入,自动生成结构化 JSON 描述,MCP 服务器负责文件生成与目录管理,用户无需关注底层格式细节。

3. 智能路径管理:默认输出至 diagrams/{format}/,支持自定义配置一次、多次复用,自动创建目录、自动生成带日期戳的文件名。

4. 多格式灵活切换:内置格式选择指南,根据场景智能推荐最优格式——Mermaid 适合文档与版本控制,draw.io 适合复杂精细调整,Excalidraw 适合手绘风格原型。

5. 网络拓扑专业化:针对企业级网络架构设计,内置四层嵌套规范与配色标准(紫-绿-黄-设备色),大幅降低复杂拓扑的绘制门槛。

潜在局限

  • 外部依赖约束:核心功能依赖 mcp-diagram-generator MCP 服务器,需用户手动配置安装(支持 npx 自动下载或本地开发模式),服务器不可用则功能完全失效。
  • 来源可信度 T3:维护者为个人开发者(AlkaidY),非知名组织背书,尽管本次检测无风险,但长期维护稳定性需观察。
  • 格式能力边界:虽然声明支持读取和修改现有文件,但实际修改流程需"读取→解析→重新生成",对大型复杂图表的增量编辑效率有限。
  • 无实时预览:生成结果为文件落地,需配合外部工具(如 draw.io 桌面版、Markdown 渲染器)查看效果,无法即时可视化反馈。

适合人群

  • 技术文档工程师:需要在 Markdown 文档中嵌入可版本控制的 Mermaid 图表
  • 系统架构师:快速绘制网络拓扑、系统架构图并导出可手动精调的 draw.io 文件
  • 产品经理/设计师:使用 Excalidraw 格式输出手绘风格原型图
  • 注重安全的团队:对第三方 Skill 有严格安全审计要求,需要零代码攻击面的工具

常规风险

| 风险类别 | 等级 | 说明 |
|---------|------|------|
| 代码执行风险 | **无** | 纯文档型,无可执行代码 |
| 供应链攻击 | **极低** | 零运行时依赖,但需关注 MCP 服务器本身安全 |
| 数据泄露 | **无** | 无数据收集、无网络上传 |
| 服务中断 | 低 | 依赖 MCP 服务器可用性,建议本地部署备份 |

建议措施:在生产环境部署前,独立审计 mcp-diagram-generator MCP 服务器;对于关键图表,保留手动备份副本。

安全解读

核心用法

Diagram Generator 是一款基于 MCP 架构的多格式图表生成工具,支持 drawio(复杂图表与网络拓扑)、Mermaid(代码友好型快速生成)、Excalidraw(手绘风格)三种主流格式。用户通过自然语言描述需求,Skill 将其转换为结构化 JSON 后调用 mcp-diagram-generator 服务器完成文件生成,实现低 Token 消耗和一致输出。

主要流程
1. 提取用户意图(图表类型、内容、风格)

2. 按场景选择格式(参考内置决策矩阵)

3. 生成符合 JSON Schema 的结构化描述

4. 调用 MCP 服务器自动生成文件并保存

特色功能:支持网络拓扑四层嵌套(Environment→Datacenter→Zone→Device),自动目录创建,默认路径管理,以及现有文件的读取与修改。

显著优点

  • 架构解耦:核心逻辑外包给 MCP 服务器,本体为纯 Markdown 文档,无可执行代码,降低攻击面
  • 低 Token 设计:通过服务器端处理减少 LLM 调用开销
  • 多格式覆盖:一套抽象 JSON 适配三种格式,满足不同场景需求
  • 零配置启动:自动初始化目录结构和默认配置,开箱即用
  • 格式智能推荐:内置决策指南,帮助用户快速选择合适格式

潜在缺点与局限性

  • 强外部依赖:功能完全依赖 mcp-diagram-generator MCP 服务器,若服务器不可用或存在漏洞,Skill 失效且可能引入风险
  • T3 级来源:由个人开发者维护(AlkaidY),无知名组织背书,长期维护稳定性存疑
  • 无离线能力:必须联网通过 npx 下载或配置本地 MCP 服务器,纯离线环境无法使用
  • 调试门槛:MCP 服务器配置错误时,需用户自行排查 JSON 配置、路径权限等问题
  • 功能黑盒:图表渲染细节完全由外部服务器控制,用户无法微调生成逻辑

适合人群

  • 需要快速生成架构图、流程图、ER 图、网络拓扑的技术人员
  • 偏好代码/文档驱动工作流的开发者(Mermaid 场景)
  • 需要手绘风格演示材料的产设团队(Excalidraw 场景)
  • 已配置 Claude Code MCP 生态的进阶用户

常规风险

  • 供应链风险:MCP 服务器通过 npx 动态拉取,存在依赖劫持或恶意版本植入可能
  • 配置误用风险:用户可能配置不安全的本地路径或启用未经验证的 MCP 服务器实例
  • 误报干扰:安全扫描曾将文档中的联系信息误判为 CI 环境检测代码(已确认为误报)

diagram-generator 内容

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