MCP Kroki

🚀 MCP Kroki 服務器

MCP Kroki 服務器是一個基於 MCP（模型上下文協議）的工具，藉助 Kroki.io 平臺，可將 Mermaid 等多種格式的圖表輕鬆轉換為 SVG 圖像。它不僅能生成圖表 URL，還支持將圖表下載為 SVG、PNG、PDF 或 JPEG 文件，為圖表處理提供了便捷的解決方案。

🚀 快速開始

MCP Kroki 服務器能借助 Kroki.io 實現圖表格式轉換，支持生成圖表 URL 和下載圖表文件。以下為您介紹詳細的使用步驟。

✨ 主要特性

• 圖表 URL 生成：利用 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

💻 使用示例

基礎用法

// 生成 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'
});

📚 詳細文檔

生成圖表 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 許可證。