KechuAI

Excalidraw MCP：让 Claude 在对话里直接画出手绘风示意图

Excalidraw
MCP
AI Agent
图表
Claude
开源
2026/9/29
·

阅读时间: 大约 8 分钟

Excalidraw MCP：让 Claude 在对话里直接画出手绘风示意图

让 AI 画架构图，过去的默认答案是 Mermaid 或 PlantUML——Agent 生成一段 DSL，再渲染成图。但这类语法图风格刻板，而且改起来要重新生成代码。Excalidraw MCP 换了个思路：通过 MCP 协议让 Agent 直接画 Excalidraw 风格的手绘图，而且画出来是可在对话里交互、可全屏编辑的白板。本文基于其 GitHub 仓库分析它。

excalidraw/excalidraw-mcp README 截图：定位为"流式输出可缩放、可全屏编辑的手绘图 MCP 服务器"，兼容 Claude/ChatGPT/VS Code/Goose 等 MCP Apps 客户端，推荐直接接远程实例 https://mcp.excalidraw.com，也可本地 .mcpb 安装或源码自建

一、它是什么

仓库（现已归入 Excalidraw 官方组织 excalidraw/excalidraw-mcp）的定位是：“MCP server that streams hand-drawn Excalidraw diagrams with smooth viewport camera control and interactive fullscreen editing.”

关键在”MCP Apps”这个词。README 解释：文字回应有局限，有时用户需要与数据交互而不只是读它；MCP Apps 是 MCP 的官方扩展，允许服务器返回可交互的 HTML 界面（数据可视化、表单、仪表盘），直接渲染在聊天里。Excalidraw MCP 就是一个 MCP App——你对 Claude 说”画一只可爱的猫”或”画一张用户连接 API 服务器、服务器再连数据库的架构图”，它就在对话里流式画出一张可缩放、可全屏编辑的 Excalidraw 白板。

二、怎么用

它兼容任何支持 MCP Apps 的客户端：Claude、ChatGPT、VS Code、Goose 等。三种用法：

  1. 远程（官方推荐）：直接接 https://mcp.excalidraw.com；
  2. 本地扩展：从 Releases 下载 excalidraw-mcp-app.mcpb，双击装进 Claude Desktop；
  3. 源码自建：clone 仓库、pnpm install && pnpm run build，再在 Claude 配置里加 stdio 启动。

想自己部署也很简单——fork 仓库到 Vercel，导入即可，无需任何环境变量，你的服务器就在 https://你的项目.vercel.app/mcp。

三、为什么是手绘图，而不是 Mermaid

Koala 的点评点出了它的差异化：“相比让 AI 生成 Mermaid 或 PlantUML，手绘风格的适用空间更广泛。”

Mermaid/PlantUML 是”为工程图设计的 DSL”，适合流程、时序、ER 图，但一旦你想画个随意的草图、一张带涂鸦感的说明图，就很别扭。Excalidraw 的手绘风本来就是为”快速草图”设计的白板，适用面更宽——从架构图到头脑风暴到带点俏皮的插画都能画。更重要的是，MCP Apps 让这张图不是静态图片，而是可交互的白板：你可以在对话里直接拖动、编辑，而不是让 Agent 改 DSL 重新渲染。

四、关键数据与口径

  • 许可证：MIT（已核实）。
  • 技术栈：TypeScript 90.8%。
  • 版本：v0.3.2，5 个 release，6 位贡献者。
  • 仓库状态：33 个开放 Issue、26 个 PR——仍在快速迭代。
  • 部署：官方远程实例 + Vercel 一键自建。

五、官方未明说的局限与口径偏差

  1. 依赖 MCP Apps 客户端：MCP Apps 是较新的官方扩展，老版本或不支持该扩展的 MCP 客户端用不了交互白板，只能退化为普通文本；
  2. 早期版本：v0.3.x，33 个 issue 说明体验仍在打磨；
  3. 远程实例的数据边界：用官方 mcp.excalidraw.com 时，你的绘图内容会经过 Excalidraw 服务器，敏感架构图应自建 Vercel 实例；
  4. “可编辑”是白板级编辑：你能拖动画布，但要让 Agent 精准按你的意图调整某个元素，仍依赖模型对工具调用的准确度；
  5. 它不取代 Mermaid——需要严格语法图、可版本化 diff 的工程文档，Mermaid 仍有优势。

六、适用 / 不适用场景

适合：

  • 想在和 Agent 对话时快速出一张草图、架构示意、头脑白板；
  • 团队已经在用 Excalidraw 做设计沟通，想让 Agent 直接产出可编辑白板；
  • 需要把生成的图继续在白板上手改、协作。

不适合：

  • 要严格、可 diff、可版本化的工程图表（用 Mermaid/PlantUML）；
  • MCP 客户端不支持 MCP Apps 的环境；
  • 对数据出境敏感、又不想自建实例的场景。

七、客观分析：优势与局限

优势：

  1. 手绘风 + 可交互白板，比静态 Mermaid 图体验好一档；
  2. 官方出品（Excalidraw 组织维护），质量与后续有保障；
  3. 部署简单：远程即接，或 Vercel 一键自建，零环境变量；
  4. MIT、TypeScript，可二次开发。

局限：

  1. 依赖较新的 MCP Apps 协议，客户端支持不全；
  2. 早期版本，issue/PR 较多；
  3. 不适合严格工程图表；
  4. 远程实例的数据隐私需注意。

八、它意味着什么

Excalidraw MCP 是”MCP Apps”这个新协议方向的一个漂亮样本：当 MCP 从”让 Agent 调工具”进化到”让 Agent 返回可交互界面”，画图这类任务就从”生成一段 DSL 再渲染”升级为”直接给你一块可编辑的白板”。它说明 AI 生成图表的竞争维度，正在从”语法对不对”转向”交互顺不顺、能不能接着改”。对已经在用 Excalidraw 的团队，这个 MCP 几乎是必装；对普通用户，它值得一试——毕竟让 Claude 边聊边给你画张能直接改的草图，体验确实比 Mermaid 新鲜得多。

（说明：官方 docs/demo.gif 动态图体积过大、两次下载超时未获取，故本文以上方 README 截图作为证据图，动态交互形态仍以文字描述。）

参考来源