Excalidraw MCP Server
Excalidraw MCP Server, CLI & Agent Skill
Живой холст Excalidraw для агента: создает, правит и экспортирует диаграммы через MCP или CLI, видит свою работу по скриншотам и сохраняет .excalidraw в репозит
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Поднимает локальный сервер холста и открывает браузерный процесс для рендера и скриншотов
- Читает и записывает файлы диаграмм в проекте, при вызове share выгружает зашифрованную сцену на excalidraw.com
Установка
В терминале, через 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/mcp.json, для всех проектов
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": [
"-y",
"mcp-excalidraw-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
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.
Добавь 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 для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов