可自托管的 Excalidraw 白板应用,支持账号、团队空间、文件夹、搜索与实时协作,数据存于自有 Postgres。
yctimlin/mcp_excalidraw
为 AI 编程代理提供实时 Excalidraw 画布的 MCP 服务、CLI 与代理技能,可绘制、截图、编辑和导出图表。
- Star
- 2,625
- Fork
- 295
- 未关闭 Issue
- 42
- 最近提交
- 8天前
这是什么?
mcp-excalidraw-server 让 AI 代理可以在本地实时运行的 Excalidraw 画布上以编程方式创建和编辑图表。代理可以新增、查询、更新、删除单个元素,并使用对齐、分布、编组等操作排版,还能通过文字场景描述或渲染截图检查自己的输出。
项目提供三种方式驱动同一块画布:面向编程代理、推荐使用的 Agent Skill 加 CLI;面向 Claude Desktop、Cursor、Codex CLI 等 MCP 客户端的 stdio 服务(含 26 个工具);以及通用 REST API。执行绘图命令时画布服务会自动启动,核心绘图无需 API 密钥或账号。
图表可导出为 .excalidraw 文件以随代码提交,也可导出为 Obsidian 库使用的 .excalidraw.md 格式。截图和 PNG、SVG 导出在 Node 中无头渲染,Mermaid 转换和视口控制仍需要打开浏览器页面。
核心功能
- 01在实时 Excalidraw 画布上对单个元素进行增删改查。
- 02无头渲染截图以及 PNG、SVG 导出,便于代理检查自己的图表。
- 03提供对齐、分布、编组、锁定、复制等排版操作。
- 04支持命名快照及恢复,可回滚画布状态。
- 05支持 Mermaid 转画布,并可生成加密的 excalidraw.com 分享链接。
- 06可通过 CLI、MCP 服务或 REST API 使用。
适用场景
- 让编程代理为代码库绘制架构图和流程图。
- 把 .excalidraw 图表导出到代码仓库,与代码一同版本管理。
- 在 Obsidian 库中生成和维护 Excalidraw 图表。
- 在 CI 中无需浏览器将已提交的 .excalidraw 文件渲染为 PNG。
快速上手
- 1
用 npx 启动画布服务
npx -y mcp-excalidraw-server start - 2
用 CLI 绘制一个测试图
npx -y mcp-excalidraw-server describe - 3
将智能体技能安装到你的技能目录
npx -y mcp-excalidraw-server install-skill --dir <skills-root>
使用前须知
- Mermaid 转换需要在浏览器中打开画布页面。
- 画布页面从 esm.sh CDN 加载 Excalidraw 字体。
收录于专题
标签
常见问题
- mcp_excalidraw 是什么?
- 为 AI 编程代理提供实时 Excalidraw 画布的 MCP 服务、CLI 与代理技能,可绘制、截图、编辑和导出图表。 mcp-excalidraw-server 让 AI 代理可以在本地实时运行的 Excalidraw 画布上以编程方式创建和编辑图表。代理可以新增、查询、更新、删除单个元素,并使用对齐、分布、编组等操作排版,还能通过文字场景描述或渲染截图检查自己的输出。
- mcp_excalidraw 可以免费使用吗?用的什么许可证?
- mcp_excalidraw 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- mcp_excalidraw 还在维护吗?
- 活跃维护中。mcp_excalidraw 最近一次提交是在 2026年10月30日。
- mcp_excalidraw 适合用来做什么?
- 让编程代理为代码库绘制架构图和流程图。 把 .excalidraw 图表导出到代码仓库,与代码一同版本管理。 在 Obsidian 库中生成和维护 Excalidraw 图表。 在 CI 中无需浏览器将已提交的 .excalidraw 文件渲染为 PNG。
- mcp_excalidraw 怎么安装和运行?
- 用 npx 启动画布服务: npx -y mcp-excalidraw-server start 用 CLI 绘制一个测试图: npx -y mcp-excalidraw-server describe 将智能体技能安装到你的技能目录: npx -y mcp-excalidraw-server install-skill --dir <skills-root>
- 在哪里获取 mcp_excalidraw?
- 源代码和安装说明在 GitHub 上:https://github.com/yctimlin/mcp_excalidraw
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
本机运行的架构图工作区,通过对话读取上传资料,生成并修改可编辑的 Excalidraw 架构图。
可自托管的 Excalidraw 白板工作区,支持文件夹管理、实时协作、分享、历史记录与备份。
让 Claude Code 等编码代理根据自然语言描述生成 Excalidraw 图表的技能包。
一款开源的手绘风格虚拟白板,可用于绘制图表,也可作为 React 组件嵌入应用。
一个智能体技能,让编码助手把代码改动以可交互图表的形式讲解,图中各部分链接到源码。