kroki-mcp

자체 호스팅 Kroki 인스턴스를 래핑하여 다이어그램 렌더링을 MCP 도구로 노출하는 MCP 서버입니다.

PlantUML, Mermaid, GraphViz, D2, DBML, ERD 등을 포함한 29개 이상의 다이어그램 유형을 지원합니다. 전체 목록은 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인 경우, MCP 이미지 대신 base64 문자열을 반환합니다.

list_diagram_types

지원되는 모든 다이어그램 유형과 해당 출력 형식을 나열합니다. JSON 배열을 반환합니다.

리소스

kroki://health

Kroki 인스턴스에 연결할 수 있는지 확인합니다. status("ok" 또는 "unreachable")가 포함된 JSON을 반환합니다.

프롬프트

diagram_helper

특정 다이어그램 유형에 대한 구문 안내와 기본 예제를 제공하며, render_diagram 사용 지침을 포함합니다.

매개변수: diagram_type — 예: "mermaid", "plantuml", "graphviz"

인증

이 서버는 HTTP 전송을 위한 베어러 토큰 및 OIDC 인증을 지원합니다:

전체 설정 세부 정보는 인증 가이드를 참조하세요.

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