claude-mermaid

claude-mermaid — MCP-сервер сообщества (автор — veelenga). Рендер диаграмм Mermaid с живой перезагрузкой, темами и экспортом в SVG, PNG и PDF. Ставится через npx. Лицензия MIT.

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

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

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

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

mermaid_save записывает файл по указанному пути; локальный сервер предпросмотра на портах 3737–3747.

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

codex
{
    "code": "codex mcp add mermaid claude-mermaid",
    "lang": "bash",
    "notes": "Команда из README",
    "verified": "docs"
}

Что умеет

Claude Mermaid MCP Server рисует диаграммы Mermaid и показывает их в браузере с живой перезагрузкой: пока вы с ассистентом дорабатываете диаграмму, страница обновляется автоматически. Сервер создан для Claude Code, но работает с любым MCP-клиентом. В комплекте есть навык с лучшими практиками построения диаграмм.

Инструментов два:

  • mermaid_preview — отрисовывает диаграмму и открывает живой предпросмотр. Параметры: код диаграммы, идентификатор предпросмотра, формат (SVG, PNG или PDF), тема (default, forest, dark, neutral), цвет фона, максимальный размер и масштаб;
  • mermaid_save — сохраняет текущую диаграмму по указанному пути в SVG, PNG или PDF.

Другие возможности:

  • несколько предпросмотров одновременно — у каждой диаграммы свой идентификатор;
  • интерактивный просмотр: перемещение перетаскиванием, масштаб средствами браузера, сброс положения одной кнопкой;
  • скачивание из браузера в SVG или PNG;
  • рабочие файлы сохраняются в ~/.config/claude-mermaid/live;
  • отдельный режим галереи: claude-mermaid --serve открывает все ранее нарисованные диаграммы без ассистента.

Живая перезагрузка работает только для SVG; PNG и PDF отрисовываются без неё.

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

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

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

Установка

Рекомендуемый способ для Claude Code — плагин: /plugin marketplace add veelenga/claude-mermaid, затем /plugin install claude-mermaid@claude-mermaid и перезапуск; MCP-сервер настроится сам. Для других клиентов установите пакет из npm:

npm install -g claude-mermaid

Предпросмотр открывается по адресу http://localhost:3737/ с идентификатором диаграммы; сервер использует порты 3737–3747 и сам находит свободный. Журналы пишутся в ~/.config/claude-mermaid/logs/, подробный журнал включает переменная CLAUDE_MERMAID_LOG_LEVEL=DEBUG.

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

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

claude mcp add --scope user mermaid claude-mermaid

Для Cursor конфиг добавляют в .cursor/mcp.json. Тот же JSON README приводит для Windsurf, Cline и других клиентов.

Проверка

В Claude Code выполните /mcp — в списке серверов должен быть mermaid. Затем попросите нарисовать простую блок-схему: в браузере откроется предпросмотр.

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

Нарисуй блок-схему процесса авторизации в теме forest и сохрани в ./docs/flow.svg.
Сделай ER-диаграмму базы данных проекта и сохрани в PDF в ./docs/schema.pdf.

Риски

  • Запись файлов. mermaid_save записывает файл по любому указанному пути; проверяйте путь, чтобы не перезаписать нужный файл.
  • Локальный веб-сервер. Предпросмотр работает на портах 3737–3747 на вашем компьютере.
  • Рабочие файлы. Диаграммы и журналы хранятся в ~/.config/claude-mermaid/.

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

Работает ли сервер не только с Claude Code?

Да. README приводит настройки для Codex, Cursor, Cline, Windsurf, Gemini CLI и любых MCP-клиентов.

Почему PNG не обновляется сам?

Живая перезагрузка доступна только для SVG; PNG и PDF отрисовываются без неё.

Что делать, если порт занят?

Сервер сам перебирает порты 3737–3747. Проверить, кто их занимает, можно командой lsof -i :3737-3747.

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

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

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

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

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники