什么是diagram-generator
diagram-generator 是一个面向开发与文档场景的制图工具，重点不在内置画布，而在于把“描述图表”这件事结构化。它支持 drawio、mermaid、excalidraw 三种常见格式，既能从自然语言需求生成新图，也能读取并修改已有的图表文件。覆盖的类型比较全，从流程图、时序图、类图、ER 图、思维导图，到架构图、网络拓扑图，都在它的适用范围内。
这个工具的工作方式也比较明确：先把用户需求整理成结构化 JSON，再把真正的文件生成交给独立的 mcp-diagram-generator MCP server 处理。这样做的直接好处，是把图表生成从大模型对话过程里拆出来，减少 token 消耗，同时让输出更稳定、更一致。对需要反复调整图表、持续迭代文档的人来说，这种方式比纯文本拼接更容易维护，也更适合纳入工程化流程。
从格式定位看，它并不是简单地“一次生成三种文件”。不同格式有明确分工：mermaid 更适合快速生成、便于写进文档和做版本管理；drawio 更适合复杂布局、精细样式和后续人工编辑；excalidraw 则偏向手绘风格和更自由的草图表达。工具本身还带有默认配置与输出目录管理，首次使用时会自动创建配置文件和目录，默认把文件输出到项目目录下的 diagrams/{format}/，也支持按格式自定义路径。
核心功能特点
- 同时支持 drawio、mermaid、excalidraw，可在同一套流程里处理多种图表格式
- 既能根据自然语言新建图表，也能读取并修改已有的 drawio、mermaid、excalidraw 文件
- 通过独立的 mcp-diagram-generator MCP server 负责生成与保存文件，降低 token 消耗并提升输出一致性
- 内置配置管理与默认目录策略，首次使用可自动初始化，支持自定义输出路径并自动创建目录
- 覆盖流程图、时序图、类图、ER 图、思维导图、架构图、网络拓扑图等常见类型，并对不同格式给出明确适配方向
适用场景
如果团队平时要频繁编写技术方案、系统设计说明或项目文档，diagram-generator 比较适合放在“文字到图”的中间层使用。比如写接口时序说明、整理业务流程、补数据库 ER 图，往往只需要先把结构和关系说清楚，就可以生成一版可用图表。对于偏文档协作的团队，mermaid 的价值尤其明显：生成快、文本化程度高，适合直接进入仓库，与说明文档一起维护。
在架构设计和系统梳理场景里，它更适合承担“先快速出图，再细化调整”的工作。高层架构、组件关系、服务边界这类内容，可以先用 mermaid 快速得到概览；当图开始变复杂，需要更多布局控制、容器层级或样式调整时，再转向 drawio 会更稳妥。证据里也明确提到，drawio 更适合复杂系统图和需要精细编辑的图表，这意味着它不仅适合生成初稿，也适合后续交给人工继续修改。
另一个更有针对性的使用场景是网络拓扑。该工具对这类图给出了较具体的结构要求，例如 environment、datacenter、zone、device 的四层层级，以及不同层级和设备类型的样式约定，因此更适合需要规范化表达网络环境、机房分区、区域连接和设备关系的团队。相比临时手工绘制，这种结构化方式更容易复用、修改和批量生成。再加上默认输出目录、自动创建路径和文件命名能力，它也适合接入持续产出文档的项目目录中，作为长期维护的一部分。