Excalidraw MCP Server

Excalidraw MCP Server, CLI & Agent Skill

Живой холст Excalidraw для агента: создает, правит и экспортирует диаграммы через MCP или CLI, видит свою работу по скриншотам и сохраняет .excalidraw в репозит

MCP-сервер

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • Поднимает локальный сервер холста и открывает браузерный процесс для рендера и скриншотов
  • Читает и записывает файлы диаграмм в проекте, при вызове share выгружает зашифрованную сцену на excalidraw.com
Все причины и проверки

yctimlin/mcp_excalidraw

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/excalidraw-mcp-server-cli-agent-skill

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio excalidraw -- npx -y mcp-excalidraw-server

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"excalidraw","type":"stdio","command":"npx","args":["-y","mcp-excalidraw-server"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "excalidraw": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Выполните в терминале

codex mcp add excalidraw -- npx -y mcp-excalidraw-server

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.excalidraw]
command = "npx"
args = ["-y", "mcp-excalidraw-server"]

Если файл уже есть, допишите блок в конец.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "excalidraw": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-excalidraw-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 713706e.

Текст для агента

Добавь MCP-сервер: claude mcp add excalidraw --scope user -- npx -y mcp-excalidraw-server. Для агентов-программистов удобнее скилл: npx -y mcp-excalidraw-server install-skill --dir <каталог скиллов>. Открой http://127.0.0.1:3000 в браузере, чтобы работали скриншоты.

Другие способы из описания автора
claude mcp add excalidraw --scope user -- npx -y mcp-excalidraw-server

Холст стартует сам при первой команде рисования. Для скриншотов откройте http://127.0.0.1:3000.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект поднимает локальный холст Excalidraw и дает агенту управлять им поэлементно. Через 26 инструментов MCP или те же команды CLI агент создает, читает, меняет и удаляет фигуры, выравнивает и группирует их, снимает скриншот и получает текстовое описание сцены, чтобы поправить наложения и подписи. Диаграммы экспортируются в файлы .excalidraw и .excalidraw.md, которые можно закоммитить рядом с кодом и открыть на excalidraw.com или в плагине Obsidian. Есть конвертация из Mermaid, именованные снимки сцены и опциональная выгрузка зашифрованной сцены по ссылке. Холст работает локально на Node без ключей API, по умолчанию слушает только 127.0.0.1.

Для кого. Для разработчиков и технических писателей, которым нужны редактируемые диаграммы в репозитории, собранные агентом.

Подходит, если

  • Нужна редактируемая архитектурная схема или блок-схема, которую агент дорабатывает по скриншотам
  • Нужно хранить диаграммы как артефакты .excalidraw рядом с кодом и обновлять их вместе с ним
  • Нужно перегнать диаграмму из Mermaid в холст Excalidraw

Не подходит, если

  • Нужна одноразовая картинка из одного промпта без правок, а не постоянный холст
  • Нельзя запускать локальный сервер и открывать вкладку браузера, которая нужна для скриншотов и Mermaid

Пример запроса к агенту

Нарисуй схему архитектуры этого сервиса на холсте Excalidraw и сохрани ее в docs/architecture.excalidraw

Ограничения

Холст хранит элементы в памяти, после перезапуска сервера сцена очищается, для сохранения используйте export или snapshot. Скриншоты и конвертация из Mermaid требуют открытой вкладки браузера с холстом. Нужен Node 20 или новее. У сервера холста нет встроенной аутентификации, при выносе за 127.0.0.1 нужен внешний контроль доступа. Это независимый проект, а не официальный MCP от Excalidraw. Лицензия MIT.

Как отключить. Удалите запись excalidraw из конфигурации MCP клиента, например claude mcp remove excalidraw. Если ставили скилл, удалите папку excalidraw-skill из каталога скиллов.

MCP

Транспорт
stdio
Авторизация
не нужна
Переменные окружения
Переменные окружения
EXPRESS_SERVER_URL
Адрес сервера холста, по умолчанию http://127.0.0.1:3000
ENABLE_CANVAS_SYNC
Синхронизация холста в реальном времени, по умолчанию включена
EXCALIDRAW_NO_AUTOSTART
Значение 1 отключает автозапуск сервера холста
EXCALIDRAW_EXPORT_DIR
Базовый каталог, куда MCP может записывать экспорт

Проверка безопасности

  • Поднимает локальный сервер холста и открывает браузерный процесс для рендера и скриншотов
  • Читает и записывает файлы диаграмм в проекте, при вызове share выгружает зашифрованную сцену на excalidraw.com

Коротко о 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.

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

Это официальный MCP от Excalidraw?

Нет. У Excalidraw есть свой официальный MCP, а это независимый проект: он дает не одноразовый виджет, а постоянный холст с поэлементным управлением, скриншотами и экспортом файлов.

Нужны ли ключи API?

Нет. Рисование работает локально на Node без ключей. По ссылке выгружается только зашифрованная сцена, если вы сами вызовете share.

Официальный

Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели

MCP-серверСредний рискБез VPN187,4 тыс.Звезды репозитория
Выбор редакции

Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills

СкиллСредний риск178,8 тыс.Звезды репозитория
Выбор редакции

Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями

СкиллСредний риск56,8 тыс.Звезды репозитория
Выбор редакции

Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов

СкиллСредний рискБез VPN42,6 тыс.Звезды репозитория
Foxx AIExcalidraw MCP Server

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.