MCP Excalidraw

🚀 Excalidraw MCP 服務器：強大的繪圖 API，支持 LLM 集成

本項目是一個功能全面的模型上下文協議（MCP）服務器，可與 Excalidraw 圖表和插畫實現無縫交互。它為大型語言模型 (LLMs) 提供了結構化且便於開發者使用的 API，能讓其創建、修改、查詢和操作 Excalidraw 繪圖。

✨ 主要特性

• 完整的 Excalidraw 元素控制：支持創建、更新、刪除和查詢任意 Excalidraw 元素。
• 高級元素操作：支持對齊、分發、鎖定和解鎖元素。
• 資源管理：可訪問並修改場景信息、庫、主題和元素。
• 輕鬆集成：與 Claude Desktop 和其他 LLM 平臺兼容。
• Docker 集成：支持通過 Docker 進行部署。

📚 詳細文檔

API 工具參考

創建矩形元素示例

{
  "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"]
}

集成指南

與 Claude Desktop 的集成

在 config.json 文件中添加以下配置：

{
  "excalidrawMCP": {
    "enabled": true,
    "serverUrl": "http://localhost:8080"
  }
}

與 Cursor 的集成

創建一個 .mcp.json 配置文件，內容如下：

{
  "integrations": {
    "excalidrawMCP": {
      "enable": true,
      "options": {
        "serverHost": "localhost",
        "port": 8080
      }
    }
  }
}

注意事項

⚠️ 重要提示

確保服務器地址和端口配置正確。查看完整的集成文檔以獲取更多詳細信息。

配置選項

💻 使用示例

基礎用法

創建矩形元素

{
  "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"]
}

📦 安裝指南

Docker 部署指南

拉取鏡像

docker pull excalidraw/mcp-server:latest

啟動容器

docker run -p 8080:8080 --name excalidraw-mcp excalidraw/mcp-server:latest

📄 許可證

此 Excalidraw MCP 服務器根據 MIT 許可證發佈。您可免費使用、修改和分發該軟件，但需遵守 MIT 許可證的條款和條件。如需更多詳情，請參閱項目倉庫中的 LICENSE 文件。