excalidraw-ai — Servidor MCP (interfaz de IA para Excalidraw)

La interfaz limpia y sin complicaciones para que una IA lea, observe y edite una sala de Excalidraw en vivo. En lugar de automatización del navegador (lectura de fibra + arrastrar y soltar + gotas del navegador remoto), se une a la sala como un socket-bot a través del relé de colaboración y habla directamente el protocolo de escena cifrado con AES-GCM — determinista, sin cabeza, escalable.

Estado de POC: puente central + superficie MCP stdio funcionando de extremo a extremo contra un relé excalidraw-room auto-alojado (selftest + prueba de humo MCP pasan).

Por qué un relé que controlamos

El bot se comunica con un relé. El relé alojado de Excalidraw (oss-collab.excalidraw.com) protege por origen a los bots que no son navegadores (403/400), por lo que para nuestras propias salas ejecutamos excalidraw/excalidraw-room (MIT, mismo código que producción) y apuntamos una interfaz de Excalidraw hacia él mediante VITE_APP_WS_SERVER_URL.

Related MCP server: Excalidraw MCP Server

Arquitectura

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

Herramientas

Ejecutar

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

Conectar con Hermes (~/.hermes/config.yaml)

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

Reiniciar Hermes → las herramientas aparecen como mcp_excalidraw_ai_*.

Estructura

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

• src/elements.js — constructores de elementos + fusión/diferencia de escena (semántica de id+versión)

• src/room.js — RoomClient: unión de socket, lectura, escritura, flujo de cambios

• src/server.js — servidor MCP (stdio), registro de herramientas

• scripts/selftest.mjs, scripts/mcp-smoke.mjs — verificación