# 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**](https://github.com/moeru-ai/airi/tree/main/packages/mcp-surface-contract) **`embedUrl`** payloads so AIRI can render chat tool results in a **sandbox iframe**.

## Tools

| Tool | Purpose |
|------|---------|
| `create_canvas` | New canvas → `id` |
| `delete_canvas` | Remove canvas |
| `list_canvases` | List ids / sizes / path counts |
| `add_path` | Append SVG `<path>` (`d`, stroke, fill, …) |
| `delete_path` | Remove path by id |
| `list_paths` | Inspect paths on a canvas |
| `present_preview` | Return `structuredContent.projAiriSurface` with preview URL |
| `proj_airi_present_surface` | Same envelope for arbitrary `http(s)` URLs |

## Run (stdio)

```bash
pnpm install
pnpm build
node dist/index.js
```

MCP client config example:

```json
{
  "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:

```json
{
  "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.