适合谁
- 需要AI辅助生成技术文档图表（如架构图、流程图）的开发者。
- 希望将图表生成集成到自动化工作流中的团队。
- 使用Claude、VSCode、Cline等支持MCP的桌面应用的AI用户。
M
47FMRS · D
mcp-mermaid是一个实用的MCP服务器，支持多种传输方式，安装简单，功能丰富。适合开发者快速集成AI图表生成，但需注意输入验证和隐私问题。
mcp-mermaid是一个MCP服务器，允许AI模型动态生成Mermaid图表和示意图。它完全支持Mermaid的所有功能，并允许配置背景色和主题。支持导出为base64、SVG、Mermaid源文件、本地文件以及远程URL等多种格式，并提供Mermaid语法验证以帮助模型生成正确的图表。
工具能力
generate_mermaid
根据用户输入生成Mermaid图表，可指定类型、主题、背景色和输出格式。
安装接入
- 确保已安装Node.js和npm。
- 在MCP客户端（如Claude Desktop）的配置文件中添加服务器配置（见上方install_config）。
- 重启客户端，即可使用。
claude_desktop_config.json
{
"mcpServers": {
"mcp-mermaid": {
"command": "npx",
"args": [
"-y",
"mcp-mermaid"
]
}
}
}
选型与风险
不适合谁
- 需要静态生成大量图表的场合（更适合直接使用Mermaid CLI或库）。
- 对图表渲染有特殊定制需求，超出Mermaid支持范围的场景。
- 没有Node.js环境或无法使用npm的用户。
所需权限
- 网络访问：如果使用远程Mermaid API或导出URL，需要网络权限。
- 文件系统：当使用输出类型为'file'时，可在服务器所在目录写入PNG文件。
- 本地服务：如果使用SSE或Streamable传输，需要监听本地端口。
风险与副作用
- 输入中的Mermaid语法可能包含恶意内容，建议对用户输入进行过滤。
- 如果配置不当，文件输出可能覆盖或创建意外文件。
- 远程URL模式会生成公开链接，可能泄露图表内容，需注意隐私。
常见排障
- 确保npx命令可用，并已安装最新Node.js。
- 检查MCP客户端配置是否正确，特别是命令和参数。
- 如果使用SSE或Streamable，检查端口是否被占用，并确认防火墙允许。
- 查看服务日志或使用MCP Inspector调试。
- 确认网络连接正常，以便访问远程API或URL。
使用场景
让AI助手在对话中直接生成流程图、时序图、甘特图等Mermaid图表。
将AI生成的图表保存为PNG文件或通过URL分享。
在支持MCP的IDE或聊天工具中快速创建可视化图表。
支持客户端
Claude Desktop完整支持