MCP Mermaid

Generieren Sie mermaid-Diagramme und -Charts dynamisch mit AI MCP. Sie können auch Folgendes verwenden:

• mcp-server-chart zum Generieren von Charts, Graphen und Karten.

• Infographic zum Generieren von Infografiken, wie z. B. Timeline, Comparison, List, Process usw.

• 🖼️ figure.ling.pub/gallery zum Durchsuchen und Teilen von KI-generierten Diagrammen und Abbildungen, die mit mcp-mermaid und anderen Tools erstellt wurden.

✨ Funktionen

• Volle Unterstützung aller Funktionen und der Syntax von Mermaid.

• Unterstützung der Konfiguration von backgroundColor und theme, wodurch große KI-Modelle reichhaltige Stilkonfigurationen ausgeben können.

• Unterstützung des Exports in die Formate base64, svg, mermaid, file sowie remote-freundliche svg_url- und png_url-Formate, mit Validierung für Mermaid, um die korrekte Syntax- und Grafikausgabe des Modells über mehrere Runden hinweg zu erleichtern. Verwenden Sie outputType: "file", um PNG-Diagramme automatisch für KI-Agenten auf der Festplatte zu speichern, oder die URL-Modi, um Diagramme über öffentliche mermaid.ink-Links zu teilen.

Related MCP server: Mermaid-MCP

🤖 Verwendung

Um es mit einer Desktop-App wie Claude, VSCode, Cline, Cherry Studio usw. zu verwenden, fügen Sie die unten stehende MCP-Server-Konfiguration hinzu. Auf dem Mac-System:

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

Auf dem Windows-System:

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

Sie können es auch auf Aliyun, Modelscope, Glama.ai, Smithery.ai oder anderen mit HTTP- oder SSE-Protokoll verwenden.

Zugriffspunkte:

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

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

Verfügbare Docker-Tags:

• susuperli/mcp-mermaid:latest - Neueste stabile Version

• Alle verfügbaren Tags finden Sie unter Docker Hub

🚰 Ausführung mit SSE- oder Streamable-Transport

Option 1: Globale Installation

Installieren Sie das Paket global:

npm install -g mcp-mermaid

Starten Sie den Server mit der von Ihnen bevorzugten Transportoption:

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

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

Option 2: Lokale Entwicklung

Wenn Sie lokal mit dem Quellcode arbeiten:

# 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

Zugriffspunkte

Anschließend können Sie auf den Server zugreifen unter:

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

• Streamable-Transport: http://localhost:1122/mcp (lokal) oder http://localhost:3033/mcp (global)

🎮 CLI-Optionen

Sie können auch die folgenden CLI-Optionen verwenden, wenn Sie den MCP-Server ausführen. Befehlsoptionen erhalten Sie durch Ausführen der CLI mit -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

🔨 Entwicklung

Abhängigkeiten installieren:

npm install

Server bauen:

npm run build

Starten des MCP-Servers

Verwendung des MCP-Inspektors (zum Debuggen):

npm run start

Verwendung verschiedener Transportprotokolle:

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

# Streamable HTTP transport
npm run start:streamable

Direkte Node-Befehle:

# 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-Verwendung

Führen Sie MCP Mermaid mit Docker aus:

# 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

📄 Lizenz

MIT@hustcc.