LetDraw

LetDraw MCP + REST

将 AI 助手和你自己的脚本连接到 LetDraw — 通过 Model Context Protocol (MCP) 或 公共 REST API， 读取和创建你账户中的图表。

LetDraw 是一款在线白板和图表绘制应用，采用手绘风格。通过此集成，MCP 客户端（桌面 AI 应用、Cursor、VS Code、Codex 等）或任何 HTTP 客户端都可以列出工作区、创建和更新图表、通过代码生成图表（compose / Kubernetes / DOT / Terraform / SQL 等）、盖印真实产品图标、导出为 Mermaid 或 D2，并分享只读链接。

此代码仓库提供的是客户端集成：零配置 MCP 桥接程序、类型化 REST SDK、API 规范和设置文档。LetDraw 应用和 服务不属于此代码仓库。

此处包含的内容

路径	内容
packages/mcp	@letdraw/mcp — 连接托管 MCP 服务的零配置 stdio 桥接程序（npx @letdraw/mcp）
packages/sdk	@letdraw/sdk — 用于编写脚本的类型化 REST 客户端
spec/mcp-tools.md	MCP 工具、资源和作用域
spec/openapi.yaml	REST API 的 OpenAPI 3.1 规范
spec/capabilities.md	面向 AI 客户端的「如何在 LetDraw 中绘制优质图表」指南
docs/	入门指南 + 各客户端的设置说明（桌面应用、HTTP 客户端、Cursor、VS Code、Codex）
examples/	可直接复制粘贴的示例

端点

REST base   https://api.letdraw.com/api-v1
MCP URL     https://api.letdraw.com/mcp

两者都使用个人 API 令牌（Authorization: Bearer ld_live_…）进行身份验证，而非登录会话。请在 LetDraw 应用的 账户 → 开发者下创建令牌。准确的 URL 和可直接粘贴使用的客户端配置 也会显示在那里。

60 秒快速开始（MCP）

托管服务支持 Streamable-HTTP，因此大多数客户端可以直接连接。对于 stdio 客户端，或想要尽可能简单的设置，请使用桥接程序：

// MCP client config (mcpServers block)
{
  "mcpServers": {
    "letdraw": {
      "command": "npx",
      "args": ["-y", "@letdraw/mcp"],
      "env": { "LETDRAW_TOKEN": "ld_live_YOUR_TOKEN" }
    }
  }
}

桌面应用、HTTP 客户端、Cursor、VS Code 和 Codex 的说明，请参阅 docs/clients。

60 秒快速开始（REST）

curl https://api.letdraw.com/api-v1/workspaces \
  -H "Authorization: Bearer ld_live_YOUR_TOKEN"

也可以使用 SDK：

import { LetdrawClient } from '@letdraw/sdk';
const ld = new LetdrawClient({ token: process.env.LETDRAW_TOKEN! });
const { workspaces } = await ld.listWorkspaces();

作用域

令牌包含作用域；每个工具/路由都需要相应的作用域：

• diagrams:read — 列出/获取工作区、文件夹、图表和图标
• diagrams:write — 创建/更新/删除/分享图表，以及通过代码生成图表
• export — 导出为 Mermaid / D2
• ai:generate — 根据提示词生成图表（使用你自己的 AI 密钥）

许可证

MIT — 详见 LICENSE。「LetDraw」和 LetDraw 徽标是其所有者的商标；详见 NOTICE.md。