A
licenseNot graded
qualityD
maintenanceProduction-ready MCP server starter with authentication, observability, and a plugin system for building and deploying MCP servers quickly.
MIT
Kroki MCP
by pvliesdonk
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kroki MCPcheck the current server health and configuration"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 serveRelated MCP server: project-scaffold
Configuration
Variable | Required | Default | Description |
| No |
| URL of your Kroki instance. Defaults to the public instance — not suitable for production (diagram source is sent to a third-party server). |
| No |
| Disable write tools |
| No |
| Log level ( |
| No |
| Server name shown to clients |
| No | (dynamic) | System instructions for LLM context |
Tools
render_diagram
Render a diagram using Kroki.
Parameters:
diagram_type— diagram language (e.g."plantuml","mermaid","graphviz")source— diagram source codeoutput_format—"svg"(default) or"png"as_base64— whentrueand 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:
Variable | Description |
| Static bearer token |
| Public server URL — required for OIDC (e.g. |
| OIDC discovery endpoint |
| OIDC client ID |
| OIDC client secret |
| JWT signing key — required on Linux/Docker to survive restarts |
See Authentication guide for full setup details.
Docker
export KROKI_MCP_KROKI_URL=http://kroki:8000
docker compose up -dSee 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
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessUnresponsive
Related MCP Connectors
A MCP server built for developers enabling Git based project management with project and personal…
Create, deploy, and operate MCP servers directly from your GitHub repositories.
An MCP server that provides Javelin Standalone Guardrails
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that scaffolds full-stack projects with consistent structure, Docker setup, CI/CD pipelines, and database configuration.6MIT
- FlicenseNot gradedqualityDmaintenanceA minimal, production-ready FastMCP server template with auto-discovery, YAML configuration, authentication, and a knowledgebase, enabling quick scaffolding of new MCP servers.-
- AlicenseNot gradedqualityCmaintenanceA production-ready MCP server template with OAuth 2.1, RBAC, and audit logging for building secure, observable tool servers.MIT