适合谁
- 需要迭代式图表设计的编程代理
- 希望图表作为仓库工件管理的团队
- 使用 Claude Code、Cursor 等代理的环境
E
43FMRS · D
该服务器功能强大，适合需要编程式图表控制的代理。它提供元素级 CRUD、布局工具、截图反馈和文件导出，尤其适合将图表作为仓库工件。但需注意画布为内存存储，重启会丢失，且截图功能需要浏览器打开。
mcp-excalidraw-server 为 AI 代理提供实时 Excalidraw 画布，支持绘制、查看、精修和保存图表。代理可编程创建架构图和流程图，通过截图查看自己的成果，修复布局问题，并导出 .excalidraw 文件以便随代码提交。核心绘图功能完全无需 API 密钥，本地运行（Node ≥ 18，MIT 许可）。提供 CLI、MCP 服务器（26 个工具）和 REST API 三种驱动方式。
工具能力
create_element
创建新元素
get_element
获取单个元素
update_element
更新元素属性
delete_element
删除元素
query_elements
按条件查询元素
batch_create_elements
批量创建元素
duplicate_elements
复制元素
align_elements
对齐元素
distribute_elements
分布元素
group_elements
组合元素
ungroup_elements
取消组合
lock_elements
锁定元素
unlock_elements
解锁元素
describe_scene
获取场景的文本摘要
get_canvas_screenshot
获取画布截图
export_scene
导出场景为 .excalidraw 文件
import_scene
导入 .excalidraw 文件
export_to_image
导出为图片（PNG/SVG）
export_to_excalidraw_url
导出为可分享的 excalidraw.com URL
create_from_mermaid
从 Mermaid 代码创建图表
clear_canvas
清空画布
snapshot_scene
创建场景快照
restore_snapshot
恢复场景快照
set_viewport
设置视口
read_diagram_guide
读取图表指南
get_resource
获取资源
安装接入
安装前提：Node.js ≥ 18。
- 在 Claude Desktop 配置文件中添加以下配置：
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": ["-y", "mcp-excalidraw-server"]
}
}
}- 保存并重启 Claude Desktop。
- 或在命令行使用 CLI：
npx -y mcp-excalidraw-server start。
claude_desktop_config.json
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": [
"-y",
"mcp-excalidraw-server"
]
}
}
}
选型与风险
不适合谁
- 只需要一次性生成图表（官方 MCP 可能更简单）
- 对图表有持久化存储需求的场景（画布默认为内存存储，重启会清空）
所需权限
- 本地网络访问：画布服务器默认绑定 127.0.0.1:3000
- 文件系统：导出和导入 .excalidraw 文件
- 可选的分享功能会上传加密场景到 excalidraw.com
风险与副作用
- 画布数据存储在内存中，服务器重启会丢失所有元素
- 如果配置为监听非回环地址，API 无内置认证，可能被他人访问
- 分享功能依赖 excalidraw.com 服务，可能受网络影响
常见排障
- CLI 退出码 3：画布服务器不可达，检查 EXPRESS_SERVER_URL 或运行 `start`
- CLI 退出码 4：截图或导出需要浏览器标签页打开画布，请打开 http://127.0.0.1:3000
- 画布不更新：确认 EXPRESS_SERVER_URL 指向运行中的画布服务器
使用场景
让 AI 代理创建架构图、流程图并实时编辑
将图表作为代码工件导出到仓库中，随代码更新
在 Obsidian 中直接编辑和同步图表
无需 MCP 配置，通过 CLI 驱动图表生成
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
Codex CLI完整支持
OpenCode完整支持
Antigravity完整支持