MCP Mermaid

Динамическая генерация mermaid диаграмм и графиков с помощью AI MCP. Вы также можете использовать:

• mcp-server-chart для создания диаграмм, графиков и карт.

• Infographic для создания инфографики, такой как Timeline, Comparison, List, Process и т.д.

• 🖼️ figure.ling.pub/gallery для просмотра и обмена сгенерированными ИИ диаграммами и рисунками, созданными с помощью mcp-mermaid и других инструментов.

✨ Возможности

• Полная поддержка всех функций и синтаксиса Mermaid.

• Поддержка конфигурации backgroundColor и theme, что позволяет крупным языковым моделям выводить богатые стилистические настройки.

• Поддержка экспорта в форматы base64, svg, mermaid, file, а также удобные для удаленного использования форматы svg_url и png_url, с проверкой Mermaid для облегчения многоэтапного вывода правильного синтаксиса и графики моделью. Используйте outputType: "file" для автоматического сохранения PNG-диаграмм на диск для AI-агентов или режимы URL для обмена диаграммами через публичные ссылки mermaid.ink.

Related MCP server: Mermaid-MCP

🤖 Использование

Для использования с Desktop APP, такими как Claude, VSCode, Cline, Cherry Studio и другими, добавьте конфигурацию MCP-сервера ниже. В системе Mac:

{
  "mcpServers": {
    "mcp-mermaid": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mermaid"
      ]
    }
  }
}

В системе Windows:

{
  "mcpServers": {
    "mcp-mermaid": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-mermaid"
      ]
    }
  }
}

Также вы можете использовать его на aliyun, modelscope, glama.ai, smithery.ai или других платформах с протоколами HTTP и SSE.

Точки доступа:

• SSE: http://localhost:3033/sse

• Streamable: http://localhost:1122/mcp

Доступные теги Docker:

• susuperli/mcp-mermaid:latest - Последняя стабильная версия

• Просмотреть все доступные теги можно на Docker Hub

🚰 Запуск с транспортом SSE или Streamable

Вариант 1: Глобальная установка

Установите пакет глобально:

npm install -g mcp-mermaid

Запустите сервер с предпочтительным вариантом транспорта:

# For SSE transport (default endpoint: /sse)
mcp-mermaid -t sse

# For Streamable transport with custom endpoint
mcp-mermaid -t streamable

Вариант 2: Локальная разработка

Если вы работаете с исходным кодом локально:

# Clone and setup
git clone https://github.com/hustcc/mcp-mermaid.git
cd mcp-mermaid
npm install
npm run build

# Run with npm scripts
npm run start:sse        # SSE transport on port 3033
npm run start:streamable # Streamable transport on port 1122

Точки доступа

Затем вы можете получить доступ к серверу по адресу:

• Транспорт SSE: http://localhost:3033/sse

• Транспорт Streamable: http://localhost:1122/mcp (локально) или http://localhost:3033/mcp (глобально)

🎮 Опции CLI

Вы также можете использовать следующие опции CLI при запуске MCP-сервера. Опции команды можно посмотреть, запустив CLI с флагом -h.

MCP Mermaid CLI

Options:
  --transport, -t  Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
  --port, -p       Specify the port for SSE or streamable transport (default: 3033)
  --endpoint, -e   Specify the endpoint for the transport:
                    - For SSE: default is "/sse"
                    - For streamable: default is "/mcp"
  --help, -h       Show this help message

🔨 Разработка

Установите зависимости:

npm install

Соберите сервер:

npm run build

Запуск MCP-сервера

Использование MCP Inspector (для отладки):

npm run start

Использование различных транспортных протоколов:

# SSE transport (Server-Sent Events)
npm run start:sse

# Streamable HTTP transport
npm run start:streamable

Прямые команды node:

# SSE transport on port 3033
node build/index.js --transport sse --port 3033

# Streamable HTTP transport on port 1122
node build/index.js --transport streamable --port 1122

# STDIO transport (for MCP client integration)
node build/index.js --transport stdio

🐳 Использование Docker

Запустите MCP Mermaid с помощью Docker:

# Pull the image
docker pull susuperli/mcp-mermaid:latest

# Run with SSE transport (default)
docker run -p 3033:3033 susuperli/mcp-mermaid:latest --transport sse

# Run with streamable transport
docker run -p 1122:1122 susuperli/mcp-mermaid:latest --transport streamable --port 1122

📄 Лицензия

MIT@hustcc.