Repolode
yctimlin

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. 1

    用 npx 启动画布服务

    npx -y mcp-excalidraw-server start
  2. 2

    用 CLI 绘制一个测试图

    npx -y mcp-excalidraw-server describe
  3. 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 数据每日更新。

相关项目