M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
E

Excalidraw MCP Server

社区
为 AI 代理提供实时 Excalidraw 画布，可编程创建、编辑和导出图表。
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
团队协作 第 43 / 55
Stars
★ 2.5k 非常热门
传输方式
stdio（本地进程）
运行环境
Node.js 18+ · Docker
凭据
无需凭据
许可证
MIT
最近提交
工具数
26
43FMRS · D

该服务器功能强大，适合需要编程式图表控制的代理。它提供元素级 CRUD、布局工具、截图反馈和文件导出，尤其适合将图表作为仓库工件。但需注意画布为内存存储，重启会丢失，且截图功能需要浏览器打开。

最强项 · 文档质量 16/20 最弱项 · 可靠性 4/20

可靠性
4/20
安全与权限
6/20
维护活跃度
5/20
文档质量
16/20
安装易用性
12/20
查看各项评分依据
可靠性 4/20
未提供可执行证据（无 package.json、dist/src 源码、CI 工作流或测试文件），仅有 README 声称的 26 个工具、CLI 退出码和测试步骤。README 属于不可信证据，因此无法核实 MCP 握手、tools/list 与实际行为是否一致。服务清单未缓存也进一步减分。
安全与权限 6/20
README 披露了若干安全相关设计：默认只绑定 127.0.0.1、无内置认证、share 使用 AES-GCM 加密且密钥仅在 URL fragment、示例配置中未出现真实令牌。但没有源码可验证这些声明；权限/确认机制、数据边界和外部网络调用只能在文档层面确认，因此无法给出更高分。未发现需要触发红线的证据。
维护活跃度 5/20
仓库未归档、有 MIT 许可证、README 提到 v1.1.0 和 CI/Docker 徽章，但缺少提交历史、发布时间、依赖更新记录和问题响应证据。Stars 和 open issues 仅作发现信号，不能证明持续维护。文档中‘Known Issues/TODO’存在，但维护治理与版本更新路径无法从提供材料核实。
文档质量 16/20
README 文档层次丰富：安装步骤、CLI 参考、多客户端 MCP 配置（Claude Desktop/Codex/Cursor 等）、环境变量表、工具分类、FAQ、故障排查和已知限制均有覆盖，且包含大量可复制示例和安全说明。扣分原因是文档未被源码验证，部分行为（如自动启动、浏览器依赖）只能算声明，且缺少服务器清单和实际 schema 证据。
安装易用性 12/20
README 给出了多种安装路径（npx、源码、Docker）和主流客户端配置示例，流程看似清晰、步骤少。但静态校准要求：没有可验证的执行证据（真实 CI + 对关键路径的测试）时，setup 不超过 15 分。同时缺少 server manifest 和 package 元数据，无法确认 npx 包名、入口和 Node 版本要求真实有效，故保守给 12 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络

适合谁

  • 需要迭代式图表设计的编程代理
  • 希望图表作为仓库工件管理的团队
  • 使用 Claude Code、Cursor 等代理的环境

不适合谁

  • 只需要一次性生成图表（官方 MCP 可能更简单）
  • 对图表有持久化存储需求的场景（画布默认为内存存储，重启会清空）

所需权限

  • 本地网络访问：画布服务器默认绑定 127.0.0.1:3000
  • 文件系统：导出和导入 .excalidraw 文件
  • 可选的分享功能会上传加密场景到 excalidraw.com

风险与副作用

  • 画布数据存储在内存中，服务器重启会丢失所有元素
  • 如果配置为监听非回环地址，API 无内置认证，可能被他人访问
  • 分享功能依赖 excalidraw.com 服务，可能受网络影响

安装接入

准备工作

运行环境：Node.js 18+ · Docker

