mcpField
M
MCP Kroki Server

MCP Kroki Server

本地服务
github.com/tkoba1974媒体与设计882 周前更新
代码仓库

关于 MCP Kroki Server

MCP Kroki Server 供 MCP 客户端将图表转换为文件或 Kroki.io 链接，支持 Mermaid、PlantUML、Graphviz 等格式及多种输出类型。

主要功能

  1. 01生成 Kroki.io 图表链接
  2. 02将图表下载为文件
  3. 03支持 Mermaid、PlantUML、Graphviz
  4. 04导出 SVG、PNG、PDF 或 JPEG

适用场景

  1. 01将 Mermaid 图表生成图片文件
  2. 02为 PlantUML 图表生成可分享链接

MCP 相关

向 MCP 客户端提供生成图表链接和下载转换后图表的工具，转换由 Kroki.io 完成。

#mathgpt#math-solver#math-assistant

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "kroki": {
      "command": "npx",
      "args": [
        "-y",
        "@tkoba1974/mcp-kroki"
      ]
    }
  }
}
启动命令npx -y @tkoba1974/mcp-kroki

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@tkoba1974/mcp-kroki

工具

2

收录的工具列表 · 更新于 3 周前

参数类型必填说明
typestring是图表类型（例如，"mermaid" 表示 Mermaid 图表，"plantuml" 表示 PlantUML，"graphviz" 表示 GraphViz DOT，"c4plantuml" 表示 C4 架构图，还有许多其他类型）。所有受支持的格式请参阅 Kroki.io 文档。
contentstring是指定格式的图表内容。对于 Mermaid 图表，此处应为 Mermaid 语法代码（例如，"graph TD; A-->B; B-->C;"）。
outputFormatstring否输出图像的格式。选项包括："svg"（矢量图形，默认）、"png"（栅格图像）、"pdf"（文档格式）、"jpeg"（压缩栅格图像）或 "base64"（用于直接嵌入 HTML 的 base64 编码 SVG）。

详细介绍

MCP Kroki Server

一个 MCP（Model Context Protocol）服务，可使用 Kroki.io 将 Mermaid 图表转换为 SVG 图像。

功能

  • 使用 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

用法

该服务提供两种主要工具：

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 输出。最小值为 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。