Excalidraw MCP 服务器：用于 LLM 集成的强大绘图 API
全面的模型上下文协议 (MCP) 服务器，可实现与 Excalidraw 图表和绘图的无缝交互。该服务器通过结构化、开发人员友好的 API，为 LLM（大型语言模型）提供创建、修改、查询和操作 Excalidraw 绘图的功能。
特征
完整的 Excalidraw 元素控制
创建、更新、删除和查询任何 Excalidraw 元素（矩形、椭圆、菱形、文本、箭头等），包括支持：位置（
x，y）尺寸（
width，height）样式（
backgroundColor、strokeColor、strokeWidth、roughness、opacity）文本（
text，fontSize，fontFamily）线几何（
points）锁定（
locked标志）
高级元素操作
对元素进行分组、取消分组、对齐、分布、锁定和解锁。场景和应用状态管理
跟踪和修改场景级状态：
theme、viewBackgroundColor、viewport（滚动和缩放）、selectedElements、groups。检索所有元素或单个场景属性的库。
保存场景
将当前场景（元素 + appState）导出到磁盘上的.excalidraw文件。资源管理
访问和修改场景信息、元素库、主题和原始元素数据。轻松集成
与 Claude Desktop、Cursor 以及任何其他支持 MCP 的 LLM 平台兼容。Docker 支持
简单的容器化部署，实现零依赖安装。
Related MCP server: Excalidraw MCP Server
API 工具参考
元素创建和修改
create_element
创建一个新的 Excalidraw 元素。
输入
{ "type": "<element type>", "x": <number>, "y": <number>, "width": <number, optional>, "height": <number, optional>, "points": [{"x":<number>,"y":<number>}…], "backgroundColor": "<hex>", "strokeColor": "<hex>", "strokeWidth": <number>, "roughness": <number>, "opacity": <0–1>, "text": "<string>", "fontSize": <number>, "fontFamily": "<string>", "locked": <boolean> }输出
{ "id": "<generated‑id>", "type": "<element type>", "created": true }
update_element
更新现有元素的属性。
输入
{ "id": "<element id>", }输出
{ "id": "<element id>", "updated": true, "version": <new‑version‑number> }
delete_element
从场景中移除一个元素。
输入
{ "id": "<element id>" }输出
{ "id": "<element id>", "deleted": true }
query_elements
列出与可选过滤器匹配的元素。
输入
{ "type": "<element type>", "filter": { "<prop>": <value> } }输出
[ { /* element objects */ } … ]
资源管理
get_resource
检索场景或库信息。
输入
{ "resource": "scene"|"library"|"theme"|"elements" }输出
场景→
{ theme, viewport: {x,y,zoom}, selectedElements: […] }库/元素→
{ elements: [ … ] }主题→
{ theme: "light"|"dark" }
元素组织
group_elements / ungroup_elements
对元素集合进行分组或取消分组。
输入
{ "elementIds": ["id1","id2",…] } { "groupId": "<group id>" }输出
{ "groupId": "<new‑id>", "elementIds": […], "ungrouped": true? }
align_elements
将多个元素对齐到指定的边缘或中心。
输入
{ "elementIds": […], "alignment": "left"|"center"|"right"|"top"|"middle"|"bottom" }输出
{ aligned: true, elementIds: […], alignment: "<alignment>" }
distribute_elements
水平或垂直均匀分布元素。
输入
{ "elementIds": […], "direction": "horizontal"|"vertical" }输出
{ distributed: true, elementIds: […], direction: "<direction>" }
lock_elements / unlock_elements
防止或允许编辑元素。
输入
{ "elementIds": [… ] }输出
{ locked: true|false, elementIds: […] }
场景管理
save_scene
将当前场景（元素 + appState）导出到.excalidraw文件。
输入
{ "filename": "<optional, must end with .excalidraw>" }输出
Scene saved successfully to <filename>或出现错误消息。
集成示例
克劳德桌面
光标
创建.cursor/mcp.json ：
Docker
或者在 MCP 配置中：
安装指南
Docker
配置选项
通过.env或容器中的环境变量设置：
LOG_LEVEL— 日志级别（默认值："info"）DEBUG— 调试模式（"true"/"false"，默认值："false"）DEFAULT_THEME— 默认 UI 主题 ("light"/"dark"，默认值："light")