excalidraw-mcp — MCP-сервер для Claude Code: диаграммы Excalidraw
MCP-сервер, через который агент создаёт узлы и связи в файле Excalidraw и читает состояние диаграммы. Пригодится, когда схему нужно править прямо из чата.
claude mcp add excalidraw-mcp -- npx -y @cmd8/excalidraw-mcpЧто делает excalidraw-mcp
Сервер даёт агенту четыре инструмента. createNode добавляет фигуру с подписью и возвращает её ID, createEdge соединяет два узла стрелкой — ссылаться можно на ID или на текст подписи. deleteElement убирает узел или связь, а getFullDiagramState отдаёт markdown-описание всей диаграммы: узлы, связи, подписи, фреймы и цвета.
Запускается через npx, поэтому нужен Node.js версии 18.0.0 или выше. При старте обязателен флаг -d, --diagram с путём к файлу .excalidraw — без него сервер не поднимется. Путь указывается один раз в конфиге, и дальше агент работает именно с этим файлом.
Подключение сводится к одной команде в терминале или к блоку JSON в настройках MCP у редактора. Для Claude это claude mcp add, для Codex — codex mcp add, для Gemini CLI — gemini mcp add. В Cursor, Windsurf, GitHub Copilot и VS Code сервер прописывается в конфиг вручную.
Какие задачи решает
- набросать схему сервиса из узлов и стрелок
- добавить подписанный блок в существующую диаграмму
- связать два узла по тексту подписи, не зная их ID
- прочитать текущее состояние диаграммы в виде markdown
- удалить лишний узел или связь по ID
Примеры запросов агенту
- Добавь в диаграмму узел «Очередь» и свяжи его с узлом «API»
- Покажи полное состояние диаграммы в markdown
- Удали связь между узлами «Клиент» и «Шлюз»
Как установить excalidraw-mcp
Командой платформы
claude mcp add excalidraw-mcp -- npx -y @cmd8/excalidraw-mcpКомандой платформы
codex mcp add excalidraw-mcp -- npx -y @cmd8/excalidraw-mcpФайл настроек
{
"mcpServers": {
"excalidraw-mcp": {
"command": "npx",
"args": [
"-y",
"@cmd8/excalidraw-mcp"
]
}
}
}Файл настроек
{
"servers": {
"excalidraw-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cmd8/excalidraw-mcp"
]
}
}
}Командой платформы
gemini mcp add excalidraw-mcp npx -y @cmd8/excalidraw-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о excalidraw-mcp
Как установить excalidraw-mcp в Claude Code?
Выполните claude mcp add excalidraw-mcp -- npx -y @cmd8/excalidraw-mcp. Путь к файлу диаграммы добавьте флагом --diagram.
Что делает excalidraw-mcp?
Позволяет агенту создавать узлы и стрелки в файле Excalidraw, удалять элементы и получать markdown-описание всей диаграммы.
Что нужно для запуска?
Node.js версии 18.0.0 или выше и путь к файлу .excalidraw, переданный через обязательный флаг -d, --diagram.
