MCP Excalidraw

🚀 Excalidraw MCP サーバー：強力な描画 API、LLM 統合に対応

強力な描画 API を備え、LLM 統合に対応した Excalidraw MCP サーバーです。このサーバーを使えば、Excalidraw の図表やイラストとシームレスにやり取りできます。

🚀 クイックスタート

Excalidraw MCP サーバーは、Excalidraw の図表やイラストとのシームレスなやり取りを可能にする、機能充実のモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、大規模言語モデル（LLM）に対して、構造化された開発者フレンドリーな 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
      }
    }
  }
}

注意事項

⚠️ 重要提示

• サーバーのアドレスとポートの設定が正しいことを確認してください。
• 詳細な情報については、完全な統合ドキュメントを参照してください。

Docker デプロイガイド

1. イメージの取得

docker pull excalidraw/mcp-server:latest

2. コンテナの起動

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

設定オプション

• LOG_LEVEL：ログレベルを設定します。デフォルトは "info" です。
• DEBUG：デバッグモードを有効にします。デフォルトは "false" です。
• DEFAULT_THEME：デフォルトのテーマを設定します。デフォルトは "light" です。

💻 使用例

基本的な使用法

矩形要素の作成

{
  "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 ファイルを参照してください。