utain/kroki-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

20 stars 9 forks Качество 78 Тренд 18MIT

Kroki-MCP - это инструмент протокола контекста модели на основе Go, который преобразует текстовые определения диаграмм (PlantUML, Mermaid и другие) в изображения через бэкэнд Kroki.

Обзор

Kroki-MCP - это инструмент командной строки и интеграции MCP для преобразования текстовых диаграмм (например, PlantUML, Mermaid) в изображения с использованием бэкэнда Kroki. Он поддерживает как локальные, так и удаленные серверы Kroki с гибкой конфигурацией и несколькими выходными форматами. - Потоки результатов с использованием событий Server-Sent. - Считывает код диаграммы от stdin и выходов до stdout. Поддерживает svg (по умолчанию) и png. SVG возвращается в виде текста разметки, нормализуется в масштабе и остается прозрачным при рендеринге в чате (например, Claude Desktop); PNG возвращается в виде изображения. - Конфигурируемый бэкэнд-хост (по умолчанию: https://kroki.io). - Легко добавить поддержку большего количества типов диаграмм и выходных форматов). Выставляет преобразование диаграммы в качестве инструмента MCP с использованием github.com/mark3labs/mcp-go. 1. Проект Скаффолд Го. 2. Внедрить CLI с режимом SSE по умолчанию, флагами формата. 3. Внедрить клиент Kroki, поддерживающий все форматы. 4. Режимы SSE и STDIO. 5. Интеграция с mcp-go для поддержки инструментов MCP. 6. Добавить обработку ошибок и тесты. 7.

Обзор (машинный перевод)

Особенности

**Режимы: ** **SSE: ** Результаты потоков с использованием событий, отправленных сервером. **STDIO (по умолчанию): ** Считывает код диаграммы от stdin и выходов к stdout.

** Output Formats: ** Поддерживает svg (по умолчанию) и png. SVG возвращается в виде текста разметки, нормализуется в масштабе и остается прозрачным при рендеринге в чате (например, Claude Desktop); PNG возвращается в виде изображения.
Kroki Server: Конфигурируемый бэкэнд-хост (по умолчанию: https://kroki.io). ** Расширяемый:** Легко добавить поддержку для большего количества типов диаграмм и выходных форматов. **MCP Интеграция: ** Выставляет преобразование диаграммы в качестве инструмента MCP с использованием github.com/mark3labs/mcp-go.

Использование

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

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Kroki-MCP

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 svg (default) and png. SVG is returned as markup text, normalized to scale and stay transparent when rendered inline in chat (e.g., Claude Desktop); PNG is returned as an image.
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

# Default (SSE mode, PNG, default Kroki host)
kroki-mcp

# Specify output format
kroki-mcp --format svg

# Use STDIO mode
kroki-mcp --mode stdio --format svg

# Specify a custom Kroki server
kroki-mcp --kroki-host http://localhost:8000

Configuration

Option	Description	Type	Default
`--host`, `-h`	Server host address	string	`localhost`
`--port`, `-p`	Server port	int	`5090`
`--mode`, `-m`	Operation mode (`sse` or `stdio`)	string	`stdio`
`--format`, `-f`	Output format (`png`, `svg`)	string	`png`
`--kroki-host`	Kroki server URL	string	`https://kroki.io`
`--log-level`	Log level (`debug`, `info`, `warn`, `error`)	string	`info`
`--log-format`	Log format (`text` or `json`)	string	`text`

Project Structure

kroki-mcp/
├── cmd/
│   └── kroki-mcp/           # Main CLI and MCP server entry point
├── internal/
│   ├── kroki/               # Kroki client logic (HTTP, formats)
│   ├── config/              # Configuration management (flags, env, files)
│   └── mcp/                 # MCP tool/server integration
├── test/                    # Unit and integration tests

Открыть полный README на GitHub

Установка

docker run --rm -it kroki-mcp --help

Новичок в MCP? Начните с руководства на mcpskill.org →

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

{
  "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"
      ]
    }
  }
}