io.github.cmd8/excalidraw-mcp

Name: io.github.cmd8/excalidraw-mcp
Rating: 0.2 (3 reviews)
Author: cmd8

编码与调试

by cmd8

面向 Excalidraw 图表的 Model Context Protocol 服务器，可供 AI 生成与操作草图。

3GitHub

什么是 io.github.cmd8/excalidraw-mcp？

面向 Excalidraw 图表的 Model Context Protocol 服务器，可供 AI 生成与操作草图。

README

@cmd8/excalidraw-mcp

Model Context Protocol (MCP) server for Excalidraw diagrams.

🛠️ Installation

Requirements

Node.js >= v18.0.0

<details> <summary>Install in Cursor</summary>

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

json

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

</details> <details> <summary>Install in Claude Code</summary>

claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw

</details> <details> <summary>Install in Amp</summary>

amp mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw

</details> <details> <summary>Install in VS Code</summary>

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

</details> <details> <summary>Install in Windsurf</summary>

Add to your Windsurf MCP config:

json

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

</details> <details> <summary>Install in Claude Desktop</summary>

Add to your claude_desktop_config.json:

json

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

</details> <details> <summary>Install in OpenAI Codex</summary>

Add to your Codex MCP config:

toml

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

</details>

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

常见问题