Kroki-MCP

by utain

15 stars
1.2k downloads
Not rated
GitHub

About

Kroki-MCP is a Go-based Model Context Protocol tool that converts textual diagram definitions (PlantUML, Mermaid, and more) into images via a Kroki backend. Designed for simplicity and flexibility, it supports both local and remote Kroki servers, offers configurable settings, and

Details

Author
utain
GitHub stars
15
Downloads
1,180
Categories
Other

- Two operation modes: SSE (server-sent events) and STDIO (stdin/stdout)
- Output formats: PNG (default), SVG, JPEG, and PDF
- Configurable Kroki backend host (default: https://kroki.io)
- Extensible design for additional diagram types and formats
- MCP integration via github.com/mark3labs/mcp-go
- Supports both local and remote Kroki servers

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Kroki-MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Kroki-MCP is installed and run via the Go toolchain or Docker. Invoke it with kroki-mcp and specify output format (--format), mode (--mode, either sse or stdio), and Kroki host (--kroki-host). To use it as an MCP server, add a configuration entry in your MCP client’s settings file (e.g., claude_desktop_config.json) pointing to the kroki-mcp command with appropriate arguments.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "kroki-mcp": {
            "kroki-mcp": {
                "command": "go",
                "args": [
                    "run",
                    "github.com/utain/kroki-mcp/cmd/kroki-mcp@latest",
                    "-m",
                    "stdio",
                    "-f",
                    "png",
                    "--kroki-host",
                    "https://kroki.io"
                ]
            }
        }
    }
}

McpServers

{
    "kroki-mcp": {
        "command": "go",
        "args": [
            "run",
            "github.com/utain/kroki-mcp/cmd/kroki-mcp@latest",
            "-m",
            "stdio",
            "-f",
            "png",
            "--kroki-host",
            "https://kroki.io"
        ]
    }
}

Kroki-MCP

CI
Go Version
License: MIT
<!-- Uncomment and update if Docker image is published
Docker Pulls
-->

Kroki-MCP is a command-line tool and MCP integration for converting textual diagrams (e.g., PlantUML, Mermaid) into images using a Kroki backend. It supports both local and remote Kroki servers, with flexible configuration and multiple output formats.

Features

- Modes:
- SSE: Streams results using Server-Sent Events.
- STDIO (default): Reads diagram code from stdin and outputs to stdout.
- Output Formats: Supports png (default), svg, jpeg, and pdf.
- Kroki Server: Configurable backend host (default: https://kroki.io).
- Extensible: Easily add support for more diagram types and output formats.
- MCP Integration: Exposes diagram conversion as an MCP tool using github.com/mark3labs/mcp-go.

Usage

```sh

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.