utain/kroki-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

20 stars 9 forks 品質 78 トレンド 18MIT

Repository Install

Kroki-MCP は、Kroki バックエンドを介して画像にテキスト図の定義(PlantUML、マーメイドなど)を変換する Go ベースのモデルコンテキストプロトコルツールです.

概要

Kroki-MCP は、Kroki バックエンドを使用して画像にテキスト図(例、PlanetUML、マーメイド)を変換するためのコマンドラインツールと MCP 統合です。ローカルおよびリモートのKrokiサーバー、適用範囲が広い構成および多数の出力フォーマットと支えます。 - - Server-Sentイベントを使用して結果をストリームします。 - stdinと出力からstdoutへの図コードを読みます。 - svg(デフォルト)とpngをサポートしています。 SVGはマークアップテキストとして返され、チャットでインラインをレンダリングしたときに、通常化され、透明にとどまります(例えば、Claude Desktop); PNGはイメージとして返されます。 - 設定可能なバックエンドホスト(デフォルト:[https://kroki.io).]]) - より多くの図タイプと出力フォーマットのサポートを簡単に追加できます。 - github.com/mark3labs/mcp-go を使用した MCP ツールとして図変換を公開します。 1. 足場プロジェクト 2。デフォルトSSEモード、フォーマットフラグでCLIを実行します。 3.すべてのフォーマットをサポートするKrokiクライアントを実装します。 4. SSE および STDIO モードを実装します。 5。 MCP ツールのサポートのための mcp-go と統合します。 6. エラー処理とテストを追加します。 7.

概要（AI 翻訳）

Kroki-MCP は、Kroki バックエンドを使用して画像にテキスト図(例、PlanetUML、マーメイド)を変換するためのコマンドラインツールと MCP 統合です。ローカルおよびリモートのKrokiサーバー、適用範囲が広い構成および多数の出力フォーマットと支えます。

##特徴

女:
印:* Server-Sent イベントを使用して結果をストリームします。
STDIO (デフォルト): stdinと出力からstdoutへの図コードを読みます。
出力形式: サポート [svg] (デフォルト) と [png]. SVGはマークアップテキストとして返され、チャットでインラインをレンダリングしたときに、通常化され、透明にとどまります(例えば、Claude Desktop); PNGはイメージとして返されます。
Kroki Server: 設定可能なバックエンドホスト (デフォルト: https://kroki.io)。
拡張可能: より多くの図タイプおよび出力フォーマットのためのサポートを容易に加えて下さい。 -MCPインテグレーション: github.com/mark3labs/mcp-go を使用した MCP ツールとして図変換を公開します。

使用法

設定

| オプション | 説明 | タイプ | デフォルト | |----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | [--host, [-h] | サーバーホストアドレス | 文字列 | [localhost | | [[T6], -p | サーバポート | int | [[T8] |

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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

GitHub で README 全文を見る

インストール

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