Excalidraw MCP Server
Excalidraw MCP Server, CLI & Agent Skill
Живой холст Excalidraw для агента: создает, правит и экспортирует диаграммы через MCP или CLI, видит свою работу по скриншотам и сохраняет .excalidraw в репозит
- 2 646 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Поднимает локальный сервер холста и открывает браузерный процесс для рендера и скриншотов
- Читает и записывает файлы диаграмм в проекте, при вызове share выгружает зашифрованную сцену на excalidraw.com
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/excalidraw-mcp-server-cli-agent-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Поднимает локальный сервер холста и открывает браузерный процесс для рендера и скриншотов
- Читает и записывает файлы диаграмм в проекте, при вызове share выгружает зашифрованную сцену на excalidraw.com
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект поднимает локальный холст Excalidraw и дает агенту управлять им поэлементно. Через 26 инструментов MCP или те же команды CLI агент создает, читает, меняет и удаляет фигуры, выравнивает и группирует их, снимает скриншот и получает текстовое описание сцены, чтобы поправить наложения и подписи. Диаграммы экспортируются в файлы .excalidraw и .excalidraw.md, которые можно закоммитить рядом с кодом и открыть на excalidraw.com или в плагине Obsidian. Есть конвертация из Mermaid, именованные снимки сцены и опциональная выгрузка зашифрованной сцены по ссылке. Холст работает локально на Node без ключей API, по умолчанию слушает только 127.0.0.1.
Для кого. Для разработчиков и технических писателей, которым нужны редактируемые диаграммы в репозитории, собранные агентом.
Подходит, если
- Нужна редактируемая архитектурная схема или блок-схема, которую агент дорабатывает по скриншотам
- Нужно хранить диаграммы как артефакты .excalidraw рядом с кодом и обновлять их вместе с ним
- Нужно перегнать диаграмму из Mermaid в холст Excalidraw
Не подходит, если
- Нужна одноразовая картинка из одного промпта без правок, а не постоянный холст
- Нельзя запускать локальный сервер и открывать вкладку браузера, которая нужна для скриншотов и Mermaid
Пример запроса к агенту
Нарисуй схему архитектуры этого сервиса на холсте Excalidraw и сохрани ее в docs/architecture.excalidrawMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
EXPRESS_SERVER_URL- Адрес сервера холста, по умолчанию http://127.0.0.1:3000
ENABLE_CANVAS_SYNC- Синхронизация холста в реальном времени, по умолчанию включена
EXCALIDRAW_NO_AUTOSTART- Значение 1 отключает автозапуск сервера холста
EXCALIDRAW_EXPORT_DIR- Базовый каталог, куда MCP может записывать экспорт
Ограничения
Холст хранит элементы в памяти, после перезапуска сервера сцена очищается, для сохранения используйте export или snapshot. Скриншоты и конвертация из Mermaid требуют открытой вкладки браузера с холстом. Нужен Node 20 или новее. У сервера холста нет встроенной аутентификации, при выносе за 127.0.0.1 нужен внешний контроль доступа. Это независимый проект, а не официальный MCP от Excalidraw. Лицензия MIT.
Как отключить. Удалите запись excalidraw из конфигурации MCP клиента, например claude mcp remove excalidraw. Если ставили скилл, удалите папку excalidraw-skill из каталога скиллов.
Частые вопросы
Это официальный MCP от Excalidraw?
Нет. У Excalidraw есть свой официальный MCP, а это независимый проект: он дает не одноразовый виджет, а постоянный холст с поэлементным управлением, скриншотами и экспортом файлов.
Нужны ли ключи API?
Нет. Рисование работает локально на Node без ключей. По ссылке выгружается только зашифрованная сцена, если вы сами вызовете share.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыExcalidraw Architect MCP хранит описание внутри редактируемой схемы: агент меняет структуру и повторно строит изображение.
Excalidraw CLI рисует файлы .excalidraw и диаграммы Mermaid в PNG и SVG локально, без аккаунта, и отдает JSON агентам.
Командная строка excalidraw-cli превращает текстовое описание, JSON или Graphviz DOT в редактируемую схему Excalidraw и экспортирует PNG и SVG
Официальный MCP-сервер draw.io: агент строит диаграммы из XML или Mermaid и открывает их в редакторе draw.io
Скилл рисует диаграмму в стиле Excalidraw по текстовому запросу и отдает ссылку на редактор, анимацию и PNG.
Плагин Codex перерисовывает научный рисунок по образцу на живом холсте draw.io шаг за шагом, затем проверяет файл и экспортирует PNG, SVG, PDF или JPG
Коротко о README
README представляет mcp-excalidraw-server как живой холст Excalidraw для агентов с тремя способами управления: скилл и CLI для агентов-программистов, MCP-сервер с 26 инструментами по stdio и REST API для своих фреймворков. Ядро работает локально на Node 20 и старше без ключей API, холст стартует сам при первой команде рисования. Агент может видеть сцену через describe и screenshot, выравнивать и группировать элементы, делать снимки и экспортировать файлы .excalidraw, в том числе в формате плагина Obsidian. Версия 2.0 добавляет протокол MCP 2026-07-28, стабильные по байтам экспорты и корректный рендер подписей. Лицензия MIT.