Deployment

Local (stdio)

For Claude Code, Claude Desktop, and Cursor — the MCP server communicates over stdio:

npx drawmode --stdio

Configure your client:

{
  "mcpServers": {
    "drawmode": {
      "command": "npx",
      "args": ["drawmode", "--stdio"]
    }
  }
}

Local (HTTP)

Streamable HTTP server on port 3001:

npx drawmode

Useful for development and testing with HTTP-based MCP clients.

Cloudflare Workers

Deploy the worker/ directory to Cloudflare Workers for remote MCP access:

Manual Deployment

cd worker
npx wrangler deploy

Worker Requirements

The Worker requires these compatibility flags in wrangler.toml:

• nodejs_compat — Node.js API compatibility
• unsafe_eval — required for new Function() code execution

PNG/SVG Export

PNG and SVG export is built-in — no browser or external dependencies needed. Both local and Worker deployments use the same pipeline:

1. linkedom (pure JS DOM shim) runs Excalidraw’s exportToSvg() server-side
2. SVG: The SVG string is returned directly
3. PNG: The SVG is passed to PlutoSVG WASM (svgToPng) which renders at 2x retina resolution

Fonts (Virgil, Assistant) are embedded in the WASM binary via @embedFile.

Publishing

npm

npm publish

Users install via npx drawmode.

MCP Registry

Publish to registry.modelcontextprotocol.io for auto-indexing by PulseMCP and Smithery.