MCP Kroki Server

MCP Kroki サーバー

Kroki.io を使用して Mermaid 図を SVG 画像に変換する MCP（Model Context Protocol）サーバーです。

機能

• 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 つのツールを提供します。

1. 図の URL を生成

Kroki.io を使用して図の URL を生成します。

パラメーター：

• type：図の種類（例：「mermaid」、「plantuml」）
• content：指定した形式の図の内容
• outputFormat（任意）：出力形式（svg、png、pdf、jpeg、base64）

2. 図をダウンロード

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

パラメーター：

• type：図の種類（例：「mermaid」、「plantuml」）
• content：指定した形式の図の内容
• outputPath：図の保存先パス
• outputFormat（任意）：出力形式（svg、png、pdf、jpeg）
• scale（任意、数値、既定値：1.0）：図の寸法の拡大縮小率です。現在は SVG の出力にのみ影響し、width/height 属性の変更を試みます。最小値は 0.1 です。

例

// Generate a URL for a Mermaid diagram
const result = await callTool('generate_diagram_url', {
  type: 'mermaid',
  content: 'graph TD; A-->B; B-->C; C-->D;',
  outputFormat: 'svg'
});

// Download a Mermaid diagram
const result = await callTool('download_diagram', {
  type: 'mermaid',
  content: 'graph TD; A-->B; B-->C; C-->D;',
  outputPath: '/path/to/diagram.svg'
});

動作の仕組み

サーバーは 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