diagram-generator

核心功能

Diagram Generator 是一款基于MCP（Model Context Protocol）协议的架构图生成工具，能够将结构化JSON描述转换为可视化图表。该skill支持三种主流图表格式：

• Draw.io：专业架构图，支持复杂网络拓扑与容器嵌套
• Mermaid：代码驱动型流程图、时序图、类图、ER图
• Excalidraw：手绘风格白板草图，适合快速原型与协作

显著优点

1. 结构化驱动：通过JSON协议精确控制元素位置、样式与层级关系，避免手动拖拽的低效
2. 多格式输出：一套数据可适配三种渲染引擎，满足不同场景需求（技术文档/演示文稿/协作白板）
3. 智能布局：支持坐标精确定位（相对父容器）或自动网格布局（设置坐标为0）
4. 网络拓扑专用：内置4级嵌套模型（Environment→Datacenter→Zone→Device）及设备颜色规范，适合云基础设施可视化
5. 配置管理：通过init_config()预设输出路径，简化重复调用

局限性与风险

• 学习成本：需掌握JSON Schema与坐标系统（特别是相对坐标规则），新手易因父容器基准错误导致布局混乱
• 外部依赖：依赖mcp-diagram-generator npm包或本地Node环境，网络/路径配置失败会阻断工作流
• 错误排查：Schema校验错误、目录不存在、扩展名错误等常见问题需查阅setup-and-troubleshooting.md文档
• 非实时编辑：生成后需在外部工具（Draw.io Desktop/Mermaid Live Editor/Excalidraw）二次调整，无法所见即所得

适用人群

• 架构师/DevOps：绘制云基础设施、微服务拓扑
• 技术写作者：在文档中嵌入标准化Mermaid图表
• 产品经理：快速生成Excalidraw风格原型图

安全提示

来源为社区MCP服务器（NPM包mcp-diagram-generator），属于T2级可信度——代码开源可审计但无企业背书。执行环境涉及Node.js进程调用，建议隔离配置、审查输入JSON防止路径遍历攻击。

核心用法

Diagram Generator 是一款纯文档型 MCP Skill，专注于将 JSON 结构规范转换为专业图表。用户通过调用 mcp-diagram-generator MCP 服务器，可生成三种格式的可视化图表：

• Draw.io：适用于复杂架构图，支持网络拓扑的 4 层嵌套结构（Environment → Datacenter → Zone → Device）
• Mermaid：适合代码仓库文档，支持流程图、时序图、类图、ER 图等
• Excalidraw：用于手绘风格白板草图，便于快速原型沟通

工作流程分为三步：选择目标格式 → 定义布局（支持精确坐标或自动网格布局）→ 调用 generate_diagram 生成文件。Skill 内置完善的参考文档体系，包括格式选择矩阵、JSON Schema 规范、网络拓扑模板及故障排查指南，确保生成质量。

显著优点

• 安全隔离：纯 Markdown 文档，无可执行代码，无敏感信息泄露风险
• 灵活可控：支持精确坐标定位与自动网格布局两种模式
• 专业规范：提供网络拓扑的 4 层嵌套标准和设备颜色定义
• 生态友好：通过官方 NPM 渠道分发，来源可信（clawhub.ai 平台）
• 配置便捷：init_config() 初始化后无需重复指定输出路径

潜在局限

• 依赖外部 MCP 服务器：需额外安装 mcp-diagram-generator，对离线环境不友好
• 文件覆盖风险：MCP 服务器写入文件时可能覆盖现有图表，需审查自定义路径
• 学习成本：JSON 协议和网络拓扑规范需要一定学习曲线
• 无实时预览：生成后需用对应工具打开查看，无法即时调整

适合人群

• 系统架构师绘制网络拓扑和云架构图
• 技术写作者为文档生成 Mermaid 流程图
• 产品经理快速产出 Excalidraw 原型草图
• 需要标准化图表生成的 DevOps 团队

常规风险

• RISK-001：外部 MCP 服务器依赖，需确保从官方 NPM 源安装
• RISK-002：文件写入时可能覆盖现有文件，建议使用默认路径或确认覆盖

版本与合规

• 版本：1.1.5（MIT-0 许可证）
• 维护者：matthewyin
• 安全等级：S（95/100）
• 来源可信度：T2（可信组织/技能市场平台）
• 合规认证：GDPR/CCPA 通过