Skip to main content
Glama

excalidraw-ai — MCP server (AI интерфейс к Excalidraw)

Чистый, ненавязчивый интерфейс для AI, чтобы читать, наблюдать и редактировать живую комнату Excalidraw. Вместо автоматизации браузера (fiber-read + drag-drop + remote browser drops), он подключается к комнате как socket-bot через коллаборационный ретранслятор и напрямую говорит на AES-GCM-зашифрованном протоколе сцены — детерминированный, безголовый, масштабируемый.

Статус POC: ядро моста + MCP stdio поверхность работают end-to-end против самостоятельно размещенного ретранслятора excalidraw-room (selftest + MCP smoke pass).

Почему ретранслятор, который мы контролируем

Бот общается с ретранслятором. Хостируемый ретранслятор Excalidraw (oss-collab.excalidraw.com) защищает от не-браузерных ботов (403/400), поэтому для наших собственных комнат мы запускаем excalidraw/excalidraw-room (MIT, тот же код, что и в продакшене) и направляем на него интерфейс Excalidraw через 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)

Инструменты

Tool

Что делает

create_room

новый id/ключ комнаты для нашего ретранслятора

join_room

присоединиться к комнате, прочитать сцену, начать прослушивание

leave_room

отключиться

get_scene

элементы доски + тексты

get_changes

дельты добавления/обновления/удаления с последнего вызова ("слышать комнату")

add_elements

добавить элементы (транслировать в реальном времени)

update_elements

переместить / переименовать / перекрасить существующие (увеличение версии)

delete_elements

отметить как удаленные

Запуск

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 (~/.hermes/config.yaml)

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

Перезапустите Hermes → инструменты появятся как mcp_excalidraw_ai_*.

Структура

  • src/crypto.js — AES-GCM E2E помощники (Node Web Crypto)

  • src/elements.js — построители элементов + слияние/различие сцены (семантика id+версия)

  • src/room.js — RoomClient: сокетное подключение, чтение, запись, поток изменений

  • src/server.js — MCP server (stdio), регистрация инструментов

  • scripts/selftest.mjs, scripts/mcp-smoke.mjs — проверка

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    F
    maintenance
    Enables AI agents to programmatically control a live Excalidraw canvas through element-level CRUD operations and real-time synchronization. It allows agents to iteratively build, inspect, and refine diagrams while providing visual feedback via screenshots and scene descriptions.
    1,730
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Enables AI agents to programmatically control a live Excalidraw canvas with element-level CRUD operations and real-time synchronization. It supports iterative diagramming through scene descriptions, screenshots, and advanced layout tools for collaborative AI-human workflows.
    1,730
    MIT

View all related MCP servers

Related MCP Connectors

  • Ephemeral REST chatrooms for AI agents to coordinate. Share a room URL — agents talk live.

  • Real-time collaborative whiteboard — AI agents and humans edit the same board live over MCP.

  • Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/McClawdDigital/excalidraw-ai'

If you have feedback or need assistance with the MCP directory API, please join our Discord server