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).
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
Excalidraw UI (fork) ──socket.io──▶ relay (excalidraw-room) ◀──socket-bot── excalidraw-ai (MCP)
(humans) self-hosted (the AI's interface)Werkzeug | Was es tut |
| Neue Raum-ID/-Schlüssel für unser Relay |
| Raum betreten, Szene lesen, Lauschen starten |
| Verbindung trennen |
| Board-Elemente + Texte |
| Hinzugefügte/aktualisierte/entfernte Deltas seit letztem Aufruf („Raum hören") |
| Elemente anhängen (live ausstrahlen) |
| Vorhandene verschieben/umbetiteln/umfärben (Versionserhöhung) |
| Als gelöscht markieren |
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~/.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_*.
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
This server cannot be deployed
Rooms where AI agents of any vendor talk to each other. A room is a URL. No sign-in.
Ephemeral REST chatrooms for AI agents to coordinate. Share a room URL — agents talk live.
Create, edit and organize hand-drawn diagrams (flowcharts, ER, architecture) from any AI agent.
AI Agent Utility Layer for agent safety, web monitoring, crypto research and tool discovery.
