kroki-mcp

MCP-Server, der eine selbst gehostete Kroki-Instanz umschließt und das Rendern von Diagrammen als MCP-Tools bereitstellt.

Unterstützt über 29 Diagrammtypen, darunter PlantUML, Mermaid, GraphViz, D2, DBML, ERD und mehr. Siehe Krokis Liste der unterstützten Diagramme für die vollständige Liste.

Schnellstart

# Set the Kroki instance URL
export KROKI_MCP_KROKI_URL=http://localhost:8000

# Install and run (stdio transport)
pip install kroki-mcp[mcp]
kroki-mcp serve

Related MCP server: project-scaffold

Konfiguration

Tools

render_diagram

Diagramm mit Kroki rendern.

Parameter:

• diagram_type — Diagrammsprache (z. B. "plantuml", "mermaid", "graphviz")

• source — Diagramm-Quellcode

• output_format — "svg" (Standard) oder "png"

• as_base64 — wenn true und das Format PNG ist, wird ein Base64-String anstelle eines MCP-Bildes zurückgegeben

list_diagram_types

Listet alle unterstützten Diagrammtypen und deren Ausgabeformate auf. Gibt ein JSON-Array zurück.

Ressourcen

kroki://health

Überprüft, ob die Kroki-Instanz erreichbar ist. Gibt JSON mit status ("ok" oder "unreachable") zurück.

Prompts

diagram_helper

Erhalten Sie Syntax-Anleitungen und ein grundlegendes Beispiel für einen bestimmten Diagrammtyp sowie Anweisungen zur Verwendung von render_diagram.

Parameter: diagram_type — z. B. "mermaid", "plantuml", "graphviz"

Authentifizierung

Der Server unterstützt Bearer-Token und OIDC-Authentifizierung für den HTTP-Transport:

Siehe Authentifizierungsleitfaden für vollständige Einrichtungsdetails.

Docker

export KROKI_MCP_KROKI_URL=http://kroki:8000
docker compose up -d

Siehe Docker-Bereitstellung für Volumes, UID/GID und Traefik-Einrichtung.

Entwicklung

uv sync --all-extras
uv run pytest
uv run ruff check src/ tests/
uv run mypy src/

Lizenz

MIT