svg-whiteboard-mcp

MCP server that keeps SVG path canvases in memory, serves a loopback HTML preview (127.0.0.1), and returns proj-airi Surface embedUrl payloads so AIRI can render chat tool results in a sandbox iframe.

Tools

Related MCP server: tldraw-mcp

Run (stdio)

pnpm install
pnpm build
node dist/index.js

MCP client config example:

{
  "mcpServers": {
    "svg-whiteboard": {
      "command": "node",
      "args": ["/absolute/path/to/svg-whiteboard-mcp/dist/index.js"]
    }
  }
}

Requirements

• Node 20+

• Host (e.g. Electron) must allow the renderer to load http://127.0.0.1:* preview URLs.

Contract

structuredContent includes:

{
  "projAiriSurface": {
    "version": 1,
    "kind": "embedUrl",
    "title": "...",
    "data": { "url": "http://127.0.0.1:PORT/preview/CANVAS_ID", "mimeType": "text/html" }
  }
}

Aligns with @proj-airi/mcp-surface-contract in the AIRI monorepo.