Excalidraw Architect MCP：让智能体画可编辑的架构图
模型只描述组件和连线，布局引擎负责算坐标，输出可继续编辑的 .excalidraw 文件。25 种图表，离线运行，不需要 API key。
项目与安装文档
查看项目https://github.com/BV-Venky/excalidraw-architect-mcp
让模型直接写 Excalidraw JSON 画架构图，结果通常是框叠在一起、箭头缠成一团，最后还得手动拖。Mermaid 生成快，但画出来改不动。Excalidraw Architect MCP 把“画什么”和“画在哪”拆开：模型只描述组件、关系和层级，服务器按图表类型选布局算法，自动排版、上色，写出一个可以继续在 Excalidraw 里编辑的文件。截至 2026-10-06 约 160 star。
能做什么
- 25 种图表：
create_diagram支持架构图、流程图、时序图、状态机、ER 图、泳道图、甘特图、象限图，以及手绘风格的柱状、折线和散点图。 - 改图不重画：
get_diagram_info读取现有图的状态，modify_diagram增删节点和连线后重新排版，比如“在数据库前面加一层 Redis 缓存”。 - 格式转换与导出：
mermaid_to_excalidraw把 Mermaid 流程图转成可编辑的图，export_diagram导出 SVG（无额外依赖）或 PNG。 - 技术感知样式：内置 50 多种技术组件样式，写“Kafka”就得到消息流样式的节点。
- 可选知识图谱：
kg_*系列工具把系统架构存成受版本控制的文件，可查依赖路径、做影响分析、检查环依赖和单点故障。
适合谁
- 写设计文档、RFC 或新人上手文档，需要多张风格统一的图的工程师。
- 想让编程智能体读完代码顺手画出服务关系图的团队。
接入方式
需要 Python。安装后在 Claude Code 里注册：
pip install excalidraw-architect-mcp
claude mcp add-json excalidraw-architect '{"type":"stdio","command":"excalidraw-architect-mcp"}' --scope user
要导出 PNG 时改装 pip install excalidraw-architect-mcp[png]；装了 uv 也可以不安装，直接 uvx excalidraw-architect-mcp。
编辑点评
这是一个小而扎实的项目。它的关键设计是不让模型碰坐标：布局交给 Sugiyama 等算法，模型只负责说清结构，这正好绕开了大模型画图最容易出错的地方。导出部分把 roughjs 的笔触生成器移植到了 Python，导出的 SVG 保留手绘质感，不需要浏览器或 Node.js。它全程离线运行，不调用外部服务。要注意的是项目由个人维护，最近一次推送在 2026 年 8 月；知识图谱的漂移检测目前只识别 Python 导入。许可证为 MIT。