kroki-mcp

MCP-сервер, оборачивающий самохостируемый экземпляр Kroki и предоставляющий инструменты MCP для отрисовки диаграмм.

Поддерживает более 29 типов диаграмм, включая PlantUML, Mermaid, GraphViz, D2, DBML, ERD и другие. Полный список см. в списке поддерживаемых диаграмм Kroki.

Быстрый старт

# 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

Конфигурация

Инструменты

render_diagram

Отрисовка диаграммы с помощью Kroki.

Параметры:

• diagram_type — язык диаграммы (например, "plantuml", "mermaid", "graphviz")

• source — исходный код диаграммы

• output_format — "svg" (по умолчанию) или "png"

• as_base64 — если true и формат PNG, возвращает строку base64 вместо изображения MCP

list_diagram_types

Список всех поддерживаемых типов диаграмм и их форматов вывода. Возвращает массив JSON.

Ресурсы

kroki://health

Проверка доступности экземпляра Kroki. Возвращает JSON со статусом status ("ok" или "unreachable").

Промпты

diagram_helper

Получение руководства по синтаксису и базового примера для заданного типа диаграммы, а также инструкции по использованию render_diagram.

Параметр: diagram_type — например, "mermaid", "plantuml", "graphviz"

Аутентификация

Сервер поддерживает аутентификацию через bearer-токен и OIDC для HTTP-транспорта:

Полные сведения о настройке см. в руководстве по аутентификации.

Docker

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

Информацию о томах, UID/GID и настройке Traefik см. в руководстве по развертыванию Docker.

Разработка

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

Лицензия

MIT