← 返回目录

Mermaid MCP Server

社区

用AI动态生成Mermaid图表和示意图的MCP服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 290 / 438
Stars: ★ 642 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js · Docker · 远程托管（无需本地环境）
凭据: 无需凭据
许可证: MIT
最近提交: 4 个月前
工具数: 1

47FMRS · D

mcp-mermaid是一个实用的MCP服务器，支持多种传输方式，安装简单，功能丰富。适合开发者快速集成AI图表生成，但需注意输入验证和隐私问题。

最强项 · 安装易用性 13/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

7/20

维护活跃度

10/20

文档质量

10/20

安装易用性

13/20

查看各项评分依据

可靠性 7/20: 仅有 README 和仓库元数据，未提供 server manifest、源码或测试。README 声称支持 stdio/SSE/streamable 和多种输出格式，但未列出具体工具名与参数，错误处理和依赖可控性也无证据。Happy path 看似可行，但按静态评审规则，缺少可验证的执行证据，因此不高于 12 分并保守给分。
安全与权限 7/20: 未发现恶意行为或凭据泄露，但 README 明确支持通过公共 mermaid.ink 生成 svg_url/png_url，意味着用户图表内容可能被发送到第三方外部服务，且没有外部请求确认；源码不可见，无法排除其他网络或文件副作用。风险可见但权限边界、确认机制和数据流披露不完整。
维护活跃度 10/20: 有 MIT 许可证、明确维护者、npm 版本徽章和 build 徽章，说明项目有活跃迹象。但提供的证据中没有提交历史、发布时间线、依赖更新记录或安全响应渠道，issue 数量不能证明响应情况。符合“活跃但治理/版本化有缺口”的 10 分锚点。
文档质量 10/20: README 覆盖 Mac/Windows 安装、Docker、SSE/Streamable 访问点、CLI 选项、开发步骤和输出格式，使用说明可用。但缺少工具级参数说明（工具名、输入 schema）、限制（大小/速率/成本）、故障排查和错误信息说明，也没有分层文档。存在隐藏假设和排查缺口。
安装易用性 13/20: README 提供了主流客户端的配置 JSON（Claude、VSCode、Cline、Cherry Studio），并给出 npx、全局安装、Docker 和 HTTP/SSE 传输方式，Mac/Windows 均有覆盖，步骤清晰。但静态评审看不到可执行的测试或 CI 验证，不能完全确认开箱即用，因此按静态上限控制在 15 以下。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要AI辅助生成技术文档图表（如架构图、流程图）的开发者。
希望将图表生成集成到自动化工作流中的团队。
使用Claude、VSCode、Cline等支持MCP的桌面应用的AI用户。

不适合谁

需要静态生成大量图表的场合（更适合直接使用Mermaid CLI或库）。
对图表渲染有特殊定制需求，超出Mermaid支持范围的场景。
没有Node.js环境或无法使用npm的用户。

所需权限

网络访问：如果使用远程Mermaid API或导出URL，需要网络权限。
文件系统：当使用输出类型为'file'时，可在服务器所在目录写入PNG文件。
本地服务：如果使用SSE或Streamable传输，需要监听本地端口。

风险与副作用

输入中的Mermaid语法可能包含恶意内容，建议对用户输入进行过滤。
如果配置不当，文件输出可能覆盖或创建意外文件。
远程URL模式会生成公开链接，可能泄露图表内容，需注意隐私。

安装接入

准备工作

运行环境：Node.js · Docker · 远程托管（无需本地环境）

确保已安装Node.js和npm。
在MCP客户端（如Claude Desktop）的配置文件中添加服务器配置（见上方install_config）。
重启客户端，即可使用。

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-mermaid": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mermaid"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mcp-mermaid": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mermaid"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mcp-mermaid -- npx -y mcp-mermaid

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 generate_mermaid 工具；让它生成一个简单流程图并返回 svg 或 URL，若能正常渲染则连接成功。

常见排障

确保npx命令可用，并已安装最新Node.js。
检查MCP客户端配置是否正确，特别是命令和参数。
如果使用SSE或Streamable，检查端口是否被占用，并确认防火墙允许。
查看服务日志或使用MCP Inspector调试。
确认网络连接正常，以便访问远程API或URL。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 mermaid 画一个用户登录的流程图，导出为 png 保存到文件
生成一个展示订单状态的时序图，并给我一个可分享的 svg_url
画一个深色主题的甘特图，背景色设为浅灰色，输出 base64
生成一张类图表示 Animal、Dog 和 Cat 的继承关系

工具能力 1

generate_mermaid 写入

根据用户输入生成Mermaid图表，可指定类型、主题、背景色和输出格式。

使用场景

让AI助手在对话中直接生成流程图、时序图、甘特图等Mermaid图表。

将AI生成的图表保存为PNG文件或通过URL分享。

在支持MCP的IDE或聊天工具中快速创建可视化图表。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

mcp-mermaid是一个MCP服务器，允许AI模型动态生成Mermaid图表和示意图。它完全支持Mermaid的所有功能，并允许配置背景色和主题。支持导出为base64、SVG、Mermaid源文件、本地文件以及远程URL等多种格式，并提供Mermaid语法验证以帮助模型生成正确的图表。