Excalidraw MCP 服务器：用于 LLM 集成的强大绘图 API

一个全面的模型上下文协议 (MCP) 服务器，可以实现与 Excalidraw 图表和绘图的无缝交互。该服务器为 LLM（大型语言模型）提供通过结构化的、对开发者友好的 API 创建、修改、查询和操作 Excalidraw 绘图的能力。

功能

• 完整的 Excalidraw 元素控制：创建、更新、删除和查询任何 Excalidraw 元素
• 高级元素操作：组合、对齐、分布、锁定和解锁元素
• 资源管理：访问和修改场景信息、库、主题和元素
• 易于集成：与 Claude Desktop 和其他 LLM 平台配合使用
• Docker 支持：通过容器化选项进行简单部署

API 工具参考

元素创建和修改

• create_element

  • 创建一个新的 Excalidraw 元素（矩形、椭圆、菱形等）
  • 必需输入：type，x，y 坐标
  • 可选输入：尺寸、颜色、样式属性

• update_element

  • 通过 ID 更新现有的 Excalidraw 元素
  • 必需输入：要更新的元素的 id
  • 可选输入：要修改的任何元素属性

• delete_element

  • 删除一个 Excalidraw 元素
  • 必需输入：要删除的元素的 id

• query_elements

  • 查询元素，带有可选的过滤
  • 可选输入：type 按元素类型过滤，带有键值对的 filter 对象

资源管理

• get_resource
  • 获取特定资源，如场景信息或所有元素
  • 必需输入：resource 类型（scene、library、theme、elements）

元素组织

• group_elements

  • 将多个元素组合在一起
  • 必需输入：要组合的元素 ID 的 elementIds 数组

• ungroup_elements

  • 解除一组元素的组合
  • 必需输入：要解除组合的组的 groupId

• align_elements

  • 基于指定的对齐方式对齐多个元素
  • 必需输入：elementIds 数组和 alignment（left、center、right、top、middle、bottom）

• distribute_elements

  • 在空间中均匀分布元素
  • 必需输入：elementIds 数组和 direction（horizontal 或 vertical）

• lock_elements

  • 锁定元素以防止修改
  • 必需输入：要锁定的元素的 elementIds 数组

• unlock_elements

  • 解锁元素以允许修改
  • 必需输入：要解锁的元素的 elementIds 数组

与 Claude Desktop 集成

要将此服务器与 Claude Desktop 应用程序一起使用，请将以下配置添加到 claude_desktop_config.json 的 "mcpServers" 部分：

{
  "mcpServers": {
    "excalidraw": {
      "command": "node",
      "args": ["src/index.js"],
      "env": {
        "LOG_LEVEL": "info",
        "DEBUG": "false"
      }
    }
  }
}

与 Cursor 集成

要将此服务器与 Cursor 一起使用，请在您的工作区中创建一个 .cursor/mcp.json 文件，其中包含以下配置：

{
  "mcpServers": {
    "excalidraw": {
      "command": "node",
      "args": [
        "/path/to/your/directory/mcp_excalidraw/src/index.js"
      ],
      "env": {
        "LOG_LEVEL": "info",
        "DEBUG": "false"
      }
    }
  }
}

请确保：

1. 将 /path/to/your/directory 替换为您的 mcp_excalidraw 安装的实际绝对路径
2. 如果 .cursor 目录不存在，请创建它
3. 确保 index.js 的路径正确且文件存在

Docker 集成

{
  "mcpServers": {
    "excalidraw": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/excalidraw"],
      "env": {
        "LOG_LEVEL": "info",
        "DEBUG": "false"
      }
    }
  }
}

安装指南

NPM 安装

# 安装依赖
npm install

# 启动服务器
npm start

Docker 安装

# 构建 Docker 镜像
docker build -t mcp/excalidraw .

# 运行容器
docker run -i --rm mcp/excalidraw

配置选项

可以使用以下环境变量配置服务器：

• LOG_LEVEL - 设置日志记录级别（默认值："info"）
• DEBUG - 启用调试模式（默认值："false"）
• DEFAULT_THEME - 设置默认主题（默认值："light"）

使用示例

以下是一些如何使用 Excalidraw MCP 服务器的实际示例：

创建一个矩形元素

{
  "type": "rectangle",
  "x": 100,
  "y": 100,
  "width": 200,
  "height": 100,
  "backgroundColor": "#ffffff",
  "strokeColor": "#000000",
  "strokeWidth": 2,
  "roughness": 1
}

查询特定元素

{
  "type": "rectangle",
  "filter": {
    "strokeColor": "#000000"
  }
}

组合多个元素

{
  "elementIds": ["elem1", "elem2", "elem3"]
}

许可证

此 Excalidraw MCP 服务器是在 MIT 许可证下授权的。您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。