技能简介
该技能通过调用mcp-diagram-generator MCP服务器,将自然语言描述转换为结构化JSON并生成多种格式的图表文件,支持drawio、Mermaid和Excalidraw三种主流格式。
业务背景
业务人员无需掌握专业绘图工具,通过自然语言描述即可快速生成流程图、架构图、时序图等专业图表。支持drawio、Mermaid、Excalidraw三种主流格式,满足不同场景的可视化需求——技术文档用Mermaid、手绘风格汇报用Excalidraw、复杂精细调整用drawio,大幅提升沟通效率和文档质量。
落地案例:产品经理需要向开发团队讲解新功能的数据流转逻辑,只需输入"用户下单后,订单服务调用库存校验,通过后生成支付单并通知物流系统,异常时触发退款流程",系统自动生成时序图。若后续需调整节点顺序或补充分支判断,可直接修改原文件重新生成,无需从头绘制。生成的.drawio文件可导入ProcessOn继续精修,.mmd代码可直接嵌入技术文档。
能做什么
- 根据文字描述创建新图表(流程图、时序图、类图、ER图、思维导图、架构图、网络拓扑)
- 读取并修改现有的.drawio、.mmd或Excalidraw文件
- 自动管理输出目录和文件命名
- 选择最适合场景的图表格式
使用说明
前置条件:需先配置MCP服务器,验证工具mcp__mcp-diagram-generator__get_config、mcp__mcp-diagram-generator__generate_diagram、mcp__mcp-diagram-generator__init_config可用。
安装步骤(二选一):
方式一:npx自动下载(推荐)
在Claude Code配置文件(全局~/.claude.json或项目.claude.json)中添加:
{"mcpServers":{"mcp-diagram-generator":{"command":"npx","args":["-y","mcp-diagram-generator"]}}}
保存后重启Claude Code,首次使用时自动下载。
方式二:本地开发模式
若本地开发MCP服务器,配置为:
{"mcpServers":{"mcp-diagram-generator":{"command":"node","args":["/absolute/path/to/mcp-diagram-generator/dist/index.js"]}}}
首次使用:MCP服务器会自动创建默认配置文件.diagram-config.json和输出目录diagrams/{format}/。
基本用法:直接描述需求如”创建一个网络拓扑图”,技能自动生成JSON规格并调用generate_diagram,文件保存至默认路径。
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|---|
| 输入 | 自然语言描述(图表类型、节点关系、风格);现有文件路径(修改场景);自定义输出路径(可选) |
| 输出 | drawio(.drawio)、Mermaid(.mmd)或Excalidraw(.excalidraw)格式文件,含完整路径 |
| 适用人群 | 开发人员、技术写作者、运维工程师、产品经理 |
| 不包含 | 图形界面编辑、图片格式导出、实时协作、渲染预览 |
风险提示
- 必须先完成MCP服务器配置,否则提示”Tool not found”
- 配置变更后需重启Claude Code才能生效
- 复杂图表建议选用drawio格式以获得更精细的控制
- 网络拓扑等嵌套结构需正确设置level层级字段
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/matthewyin/diagram-generator/SKILL.md
来源类型:GitHub仓库
