diagram-generator

diagram-generator

diagram-generator

收藏
90.6k
安装
21.7k
版本
1.1.1
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

安全解读

核心用法

Diagram Generator 是一款基于 MCP 架构的图表生成工具,通过自然语言描述即可创建专业级图表。用户只需提供简单的文本描述(如"创建一个用户登录流程图"),Skill 会自动解析需求、生成结构化 JSON 描述,并调用 mcp-diagram-generator 服务器完成图表渲染和文件保存。

支持的图表类型:流程图、时序图、类图、ER 图、思维导图、架构图、网络拓扑图(4 层嵌套结构)。支持的输出格式:draw.io(复杂布局、网络拓扑首选)、Mermaid(快速生成、代码友好)、Excalidraw(手绘风格、创意草图)。

工作流程:1)理解用户自然语言需求;2)选择最佳格式;3)生成符合 JSON Schema 的结构化描述;4)调用 MCP 服务器的 generate_diagram 工具;5)自动保存到 diagrams/{format}/ 目录。支持自定义路径、文件名,以及读取和修改现有图表文件。

显著优点

极致安全性:纯 Markdown 文档型 Skill,无任何可执行代码(无 JS/Python/Shell),从根本上消除代码注入、供应链攻击、依赖漏洞等风险。所有功能委托给外部 MCP 服务器处理,遵循最小权限原则。

低门槛高效率:无需学习复杂语法,自然语言即可生成专业图表。MCP 服务器自动处理目录创建、文件命名、格式转换等繁琐工作,用户只需关注内容描述。

格式灵活:三种主流格式全覆盖,可根据场景灵活选择——Mermaid 适合文档嵌入和版本控制,draw.io 适合复杂网络拓扑和精细排版,Excalidraw 适合创意表达和演示文稿。

网络拓扑专长:针对企业级网络架构提供 4 层嵌套支持(Environment → Datacenter → Zone → Device),内置行业标准配色规范,是 IT 架构师的实用工具。

潜在缺点与局限性

强外部依赖:功能完全依赖 mcp-diagram-generator MCP 服务器,该服务器未安装或配置错误时 Skill 无法工作。用户需自行完成 MCP 服务器配置(虽只需在 Claude Code 配置文件中添加几行 JSON)。

间接安全风险:虽然 Skill 本身安全,但最终安全性受 MCP 服务器实现影响。若 MCP 服务器存在漏洞、恶意代码或越权行为,可能间接影响用户。建议用户同时审查 MCP 服务器来源(推荐 npm 官方仓库)。

无离线能力:必须联网下载 MCP 服务器(通过 npx),无法完全离线使用。

调试复杂度:图表生成失败时,问题可能出在 JSON Schema 验证、MCP 服务器或文件权限等多个环节,排查需要一定技术能力。

适合人群

  • 软件开发人员:快速生成架构图、流程图、时序图用于技术文档
  • 系统/网络工程师:绘制网络拓扑图、数据中心架构图
  • 产品经理/设计师:制作思维导图、原型草图、演示图表
  • 技术写作者:为 Markdown 文档、Wiki 生成 Mermaid 图表
  • 企业 IT 团队:标准化图表输出,统一团队协作规范

常规风险

  • MCP 服务器配置风险:配置不当可能导致工具调用失败,需严格按照文档配置
  • 版本兼容性:MCP 服务器更新可能引入 breaking changes,建议关注版本变更
  • 输出文件验证:建议在使用生成的图表文件前快速验证内容,确保 MCP 服务器行为正常
  • 路径权限问题:虽支持自动目录创建,但在受限环境(如 CI/CD)中可能遇到写权限问题

diagram-generator 内容

暂无文件树

手动下载zip · 13.2 kB
contentapplication/octet-stream
请选择文件