CanvasKeep

CanvasKeep MCP 服务

一个 MCP（Model Context Protocol）服务，可让 Claude Code 和 Codex 等 AI 工具生成 Excalidraw 图表，并将其直接保存到你的 CanvasKeep 工作区。

设置

1. 获取 API 密钥

1. 登录 CanvasKeep
2. 点击个人资料菜单（右上角），然后选择 API Keys
3. 生成一个新密钥并立即复制（之后将无法再次查看）

2. 安装并注册

Claude Code：

claude mcp add canvaskeep \
  -e CANVASKEEP_API_KEY=ck_your_key_here \
  -- npx canvaskeep-mcp

Codex / 其他 MCP 客户端：

{
  "mcpServers": {
    "canvaskeep": {
      "command": "npx",
      "args": ["canvaskeep-mcp"],
      "env": {
        "CANVASKEEP_API_KEY": "ck_your_key_here"
      }
    }
  }
}

3. 环境变量

变量	必填	默认值	描述
CANVASKEEP_API_KEY	是	-	你的 CanvasKeep 控制面板 API 密钥
CANVASKEEP_MASTER_KEY	否	-	读取或编辑加密图表时需要。请从 canvaskeep.com/dashboard/encryption 复制（MCP 服务密钥）
CANVASKEEP_API_URL	否	https://canvaskeep.com	API 基础 URL（可覆盖，用于本地开发）

可用工具

工具	描述
list_workspaces	列出所有工作区
create_workspace	创建新工作区
list_folders	列出工作区中的文件夹
create_folder	创建文件夹，可选择嵌套
list_diagrams	列出工作区中的图表
create_diagram	创建图表，可选择放入文件夹
update_diagram	重命名图表
delete_diagram	永久删除图表
get_diagram_summary	获取图表元数据和元素数量
get_diagram_scene	读取图表的完整 Excalidraw 场景
save_diagram_scene	将完整的 Excalidraw 场景写回图表
generate_diagram	根据节点和边生成图表，并自动布局

加密

在 CanvasKeep 中加密的图表，在 AI 工具处理时仍保持加密状态。当 get_diagram_scene 或 save_diagram_scene 处理加密图表时，此服务会在本地对其解密并重新加密（AES-GCM，参见 src/encryption.ts），使用的密钥是 CANVASKEEP_MASTER_KEY。主密钥不会离开你的设备。

generate_diagram 会将你提供的节点和边发送给 CanvasKeep，由服务端进行布局，因此通过此方式生成的图表会以未加密形式存储。

使用示例

向 Claude Code 提出类似这样的请求：

“绘制一个 Web 应用架构图，包含 React 前端、Node API、PostgreSQL 数据库和 Redis 缓存。”

Claude 将使用 MCP 工具在你的 CanvasKeep 工作区中创建图表，并合理布局方框和带标签的箭头。

开发

git clone https://github.com/CanvasKeep/canvaskeep-mcp.git
cd canvaskeep-mcp
npm install
npm run build
CANVASKEEP_API_KEY=ck_... CANVASKEEP_API_URL=http://localhost:3000 node dist/index.js

要在 Claude Code 中运行本地构建：

claude mcp add canvaskeep \
  -e CANVASKEEP_API_KEY=ck_your_key_here \
  -- node /path/to/canvaskeep-mcp/dist/index.js

许可证

MIT