画图是梳理架构、解释流程最直观的方式，但多数智能体生成的只是一张一次性图片，改起来费劲，也无法和真正的白板工具联动，画完即弃、难以迭代。

mcp_excalidraw 通过 Model Context Protocol 把 Excalidraw 变成一个可编程的画布：智能体能用 26 个工具创建、编辑图形，也能作为 Claude Code 的 skill 或普通 REST 接口来调用，让“画图”成为工作流里可被精确修改的一步。

在智能体工作流里，图形不再是一次性的图片，而是可被精确增删改的结构化对象，这让架构图、流程图能够随代码一同演进，而不是画完就封存。

项目基本信息

信息项详情
项目名称mcp_excalidraw
GitHub地址https://github.com/yctimlin/mcp_excalidraw
项目描述MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.
作者yctimlin
开源协议MIT License
开源状态公开
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-10-30

一、项目介绍

把图形纳入智能体工作流，真正的价值不在于“画一张图”，而在于图形变成了可被版本控制、可被程序修改的对象。传统截图式出图一旦画错就要重来，而 Excalidraw 的程序化画布允许智能体只改某一根连线、某一个节点，和代码修改一样精准。

三种接入方式的设计也体现了务实：skill 给编码智能体最低摩擦的入口，MCP Server 照顾通用客户端，REST API 则面向要把绘图能力嵌进自有系统的团队。这种分层让它既适合个人，也适合平台集成。

需要提醒的是，图形质量仍取决于智能体对业务的理解。它能把“画一个登录流程图”变成可执行的操作，但流程本身是否合理，还是要人来把关。工具解放的是手脚，不是判断。

落地建议：先用 skill 方式在 Claude Code 里尝试让智能体画架构草图，确认它理解你的画图约定后，再考虑接入 MCP 服务做更复杂的白板协作。

与直接生成 SVG 或图片的方案相比，它的优势是可编辑、可迭代：图形是 Excalidraw 的原生对象，团队能继续在白板上协作，而不是得到一张不可改的死图。

边界在于，复杂版图（成百上千元素）对智能体的上下文是负担，绘制与维护成本会上升；此外它依赖 Excalidraw 生态，若你的团队用其他白板工具，需评估迁移成本。

随着智能体越来越多地参与设计环节，能把“画”变成“结构”的工具会成为基础设施。mcp_excalidraw 在 MCP 这一标准协议上做画布，方向是对的。

二、核心优势

  • 三种接入方式：Agent Skill 加 CLI 推荐给 Claude Code、Codex、Cursor 等编码智能体；MCP Server 提供 26 个 stdio 工具，任意 MCP 客户端可用；REST API 则方便 LangChain 或自研框架直接调用。
  • 程序化画布：用代码创建、编辑、组合图形与连线，画错一步就能精确改一步，而不是重画整张图，迭代成本大幅下降。
  • 与官方 Excalidraw MCP 定位不同：本项目更强调在编码智能体工作流里的可组合性与本地可控，README 中提供了专门的对比说明。

三、适用场景

  • 让智能体在写代码前先画出模块关系图、时序图或系统架构草图，先对齐再动手。
  • 把文档里的流程自动转成可编辑的 Excalidraw 白板，方便团队继续在白板上协作。
  • 在 Agent 应用里把推理过程可视化出来，让黑盒决策变得肉眼可见。

四、安装教程

本项目支持跨平台运行（Windows / macOS / Linux）。基础安装命令如下：

注意：需要一个用于存放 skill 的目录；安装后通过 start 启动本地画布服务，再让客户端连接。

常见报错与处理：

  • 命令找不到（command not found）：多为未安装对应运行时（Node / Python / uv / Homebrew），请先确认环境就绪。
  • 网络超时或 403：可切换为国内镜像源，或检查代理设置后重试。
  • 权限错误（EACCES）：避免用 sudo 全局安装，建议使用版本管理器或用户级前缀。

五、使用示例

以下为真实可运行的使用方式（输入与预期输出）：

输入：
  npx -y mcp-excalidraw-server install-skill --dir <你的skills目录>
  npx -y mcp-excalidraw-server start

输出：skill 被写入指定目录，本地画布服务启动；之后在 Claude Code 等客户端里让智能体“画一个登录流程图”，它会调用工具在 Excalidraw 中逐元素创建图形并保存。

六、常见问题

问：它和官方 Excalidraw MCP 有什么区别？

答：官方 MCP 偏向通用接入，本项目额外提供 Claude Code skill 与更强调编码工作流可组合性的实现，README 中有专门对比章节可供参考。

问：一定要用 Excalidraw 账号吗？

答：不需要登录账号，画布服务在本地运行，图形数据保存在你自己的环境里，适合对数据留存有要求的场景。

七、总结

mcp_excalidraw 把画板变成智能体可编程的画布，三种接入方式覆盖了从编码智能体到自研框架的不同需求，让“画图”真正成为可迭代、可编辑的工作步骤，而不是一次性的装饰。