Skip to main content
Glama
deeneskoru
pvliesdonk

Kroki MCP

by pvliesdonk
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

kroki-mcp

Servidor MCP que envuelve una instancia de Kroki autohospedada, exponiendo la renderización de diagramas como herramientas MCP.

Admite más de 29 tipos de diagramas, incluidos PlantUML, Mermaid, GraphViz, D2, DBML, ERD y más. Consulta la lista de soporte de diagramas de Kroki para ver la lista completa.

Inicio rápido

# 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

Configuración

Variable

Requerido

Predeterminado

Descripción

KROKI_MCP_KROKI_URL

No

https://kroki.io

URL de tu instancia de Kroki. El valor predeterminado es la instancia pública — no apta para producción (el código fuente del diagrama se envía a un servidor de terceros).

KROKI_MCP_READ_ONLY

No

true

Deshabilitar herramientas de escritura

KROKI_MCP_LOG_LEVEL

No

INFO

Nivel de registro (DEBUG, INFO, WARNING, ERROR)

KROKI_MCP_SERVER_NAME

No

kroki-mcp

Nombre del servidor mostrado a los clientes

KROKI_MCP_INSTRUCTIONS

No

(dinámico)

Instrucciones del sistema para el contexto del LLM

Herramientas

render_diagram

Renderiza un diagrama usando Kroki.

Parámetros:

  • diagram_type — lenguaje del diagrama (p. ej., "plantuml", "mermaid", "graphviz")

  • source — código fuente del diagrama

  • output_format — "svg" (predeterminado) o "png"

  • as_base64 — cuando es true y el formato es PNG, devuelve una cadena base64 en lugar de una imagen MCP

list_diagram_types

Enumera todos los tipos de diagramas admitidos y sus formatos de salida. Devuelve una matriz JSON.

Recursos

kroki://health

Comprueba si la instancia de Kroki es accesible. Devuelve un JSON con status ("ok" o "unreachable").

Prompts

diagram_helper

Obtén orientación sobre la sintaxis y un ejemplo básico para un tipo de diagrama determinado, además de instrucciones para usar render_diagram.

Parámetro: diagram_type — p. ej., "mermaid", "plantuml", "graphviz"

Autenticación

El servidor admite token de portador (bearer token) y autenticación OIDC para transporte HTTP:

Variable

Descripción

KROKI_MCP_BEARER_TOKEN

Token de portador estático

KROKI_MCP_BASE_URL

URL pública del servidor — requerido para OIDC (p. ej., https://mcp.example.com)

KROKI_MCP_OIDC_CONFIG_URL

Punto final de descubrimiento OIDC

KROKI_MCP_OIDC_CLIENT_ID

ID de cliente OIDC

KROKI_MCP_OIDC_CLIENT_SECRET

Secreto de cliente OIDC

KROKI_MCP_OIDC_JWT_SIGNING_KEY

Clave de firma JWT — requerido en Linux/Docker para sobrevivir a reinicios

Consulta la guía de autenticación para obtener detalles completos de la configuración.

Docker

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

Consulta la implementación de Docker para volúmenes, UID/GID y configuración de Traefik.

Desarrollo

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

Licencia

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers