Excalidraw Architect

Excalidraw Architect — MCP-сервер сообщества (автор — BV-Venky). Генерация архитектурных диаграмм Excalidraw с автоматической раскладкой и стилями компонентов. Ставится через pip или через uvx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
BV-Venky
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
linux, macos, windows
Языки
python

Уровень риска: high

Создаёт и перезаписывает файлы диаграмм и экспорта на диске.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"excalidraw-architect\": {\n      \"command\": \"excalidraw-architect-mcp\",\n      \"transport\": \"stdio\"\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Excalidraw Architect MCP — сервер, который генерирует для инженерной документации диаграммы в рисованном стиле Excalidraw. Главная идея — разделить «что» и «где»: модель описывает структуру (компоненты, участники, уровни, точки данных), а движок сам выбирает алгоритм раскладки, оформляет диаграмму и записывает настоящий файл .excalidraw, который можно открыть и дальше править вручную. Модели не нужно придумывать координаты, поэтому блоки не наезжают друг на друга.

Возможности по README:

  • 25 типов диаграмм с единой грамматикой: архитектура и блок-схемы, деревья, оргструктуры, конечные автоматы, ER-модели, слои, swimlane, процессы, потоки данных, диаграммы последовательностей, таймлайны, квадранты, пирамиды и воронки, диаграммы Венна, циклы, диаграммы Ганта, а также рисованные столбчатые, линейные и точечные графики.
  • Настоящий рисованный стиль — порт генератора штрихов roughjs на чистом Python, поэтому экспорт в SVG и PNG выглядит как холст Excalidraw.
  • Аккуратная раскладка — алгоритм Сугиямы с адаптивными отступами для графов и своя геометрия для остальных типов.
  • Оформление с учётом технологий — более 50 технологий (Kafka, PostgreSQL, Redis и другие) получают узнаваемый стиль узлов.
  • Правка обычными словами — спецификация хранится внутри файла, поэтому любую диаграмму можно дополнить или перестроить через modify_diagram.
  • Экспорт в SVG и PNG без браузера и Node.js.
  • Граф знаний об архитектуре по желанию — версионируемая модель системы, которую ИИ может запрашивать и проверять.

Основные инструменты: create_diagram, modify_diagram, list_diagram_types (подсказки, когда какой тип выбрать) и get_diagram_schema (точная форма спецификации).

Кому подойдёт

  • Разработчикам, осваивающим новую кодовую базу: архитектурная схема сервиса и диаграмма последовательности для ключевого сценария.
  • Авторам дизайн-документов и RFC: схемы, автоматы состояний и диаграммы Ганта в одном визуальном стиле.
  • Дежурным инженерам: таймлайны и диаграммы последовательности для разборов инцидентов.

Похожие серверы — в категории дизайн.

Установка

Установите пакет: pip install excalidraw-architect-mcp; для экспорта в PNG — pip install excalidraw-architect-mcp[png] (SVG работает сразу). Без установки можно запустить через uvx excalidraw-architect-mcp. В репозитории есть навыки для Claude Code и Cursor, которые учат ИИ выбирать тип диаграммы и не перегружать её; те же подсказки сервер отдаёт через list_diagram_types.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "excalidraw-architect": {
      "command": "excalidraw-architect-mcp",
      "transport": "stdio"
    }
  }
}

Для Cursor добавьте блок в .cursor/mcp.json. В Claude Code вместо команды можно добавить вручную .mcp.json в корень проекта. Для Windsurf и других редакторов схема та же: команда excalidraw-architect-mcp по stdio.

Проверка

Попросите: «Нарисуй процесс ревью пул-реквеста в виде swimlane» — в папке должен появиться файл .excalidraw.

Примеры задач

Нарисуй архитектуру интернет-магазина: веб-приложение, API, PostgreSQL, Redis и Kafka.
Сделай диаграмму последовательности авторизации платежа и сохрани её в docs/checkout.excalidraw.

Риски

  • Запись файлов. Сервер создаёт и перезаписывает файлы .excalidraw, SVG и PNG по путям, которые укажет ИИ.
  • Чтение файлов. Для правки сервер читает существующие диаграммы.
  • Сетевого доступа и ключей API сервер по README не требует.

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

Чем лучше Mermaid?

Диаграмму Excalidraw можно перетаскивать, группировать и подписывать вручную, а стиль одинаков для всех 25 типов.

Нужен ли браузер для экспорта?

Нет, экспорт в SVG и PNG работает без браузера и Node.js.

Можно ли править готовую диаграмму?

Да, спецификация хранится в файле, и modify_diagram меняет её по описанию.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Figma MCP Server

Официальный удалённый MCP-сервер Figma: код по макетам, переменные, Code Connect и запись в макет.

Риск: high Лицензия: NOASSERTION ★ 2 209

Framelink MCP for Figma

Локальный MCP-сервер сообщества для Figma: данные макета для вёрстки по ссылке, работает с вашим токеном.

Риск: medium Лицензия: MIT ★ 16 252

Next AI Draw.io

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

Риск: high Лицензия: Apache-2.0 ★ 36 735

designlang

Измеряет дизайн-систему сайта и проверяет интерфейс на соответствие бренду.

Риск: medium Лицензия: MIT ★ 4 785

Источники