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.
Настройка клиентов
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.