MCP Mermaid
MCP-сервер для генерации mermaid-диаграмм и графиков с проверкой синтаксиса и экспортом в svg, png и файл
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Может писать png-файлы на диск
- Режимы ссылок отправляют диаграмму на внешний сервис mermaid.ink
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-mermaidОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio mcp-mermaid -- npx -y mcp-mermaidИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"mcp-mermaid","type":"stdio","command":"npx","args":["-y","mcp-mermaid"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"mcp-mermaid": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add mcp-mermaid -- npx -y mcp-mermaidИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.mcp-mermaid]
command = "npx"
args = ["-y", "mcp-mermaid"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"mcp-mermaid": {
"type": "local",
"command": [
"npx",
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавь MCP-сервер в клиент с командой npx -y mcp-mermaid. Для http-режима поставь пакет глобально через npm install -g mcp-mermaid и запусти mcp-mermaid -t sse или -t streamable.
Другие способы из описания автора
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": ["-y", "mcp-mermaid"]
}
}
}Универсальный фрагмент для настольных клиентов. На Windows оберните запуск через cmd /c.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту генерацию диаграмм на синтаксисе mermaid: блок-схемы, последовательности, отношения и другие типы. Можно задавать фон и тему, чтобы модель выдавала оформленные диаграммы. Результат отдается как base64, svg, исходный mermaid, файл на диске или ссылка на svg и png. Есть проверка синтаксиса, чтобы модель могла в несколько шагов исправить ошибку и получить корректную схему. Поддерживает транспорт stdio, sse и streamable-http, есть образ Docker.
Для кого. Для разработчиков, технических писателей и продактов, которым нужны схемы прямо из агента.
Подходит, если
- Нужно построить блок-схему или диаграмму последовательности по описанию
- Нужно получить диаграмму как svg, png или файл
- Нужна проверка синтаксиса mermaid перед вставкой в документ
Не подходит, если
- Нужны диаграммы в формате, который mermaid не поддерживает
- Нельзя выпускать данные наружу, а нужен режим ссылки через mermaid.ink
Пример запроса к агенту
Собери блок-схему процесса регистрации и верни ее как svg-файл со светлой темойОграничения
Диаграммы ограничены синтаксисом mermaid. Режимы svg_url и png_url делают публичные ссылки через mermaid.ink, для чувствительных схем берите base64, svg или файл. Режим outputType file сохраняет png на диск. Транспорты sse и streamable поднимают локальные порты, по умолчанию 3033 и 1122.
Как отключить. Уберите запись сервера из конфигурации MCP-клиента. При глобальной установке удалите пакет mcp-mermaid своим менеджером пакетов.
MCP
- Транспорт
- stdio, sse, http
- Авторизация
- не нужна
Проверка безопасности
- Может писать png-файлы на диск
- Режимы ссылок отправляют диаграмму на внешний сервис mermaid.ink
Коротко о README
README показывает конфигурацию для настольных клиентов через npx, отдельно для macOS и Windows, и запуск с транспортом sse или streamable после глобальной установки. Перечислены форматы вывода, опции CLI по транспорту, порту и эндпоинту, а также запуск через Docker. Упомянуты родственные проекты mcp-server-chart и Infographic. Лицензия MIT.
Частые вопросы
В каких форматах возвращается диаграмма?
base64, svg, исходный mermaid, файл на диске, а также ссылки svg_url и png_url через mermaid.ink.
Проверяет ли сервер синтаксис?
Да, есть валидация mermaid, чтобы модель могла исправить ошибку за несколько шагов.
Похожие
Утилита 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, воронки и еще около сорока типов