{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_d2kwev7j5nw6","handle":"mcp-mermaid-converter","url":"https://wellknown.network/agents/mcp-mermaid-converter","links":{"self":"https://wellknown.network/agents/mcp-mermaid-converter/record.json","html":"https://wellknown.network/agents/mcp-mermaid-converter","markdown":"https://wellknown.network/agents/mcp-mermaid-converter/record.md","api":"https://wellknown.network/api/v1/agents/mcp-mermaid-converter","status":"https://wellknown.network/api/v1/agents/mcp-mermaid-converter/status","claim":"https://wellknown.network/agents/mcp-mermaid-converter/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-mermaid-converter/claim.json","badge":"https://wellknown.network/agents/mcp-mermaid-converter/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-mermaid-converter/history","tools":"https://wellknown.network/api/v1/agents/mcp-mermaid-converter/tools"},"ard":{"identifier":"urn:air::server:mcp-mermaid-converter","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-mermaid-converter","summary":"将Mermaid图表转换为PNG或SVG图片的MCP服务（基于FastMCP）","description":"# MCP Mermaid Converter\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n\n一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 和 [FastMCP](https://github.com/jlowin/fastmcp) 的 Mermaid 图表转换服务，可以将 Mermaid 图表文本转换为 PNG 或 SVG 格式的图片。\n\n## ✨ 特性\n\n- 🎨 支持将 Mermaid 文本直接转换为图片\n- 📁 支持从 .mmd 文件读取并转换\n- 🖼️ 支持 PNG 和 SVG 两种输出格式\n- ⚡ 基于 MCP 协议，可与支持 MCP 的 AI 助手集成\n- 🌐 使用 [Kroki.io](https://kroki.io) API 进行高质量图表渲染\n- 🔧 简单易用，零配置即可开始使用\n\n## 📦 安装\n\n### 使用 uvx（推荐）\n\n```bash\nuvx mcp-mermaid-converter\n```\n\n### 使用 pip\n\n```bash\npip install mcp-mermaid-converter\n```\n\n### 从源码安装\n\n```bash\ngit clone https://github.com/yourusername/mcp-mermaid-converter.git\ncd mcp-mermaid-converter\npip install -e .\n```\n\n## 🚀 快速开始\n\n### 作为 MCP 服务器运行\n\n将以下配置添加到你的 MCP 客户端配置文件中（如 Cursor 的 `cursor_mcp_config.json` 或 Claude Desktop 的配置文件）：\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-mermaid-converter\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-mermaid-converter\"]\n    }\n  }\n}\n```\n\n### 使用示例\n\n#### 转换 Mermaid 文本\n\n```python\n# 通过 MCP 客户端调用\nconvert_mermaid_text(\n    mermaid_text=\"\"\"\n    graph TD\n        A[开始] --> B[处理]\n        B --> C[结束]\n    \"\"\",\n    output_file=\"diagram.png\",\n    format=\"png\"\n)\n```\n\n#### 转换 Mermaid 文件\n\n```python\n# 通过 MCP 客户端调用\nconvert_mermaid_file(\n    input_file=\"diagram.mmd\",\n    output_file=\"diagram.svg\",\n    format=\"svg\"\n)\n```\n\n## 🛠️ MCP 工具说明\n\n### convert_mermaid_text\n\n将 Mermaid 图表文本直接转换为图片格式。\n\n**参数：**\n- `mermaid_text` (string, 必需): Mermaid 图表的文本内容\n- `output_file` (string, 必需): 输出图片文件的路径\n- `format` (string, 可选): 输出格式，支持 `png` 或 `svg`，默认为 `png`\n\n**返回：**\n成功消息，包含输出文件路径和文件大小。\n\n### convert_mermaid_file\n\n将 Mermaid 图表文件（.mmd）转换为图片格式。\n\n**参数：**\n- `input_file` (string, 必需): Mermaid 文件的路径（.mmd 文件）\n- `output_file` (string, 必需): 输出图片文件的路径\n- `format` (string, 可选): 输出格式，支持 `png` 或 `svg`，默认为 `png`\n\n**返回：**\n成功消息，包含输出文件路径和文件大小。\n\n## 📝 支持的 Mermaid 图表类…","publisher":null,"homepage":"https://github.com/yourusername/mcp-mermaid-converter","repository":"https://github.com/yourusername/mcp-mermaid-converter/issues","version":"0.2.1","license":null,"protocols":["mcp"],"tags":["mermaid","diagram","converter","visualization","kroki","mcp","fastmcp","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:mcp-mermaid-converter","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"analytics.reporting","name":"Reporting & Dashboards","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["analytics","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-mermaid-converter","registry":"pypi","observedAt":"2026-10-28T12:22:47.524Z","publishedAt":"2025-12-15T12:44:51.253587Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-mermaid-converter","url":"https://pypi.org/project/mcp-mermaid-converter/","firstSeenAt":"2026-09-10T02:23:43.388Z","fetchedAt":"2026-10-28T12:20:53.207Z","normalizedAt":"2026-10-28T12:20:53.207Z"}]},"firstSeenAt":"2026-09-10T02:23:43.388Z","updatedAt":"2026-10-28T12:22:47.524Z"}