mermaid-skill MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Covers 10+ Mermaid diagram types
Local render via mmdc (PNG / SVG / PDF)
Automatic layout hints to avoid crossing edges
Iterates on diagrams based on feedback
Works inside your repo, diagrams committed alongside code

Live-Demo

In der Praxis

mermaid-skill.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mermaid-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/mermaid-skill",
        "~/.claude/skills/mermaid-skill"
      ],
      "_inferred": true
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mermaid-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/mermaid-skill",
        "~/.claude/skills/mermaid-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mermaid-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/mermaid-skill",
        "~/.claude/skills/mermaid-skill"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mermaid-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/mermaid-skill",
        "~/.claude/skills/mermaid-skill"
      ],
      "_inferred": true
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mermaid-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/mermaid-skill",
        "~/.claude/skills/mermaid-skill"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mermaid-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Agents365-ai/mermaid-skill",
          "~/.claude/skills/mermaid-skill"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add mermaid-skill -- git clone https://github.com/Agents365-ai/mermaid-skill ~/.claude/skills/mermaid-skill

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: mermaid-skill

Draw an architecture diagram for your current project

👤 Devs writing docs, ADRs, or onboarding guides ⏱ ~20 min beginner

Wann einsetzen: You keep explaining your architecture in Slack and want a picture.

Voraussetzungen

mmdc installed — npm i -g @mermaid-js/mermaid-cli
Skill installed — git clone https://github.com/Agents365-ai/mermaid-skill ~/.claude/skills/mermaid-skill

Ablauf

Describe the system

Use mermaid-skill. Draw a flowchart of our service: client → API gateway → (auth / orders / payments) → Postgres / Redis / Stripe.✓ Kopiert

→ .mmd source with meaningful node names, rendered to PNG in docs/
Add details

Add labels on each edge showing the protocol (HTTPS, gRPC, TCP) and auth type.✓ Kopiert

→ Updated source and re-render
Commit it

Commit docs/architecture.mmd and its PNG.✓ Kopiert

→ git add and commit run

Ergebnis: A living diagram in the repo, not a stale slide in Confluence.

Fallstricke

Diagram becomes a maze of edges — Let Claude use subgraphs and direction hints; don't cram everything on one layer

Kombinieren mit: filesystem · git

Produce a sequence diagram while debugging

👤 Engineers tracing a cross-service bug ⏱ ~15 min beginner

Wann einsetzen: You're trying to understand an async interaction and English isn't cutting it.

Ablauf

Describe the flow

Use mermaid-skill. Sequence diagram: browser → SSR → auth service → session store → page render, with failure mode when session is stale.✓ Kopiert

→ Sequence diagram with the failure annotated
Annotate the bug

Highlight the line where the bug manifests.✓ Kopiert

→ Annotated box/note on the offending message

Ergebnis: A picture you can paste in the bug ticket.

Generate an ERD from your actual database schema

👤 Data engineers, backend devs ⏱ ~20 min intermediate

Wann einsetzen: You want a visual of your schema for a design review.

Ablauf

Introspect

Use mermaid-skill. Read the schema.sql (or query the live DB via postgres MCP) and produce a Mermaid ERD.✓ Kopiert

→ .mmd ERD with relationships and cardinalities
Trim noise

Drop audit tables and focus on the core domain entities.✓ Kopiert

→ Trimmed ERD

Ergebnis: An accurate ERD without manual drawing.

Fallstricke

Cardinalities wrong when inferred — Provide the actual foreign-key definitions; don't let the model guess

Kombinieren mit: postgres

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mermaid-skill + filesystem

Keep diagrams alongside the code they describe

For every service in services/, add a docs/architecture.mmd and render it.✓ Kopiert

mermaid-skill + postgres

Auto-generate ERDs from live databases

Connect to the staging DB and render its schema as a Mermaid ERD.✓ Kopiert

mermaid-skill + git

Diagram stays versioned with code changes

Commit updated diagrams in the same PR as the code changes they describe.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
write_mermaid	description, diagram type	Any diagram request	0
render_mmdc	.mmd path, output format	After source is final	local mmdc
iterate_diagram	current diagram + feedback	Reviewer feedback	0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: None
Tokens pro Aufruf: Small — Mermaid source is compact
Kosten in €: Free (mmdc is open source)
Tipp: For big diagrams, generate subgraphs separately to avoid retrying large rewrites.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: None

Datenabfluss: None from skill itself

Fehlerbehebung

Häufige Fehler und Lösungen

mmdc not found

Install globally: npm i -g @mermaid-js/mermaid-cli

Prüfen: which mmdc

Render fails with syntax error

Mermaid has version-specific syntax; run mmdc --version and match the skill's assumed version

Prüfen: mmdc --version

Diagram is a mess of crossing edges

Add direction hints (TD/LR), group with subgraphs, or split into multiple diagrams

Alternativen

mermaid-skill vs. andere

Alternative	Wann stattdessen	Kompromiss
PlantUML / draw.io	You need more control or non-Mermaid syntax	More setup, different rendering toolchain
paperbanana-skill	Academic publication-quality diagrams	Heavier; different aesthetic goals

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen