excalidraw-ai — MCP-Server (KI-Schnittstelle zu Excalidraw)

Die saubere, nicht klobige Schnittstelle für eine KI, um einen Live-Excalidraw-Raum zu lesen, zu beobachten und zu bearbeiten. Statt Browser-Automatisierung (Faser-Lesen + Drag-and-Drop + Remote-Browser-Drops) tritt es dem Raum als Socket-Bot über das Kollaborations-Relay bei und spricht das AES-GCM-verschlüsselte Szenenprotokoll direkt — deterministisch, kopflos, skalierbar.

POC-Status: Kern-Bridge + MCP-Stdio-Oberfläche funktioniert Ende-zu-Ende gegen ein selbst gehostetes excalidraw-room-Relay (Selbsttest + MCP-Smoke-Test bestanden).

Warum ein Relay, das wir kontrollieren

Der Bot spricht mit einem Relay. Das gehostete Relay von Excalidraw (oss-collab.excalidraw.com) schützt Nicht-Browser-Bots durch Ursprungsprüfung (403/400), daher betreiben wir für unsere eigenen Räume excalidraw/excalidraw-room (MIT, gleicher Code wie Produktion) und richten eine Excalidraw-Benutzeroberfläche darauf aus über VITE_APP_WS_SERVER_URL.

Related MCP server: Excalidraw MCP Server

Architektur

Excalidraw UI (fork) ──socket.io──▶ relay (excalidraw-room) ◀──socket-bot── excalidraw-ai (MCP)
   (humans)                           self-hosted                 (the AI's interface)

Werkzeuge

Ausführen

npm install
# relay (one terminal):
cd /tmp/excalidraw-room && PORT=3002 node dist/index.js
# self-test the bridge core:
npm run selftest
# MCP smoke (stdio handshake + join + get_scene):
npm run mcp-smoke
# start the MCP server (stdio) — wire into Hermes/Copilot/Claude:
node src/server.js

In Hermes einbinden (~/.hermes/config.yaml)

mcp_servers:
  excalidraw_ai:
    command: "node"
    args: ["/root/workspace/mcclawd-org/excalidraw-ai/src/server.js"]

Hermes neu starten → Werkzeuge erscheinen als mcp_excalidraw_ai_*.

Aufbau

• src/crypto.js — AES-GCM-E2E-Helfer (Node Web Crypto)

• src/elements.js — Element-Builder + Szenen-Zusammenführung/Diff (ID+Versions-Semantik)

• src/room.js — RoomClient: Socket-Beitritt, Lesen, Schreiben, Änderungs-Feed

• src/server.js — MCP-Server (Stdio), Werkzeug-Registrierung

• scripts/selftest.mjs, scripts/mcp-smoke.mjs — Verifizierung