Excalidraw Mcp

io.github.cmd8由 GitHub 帳號 cmd8 發布v1.2.0更新於 Oct 24, 2026

Model Context Protocol server for Excalidraw diagrams.

已驗證STDIO僅桌面效率與工作流媒體與設計

概覽

AI 產生的概覽

讓助理在本機 Excalidraw 圖表檔案中建立、連接、刪除與讀取節點和連線。

可以做什麼
這個 MCP 伺服器只操作啟動時指定的單一 Excalidraw 圖表檔案。它的工具可建立節點（帶標籤的圖形）並回傳節點 ID，依 ID 或標籤文字在兩個節點之間建立箭頭，依 ID 或標籤刪除節點或連線，並回傳整張圖表的 markdown 表示，包含節點、關係、標籤、畫框與顏色。
適用情境
適合希望助理直接建立或編輯圖表檔案的情境，例如用節點和箭頭繪製架構圖或流程圖，或把現有圖表讀成 markdown 以便檢視。
執行需求
以 npm 套件形式透過 stdio 在本機執行，需要 Node.js v18.0.0 或更新版本。必須用必填的 --diagram 選項傳入圖表檔案路徑。未宣告任何帳號、API 金鑰或環境變數。
安裝前請注意
伺服器會寫入你指定的圖表檔案，且 deleteElement 會刪除節點或連線，變更可能造成資料遺失，建議保留備份或使用版本控制。僅支援桌面端，無法在網頁中執行。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Excalidraw Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@cmd8/excalidraw-mcp

Model Context Protocol (MCP) server for Excalidraw diagrams.

🛠️ Installation

Requirements

  • Node.js >= v18.0.0
Install in Cursor

Add to your Cursor MCP config (~/.cursor/mcp.json):

json
{  "mcpServers": {    "excalidraw": {      "command": "npx",      "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]    }  }}
Install in Claude Code
sh
claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
Install in Amp
sh
amp mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
Install in VS Code

Add to your VS Code MCP settings:

json
{  "mcp": {    "servers": {      "excalidraw": {        "type": "stdio",        "command": "npx",        "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]      }    }  }}
Install in Windsurf

Add to your Windsurf MCP config:

json
{  "mcpServers": {    "excalidraw": {      "command": "npx",      "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]    }  }}
Install in Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "excalidraw": {      "command": "npx",      "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]    }  }}
Install in OpenAI Codex

Add to your Codex MCP config:

toml
[mcp_servers.excalidraw]command = "npx"args = ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]

CLI Options

  • -d, --diagram (required): Path to the Excalidraw diagram file

🔨 Available Tools

createNode

Create a new node (shape with label) in the diagram. Returns the created node ID.

createEdge

Create an arrow connecting two nodes. Nodes can be referenced by ID or by label text.

deleteElement

Delete a node or edge from the diagram by ID or label.

getFullDiagramState

Returns a markdown representation of the complete diagram, including nodes, relationships, labels, frames, and colors.

License

MIT

來源：README.md，提交 21abaea

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分