用途:在 Excalidraw 实时画布上创建、编辑和优化图表,适合智能体绘制架构图、流程图等。
接口选择:优先使用 MCP 工具(如 batch_create_elements);无 MCP 时用 CLI:npx -y mcp-excalidraw-server <command>,首次运行自动下载并在 http://127.0.0.1:3000 启动画布服务;全局安装后可用别名 excalidraw-canvas。REST API 为最后手段,服务需已运行。画布地址由 EXPRESS_SERVER_URL 决定,默认 http://127.0.0.1:3000。截图与图片导出在服务端无头渲染,无需浏览器标签;仅 Mermaid 转换和视口控制需要打开标签(缺失时退出码 4)。
主要能力:批量创建元素(add/apply)、读取与查询(get/query)、更新删除、describe 文本摘要、screenshot 截图、arrange 对齐分布分组锁定、export/import 场景文件、Mermaid 转换、snapshot 快照、share 分享链接、clear 清空。元素格式支持 text 标签、startElementId/endElementId 箭头绑定、fontFamily 名称或数字、points 元组或对象。
使用要点:画布为二维坐标,x 向右 y 向下;建议层间距 80–120px、同级间距 40–60px,形状宽度 max(160, 标签字符数*12)。避免在大背景矩形上使用 label.text(会居中遮挡内容),改用独立文本元素;复杂图避免跨区箭头;箭头标签尽量少且不超过 12 字符。每批元素后截图并按质量清单检查截断、重叠、箭头穿越、间距与字号。
限制:Mermaid 转换与浏览器渲染截图需打开画布标签;直接 POST REST 时标签与绑定字段格式更严格;Obsidian 库中应导出为 .excalidraw.md。退出码:0 成功、1 错误、2 用法、3 画布不可达、4 需要浏览器标签。