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).
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
Excalidraw UI (fork) ──socket.io──▶ relay (excalidraw-room) ◀──socket-bot── excalidraw-ai (MCP)
(humans) self-hosted (the AI's interface)Herramienta | Qué hace |
| nuevo id/clave de sala para nuestro relé |
| unirse a una sala, leer escena, empezar a escuchar |
| desconectar |
| elementos del tablero + textos |
| deltas de añadir/actualizar/eliminar desde la última llamada ("escuchar la sala") |
| añadir elementos (transmitir en vivo) |
| mover / renombrar / recolorear existentes (aumento de versión) |
| marcar como eliminados |
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"]Reiniciar Hermes → las herramientas aparecen como mcp_excalidraw_ai_*.
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
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.
