Excalidraw图表MCP服务

为Excalidraw图表提供Model Context Protocol(MCP)服务,支持在多种开发环境中创建、管理和获取图表状态。

  • by cmd8
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 cmd8/excalidraw-mcp

使用说明

@cmd8/excalidraw mcp

用于Excalidraw图的模型上下文协议(MCP)服务器。

🛠️ 安装

需求

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

添加到光标MCP配置(~/.cursor/mcp.json):

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

添加到您的VS Code MCP设置中:

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

添加到您的Windsurf MCP配置中:

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

添加到您的 claude_desktop_config.json:

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

添加到Codex MCP配置中:

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

CLI选项

  • -d, --diagram (必需):Excalidraw图表文件的路径

🔨 可用工具

createNode

在图表中创建一个新节点(带标签的形状)。返回创建的节点ID。

createEdge

创建一个连接两个节点的箭头。节点可以通过ID或标签文本引用。

deleteElement

按ID或标签从图中删除节点或边。

getFullDiagramState

返回完整图表的标记表示,包括节点、关系、标签、框架和颜色。

许可证

麻省理工学院