Repolode
yctimlin

yctimlin/mcp_excalidraw

MCP-сервер, CLI и навык для агентов: дают AI-агентам разработки доступ к живому холсту Excalidraw, где можно рисовать, делать скриншоты, редактировать и экспортировать схемы.

Звёзды
2,625
Форки
295
Открытые issues
42
Последний коммит
8 дней назад

Что это?

mcp-excalidraw-server позволяет AI-агентам программно создавать и редактировать схемы Excalidraw на живом локальном холсте. Агент может добавлять, искать, обновлять и удалять отдельные элементы, упорядочивать их с помощью выравнивания, распределения и группировки, а также проверять результат по текстовому описанию сцены или отрендеренному скриншоту.

Управлять одним и тем же холстом можно тремя способами: через навык агента с CLI (рекомендуется для coding agents), MCP stdio-сервер с 26 инструментами для MCP-клиентов, таких как Claude Desktop, Cursor и Codex CLI, или обычный REST API. Сервер холста запускается автоматически при выполнении команды рисования; для основных операций не нужны API-ключи или аккаунты.

Схемы можно экспортировать в файлы .excalidraw, чтобы коммитить их вместе с кодом, или в файлы .excalidraw.md для хранилищ Obsidian. Скриншоты и экспорт в PNG/SVG выполняются без браузера, на Node, а преобразование Mermaid и управление областью просмотра по-прежнему требуют открытой вкладки браузера.

Ключевые возможности

  • 01Создание, чтение, обновление и удаление отдельных элементов на живом холсте Excalidraw.
  • 02Создание скриншотов и экспорт в PNG/SVG без браузера, чтобы агенты могли проверять собственные схемы.
  • 03Инструменты компоновки: выравнивание, распределение, группировка, блокировка и дублирование.
  • 04Именованные снимки состояния и восстановление для отката сцены.
  • 05Преобразование Mermaid в схему на холсте и зашифрованные ссылки для публикации на excalidraw.com.
  • 06Работа через CLI, MCP-сервер или REST API.

Сценарии использования

  • Создание схем архитектуры и блок-схем кодовой базы с помощью coding agent.
  • Экспорт схем .excalidraw в репозиторий, чтобы они версионировались вместе с кодом.
  • Создание схем и работа с ними внутри хранилища Obsidian.
  • Рендеринг закоммиченных файлов .excalidraw в PNG в CI без запуска браузера.

Быстрый старт

  1. 1

    Запустите сервер canvas с помощью npx

    npx -y mcp-excalidraw-server start
  2. 2

    Нарисуйте тестовую диаграмму с помощью CLI

    npx -y mcp-excalidraw-server describe
  3. 3

    Установите навык агента в каталог skills

    npx -y mcp-excalidraw-server install-skill --dir <skills-root>

Что важно знать

  • Для преобразования Mermaid необходимо открыть вкладку браузера с canvas.
  • Страница canvas загружает шрифты Excalidraw с CDN esm.sh.

В подборках

Темы

Частые вопросы

Что такое mcp_excalidraw?
MCP-сервер, CLI и навык для агентов: дают AI-агентам разработки доступ к живому холсту Excalidraw, где можно рисовать, делать скриншоты, редактировать и экспортировать схемы. mcp-excalidraw-server позволяет AI-агентам программно создавать и редактировать схемы Excalidraw на живом локальном холсте. Агент может добавлять, искать, обновлять и удалять отдельные элементы, упорядочивать их с помощью выравнивания, распределения и группировки, а также проверять результат по текстовому описанию сцены или отрендеренному скриншоту.
mcp_excalidraw можно использовать бесплатно? Какая у него лицензия?
mcp_excalidraw распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
mcp_excalidraw всё ещё поддерживается?
Активно поддерживается. Последний коммит в mcp_excalidraw — 30 окт. 2026 г..
Для чего можно использовать mcp_excalidraw?
Создание схем архитектуры и блок-схем кодовой базы с помощью coding agent. Экспорт схем .excalidraw в репозиторий, чтобы они версионировались вместе с кодом. Создание схем и работа с ними внутри хранилища Obsidian. Рендеринг закоммиченных файлов .excalidraw в PNG в CI без запуска браузера.
Как установить mcp_excalidraw?
Запустите сервер canvas с помощью npx: npx -y mcp-excalidraw-server start Нарисуйте тестовую диаграмму с помощью CLI: npx -y mcp-excalidraw-server describe Установите навык агента в каталог skills: npx -y mcp-excalidraw-server install-skill --dir <skills-root>
Где скачать mcp_excalidraw?
Исходный код и инструкции по установке — на GitHub: https://github.com/yctimlin/mcp_excalidraw

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Самостоятельно размещаемая доска Excalidraw с аккаунтами, командным пространством, папками, поиском и совместной работой в реальном времени; рисунки хранятся в вашем Postgres.

1086TypeScriptMITАктивно поддерживаетсяОбновлён 23 часа назад

Локальное веб-пространство: загружайте документы, обсуждайте их с ИИ и создавайте или дорабатывайте редактируемые архитектурные диаграммы на холсте Excalidraw.

162+2 за неделю12PythonApache-2.0Обновлён в прошлом месяце

Самохостируемое рабочее пространство для Excalidraw с коллекциями, совместным редактированием в реальном времени, шерингом, историей версий, бэкапами и входом через локальные аккаунты или OpenID Connect.

1,8 тыс.+60 за неделю188TypeScriptLGPL-3.0Обновлён 8 дней назад

Навык для AI-агентов, который помогает объяснять изменения в коде с помощью интерактивных диаграмм, где каждый элемент связан с исходным кодом.

238+61 за неделю9TypeScriptMITАктивно поддерживаетсяОбновлён вчера