MCP Kroki

🚀 MCP Kroki サーバ

Kroki.io を使用して、Mermaid チャートを SVG 画像に変換する MCP（モデルコンテキストプロトコル）サーバです。

🚀 クイックスタート

MCP Kroki サーバは、Kroki.io を利用してチャートを生成およびダウンロードするための便利なツールです。以下では、サーバのインストール、使用方法、具体的なサンプルコードを紹介します。

✨ 主な機能

• Kroki.io を使用してチャートの URL を生成します。
• チャートを SVG、PNG、PDF、または JPEG ファイルとしてダウンロードできます。
• 複数のチャート形式をサポートしています：
  • Mermaid
  • PlantUML
  • Graphviz
  • その他（詳細は Kroki.io のドキュメントを参照）

📦 インストール

ローカルインストール

git clone https://github.com/tkoba1974/mcp-kroki.git
cd mcp-kroki
npm install
npm run build

💻 使用例

サーバは 2 つの主要なツールを提供しています。

基本的な使用法

// Mermaid チャートの URL を生成する
const result = await callTool('generate_diagram_url', {
  type: 'mermaid',
  content: 'graph TD; A-->B; B-->C; C-->D;',
  outputFormat: 'svg'
});

// Mermaid チャートをダウンロードする
const result = await callTool('download_diagram', {
  type: 'mermaid',
  content: 'graph TD; A-->B; B-->C; C-->D;',
  outputPath: '/path/to/diagram.svg'
});

高度な使用法

ダウンロード時に scale パラメータを指定することで、SVG チャートのサイズを調整できます。

// Mermaid チャートを指定したスケールでダウンロードする
const result = await callTool('download_diagram', {
  type: 'mermaid',
  content: 'graph TD; A-->B; B-->C; C-->D;',
  outputPath: '/path/to/diagram.svg',
  outputFormat: 'svg',
  scale: 1.5
});

📚 ドキュメント

生成チャート URL

Kroki.io を使用してチャートの URL を生成します。

• type：チャートのタイプ（例："mermaid"、"plantuml"）
• content：指定形式のチャート内容
• outputFormat（オプション）：出力形式（svg, png, pdf, jpeg, base64）

チャートのダウンロード

チャートをローカルファイルにダウンロードします。

• type：チャートのタイプ（例："mermaid"、"plantuml"）
• content：指定形式のチャート内容
• outputPath：チャートを保存するパス
• outputFormat（オプション）：出力形式（svg, png, pdf, jpeg）
• scale（オプション、数値、デフォルト値は 1.0）：チャートサイズのスケール係数。現在は SVG 出力のみに影響し、width/height 属性を変更します。最小値は 0.1 です。

🔧 技術詳細

サーバは Kroki.io API を使用してチャート変換を行います。Kroki.io に送信する前に、チャート内容は圧縮およびエンコードされます。

Claude Desktop の使用

Claude Desktop の設定ファイル（claude_desktop_config.json）に以下の設定を追加します。

ローカルインストール

{
  "mcpServers": {
    "mcp-kroki": {
      "command": "node",
      "args": ["/path/to/mcp-kroki/build/index.js"]
    }
  }
}

npx を使用する場合

{
  "mcpServers": {
    "mcp-kroki": {
      "command": "npx",
      "args": [
        "-y",
        "@tkoba1974/mcp-kroki"
      ]
    }
  }
}

📄 ライセンス

MIT