@cmd8/excalidraw-mcp

中文文档
1.2.0发布于 2025/11/29MITES Module构建来源已验证近 30 天下载 3556

Excalidraw图的上下文协议模型服务器.

中文使用文档
文档目录9 节
  1. * 安装
  2. 所需资源
  3. CLI 选项
  4. 可用的工具
  5. createNode
  6. createEdge
  7. deleteElement
  8. getFullDiagramState
  9. 许可证

@ cmd8/ excalidraw- mcp

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

* 安装

所需资源

  • 节点.js >= v 18.0.0
在光标中安装

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

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
    }
  }
}
在 Claude 代码中安装
claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
在 Amp 中安装
amp mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
在 VS 代码中安装

添加到您的 VS 代码 MCP 设置 :

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

在您的 Windsurf MCP 配置中添加:

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
    }
  }
}
在 Claude 桌面中安装

添加到您的 claude_desktop_config.json数字 :

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
    }
  }
}
在 OpenAI 编码器中安装

在您的 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

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

许可证

麻省理工学院

版本与发布记录

@cmd8/excalidraw-mcp 共发布 7 个版本,首次发布于 2025/11/27;过去 12 个月发布了 7 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.0latest2025/11/2911 个月前
1.1.12025/11/2711 个月前
1.1.02025/11/2711 个月前
1.0.02025/11/2711 个月前
0.1.42025/11/2711 个月前
0.1.12025/11/2711 个月前

关于 @cmd8/excalidraw-mcp 的常见问题

@cmd8/excalidraw-mcp 是什么?

Excalidraw图的上下文协议模型服务器.

如何安装 @cmd8/excalidraw-mcp?

在项目目录运行 npm install @cmd8/excalidraw-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 excalidraw-mcp,可以用 npx excalidraw-mcp 直接运行。

@cmd8/excalidraw-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/cmd8__excalidraw-mcp 是否存在。

@cmd8/excalidraw-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cmd8/excalidraw-mcp 可以商用吗?

@cmd8/excalidraw-mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cmd8/excalidraw-mcp 的下载量有多少?

根据 npm 官方下载统计,@cmd8/excalidraw-mcp 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,556 次,日均约 119 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cmd8/excalidraw-mcp 还在维护吗?

最新版本 1.2.0 发布于 2025/11/29(11 个月前);至今共发布 7 个版本,其中过去 12 个月发布了 7 个;首次发布于 2025/11/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。