MCP Mermaid

Genera diagramas y gráficos mermaid con IA MCP de forma dinámica. También puedes usar:

• mcp-server-chart para generar gráficos, diagramas y mapas.

• Infographic para generar infografías, como Timeline, Comparison, List, Process y más.

• 🖼️ figure.ling.pub/gallery para explorar y compartir diagramas y figuras generadas por IA creadas con mcp-mermaid y otras herramientas.

✨ Características

• Soporte completo para todas las funciones y sintaxis de Mermaid.

• Soporte para la configuración de backgroundColor y theme, permitiendo que los modelos de IA grandes generen configuraciones de estilo enriquecidas.

• Soporte para exportar a formatos base64, svg, mermaid, file, y formatos amigables para acceso remoto svg_url, png_url, con validación para Mermaid para facilitar la salida de sintaxis y gráficos correctos por parte del modelo en múltiples rondas. Usa outputType: "file" para guardar automáticamente diagramas PNG en el disco para agentes de IA, o los modos URL para compartir diagramas a través de enlaces públicos de mermaid.ink.

Related MCP server: Mermaid-MCP

🤖 Uso

Para usar con una Desktop APP, como Claude, VSCode, Cline, Cherry Studio, etc., añade la configuración del servidor MCP a continuación. En sistemas Mac:

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

En sistemas Windows:

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

También puedes usarlo en aliyun, modelscope, glama.ai, smithery.ai u otros con protocolo HTTP o SSE.

Puntos de acceso:

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

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

Etiquetas de Docker disponibles:

• susuperli/mcp-mermaid:latest - Última versión estable

• Ver todas las etiquetas disponibles en Docker Hub

🚰 Ejecutar con transporte SSE o Streamable

Opción 1: Instalación global

Instala el paquete globalmente:

npm install -g mcp-mermaid

Ejecuta el servidor con tu opción de transporte preferida:

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

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

Opción 2: Desarrollo local

Si estás trabajando con el código fuente localmente:

# 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

Puntos de acceso

Luego puedes acceder al servidor en:

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

• Transporte Streamable: http://localhost:1122/mcp (local) o http://localhost:3033/mcp (global)

🎮 Opciones de CLI

También puedes usar las siguientes opciones de CLI al ejecutar el servidor MCP. Opciones de comando ejecutando la CLI con -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

🔨 Desarrollo

Instala las dependencias:

npm install

Compila el servidor:

npm run build

Iniciar el servidor MCP

Usando MCP Inspector (para depuración):

npm run start

Usando diferentes protocolos de transporte:

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

# Streamable HTTP transport
npm run start:streamable

Comandos directos de 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

🐳 Uso de Docker

Ejecuta MCP Mermaid con 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

📄 Licencia

MIT@hustcc.