apps/mcp-app

Purpose

apps/mcp-app/ is a Model Context Protocol server. It exposes tldraw functionality to AI clients over the MCP wire protocol so that an LLM can drive the canvas — read shapes, create new ones, modify properties, run tools.

Directory layout

apps/mcp-app/
├── README.md
├── server.json                 # MCP server manifest
├── wrangler.toml               # Cloudflare Worker config
├── vite.config.ts
├── dev-tunnel.sh
├── plugins/                    # MCP plugins (the tools the server exposes)
├── scripts/
└── src/

How it works

graph LR
    LLM[MCP client] -->|MCP protocol| Server[apps/mcp-app]
    Server --> Plugins[plugins/*]
    Plugins -->|RPC| Editor[a tldraw Editor instance]

The server runs on Cloudflare Workers (per wrangler.toml) and exposes a manifest of tools. Each tool corresponds to an editor operation (e.g., create shape, list shapes, run select tool). Plugins under plugins/ register these tools.

Deployment

.github/workflows/deploy-mcp-app.yml deploys the worker. The local dev story uses dev-tunnel.sh to expose the worker to an MCP-aware client.

Integration points

• Imports. tldraw, @tldraw/store, plus an MCP server SDK.
• External. Cloudflare Workers, MCP clients (Claude Desktop, etc.).

Related

• Apps
• @tldraw/tldraw