kroki-mcp

MCP server wrapping a self-hosted Kroki instance, exposing diagram rendering as MCP tools.

Supports 29+ diagram types including PlantUML, Mermaid, GraphViz, D2, DBML, ERD, and more. See Kroki's diagram support list for the full list.

Quick start

# 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

Configuration

Tools

render_diagram

Render a diagram using Kroki.

Parameters:

• diagram_type — diagram language (e.g. "plantuml", "mermaid", "graphviz")

• source — diagram source code

• output_format — "svg" (default) or "png"

• as_base64 — when true and format is PNG, return base64 string instead of MCP Image

list_diagram_types

List all supported diagram types and their output formats. Returns a JSON array.

Resources

kroki://health

Check if the Kroki instance is reachable. Returns JSON with status ("ok" or "unreachable").

Prompts

diagram_helper

Get syntax guidance and a basic example for a given diagram type, plus instructions to use render_diagram.

Parameter: diagram_type — e.g. "mermaid", "plantuml", "graphviz"

Authentication

The server supports bearer token and OIDC auth for HTTP transport:

See Authentication guide for full setup details.

Docker

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

See Docker deployment for volumes, UID/GID, and Traefik setup.

Development

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

License

MIT