用途:在实时 Excalidraw 画布上创建与优化图表,通过 MCP 工具进行交互式编辑,并提供导出/导入等脚本化工作流。使用前需确保画布服务器可通过 EXPRESS_SERVER_URL 访问,默认地址为 http://localhost:3000。
主要能力:MCP 工具负责交互式图表编辑;scripts/*.cjs 脚本处理导出、导入、清空与健康检查等流程。可用 node scripts/healthcheck.cjs 或 GET /health 确认画布状态,node scripts/clear-canvas.cjs 清空画布,用 create_element 创建矩形/菱形/椭圆等形状,通过设置形状的 text 字段添加文字标签(除非需要独立文字,否则不单独创建文字元素),在两端元素存在后再创建箭头或连线,粗略摆放后使用 align_elements / distribute_elements 对齐分布,布局稳定后再分组。
精修现有图表:优先用 get_resource(resource: "elements")或 query_elements 查看已有内容,依据 id、类型或标签文本等稳定信号定位目标,而非精确 x/y;用 update_element 移动/缩放/改色/改文字,用 delete_element 删除。若删除或更新无效,检查是否指向正确的 EXPRESS_SERVER_URL、元素 id 是否存在(可用 get_resource 或 GET /api/elements/:id)、元素是否被锁定(先用 unlock_elements)。
导出与导入:node scripts/export-elements.cjs --out diagram.elements.json 导出当前元素为 JSON;node scripts/import-elements.cjs --in diagram.elements.json --mode batch 以批量创建方式追加导入;--mode sync 会先清空画布再写入,适合让画布与文件一致。若需跨更新保持稳定 id,请在导出的 JSON 中保留 id;若想使用新 id,导入前重新生成。
限制与注意:需保证画布服务器可达,全部操作依赖该服务;详细端点与工具参数见 references/cheatsheet.md。资料未提供收费、平台支持范围或其他使用限制,暂未提供。