其他可选配置项（6 个）
EXPRESS_SERVER_URL 可选 画布服务器的地址，默认 http://127.0.0.1:3000，一般无需设置。
ENABLE_CANVAS_SYNC 可选 是否启用实时画布同步，默认 true。
EXCALIDRAW_NO_AUTOSTART 可选 设为 1 时禁用画布服务器自动启动。
EXCALIDRAW_EXPORT_DIR 可选 MCP 文件导出允许写入的基准目录，默认为当前工作目录。
PORT 可选 画布服务器的监听端口，默认 3000。
HOST 可选 画布服务器的绑定地址，默认 127.0.0.1。

安装前提：Node.js ≥ 18。

  1. 在 Claude Desktop 配置文件中添加以下配置：
{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}
  1. 保存并重启 Claude Desktop。
  2. 或在命令行使用 CLI：npx -y mcp-excalidraw-server start。
claude_desktop_config.json 
{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal
claude mcp add excalidraw -- npx -y mcp-excalidraw-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中应能看到 create_element、describe_scene、get_canvas_screenshot 等工具；也可以让 AI 调用 describe_scene 画布概要，能返回场景内容即说明连接正常。

常见排障

  1. CLI 退出码 3：画布服务器不可达，检查 EXPRESS_SERVER_URL 或运行 `start`
  2. CLI 退出码 4：截图或导出需要浏览器标签页打开画布，请打开 http://127.0.0.1:3000
  3. 画布不更新：确认 EXPRESS_SERVER_URL 指向运行中的画布服务器

试试这样问

连接成功后，可以直接对 AI 助手这样说：

  • 画一个架构图：一个 API Server 矩形连接一个 Database 矩形，箭头标注 SQL。
  • 截图看一下当前画布，检查有没有文字被截断或元素重叠，然后修复布局。
  • 把当前场景导出为 docs/architecture.excalidraw 文件。
  • 把这段 Mermaid 流程图转换成画布上的 Excalidraw 图形。

工具能力 26

create_element 写入
创建新元素
get_element 只读
获取单个元素
update_element 写入
更新元素属性
delete_element 破坏性
删除元素
query_elements 只读
按条件查询元素
batch_create_elements 写入
批量创建元素
duplicate_elements 写入
复制元素
align_elements 写入
对齐元素
展开其余 18 个工具
distribute_elements 写入
分布元素
group_elements 写入
组合元素
ungroup_elements 写入
取消组合
lock_elements 写入
锁定元素
unlock_elements 写入
解锁元素
describe_scene 只读
获取场景的文本摘要
get_canvas_screenshot 只读
获取画布截图
export_scene 只读
导出场景为 .excalidraw 文件
import_scene 写入
导入 .excalidraw 文件
export_to_image 只读
导出为图片（PNG/SVG）
export_to_excalidraw_url 破坏性
导出为可分享的 excalidraw.com URL
create_from_mermaid 写入
从 Mermaid 代码创建图表
clear_canvas 破坏性
清空画布
snapshot_scene 写入
创建场景快照
restore_snapshot 破坏性
恢复场景快照
set_viewport 写入
设置视口
read_diagram_guide 只读
读取图表指南
get_resource 只读
获取资源

使用场景

让 AI 代理创建架构图、流程图并实时编辑
将图表作为代码工件导出到仓库中，随代码更新
在 Obsidian 中直接编辑和同步图表
无需 MCP 配置，通过 CLI 驱动图表生成

支持客户端

Claude Desktop
Claude Code
Cursor
Codex
OpenCode
Antigravity

依据项目文档列出，未经本站实测。

详细介绍

mcp-excalidraw-server 为 AI 代理提供实时 Excalidraw 画布，支持绘制、查看、精修和保存图表。代理可编程创建架构图和流程图，通过截图查看自己的成果，修复布局问题，并导出 .excalidraw 文件以便随代码提交。核心绘图功能完全无需 API 密钥，本地运行（Node ≥ 18，MIT 许可）。提供 CLI、MCP 服务器（26 个工具）和 REST API 三种驱动方式。

同类可选方案

与其他 MCP 横向对比

源版本 8084a1c8b410 数据同步于 2026-10-12 查看 FMRS 评分方法