
Mermaid MCP Server

2025.04.01
1
JavaScript图表渲染语法验证开发效率
Mermaid MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专门用于验证和渲染 Mermaid 图表。它允许 AI 助手(如 Roo)与 Mermaid 图表交互,检查语法,将其渲染为 SVG 格式,并提供文档链接。
View on GitHub
Overview
基本能力
产品定位
Mermaid MCP Server 是一个专门用于处理 Mermaid 图表的服务,提供语法验证和 SVG 渲染功能,适用于开发者和 AI 助手。
核心功能
- 验证 Mermaid 语法:检查提供的 Mermaid 代码是否语法正确。
- 渲染为 SVG:将有效的 Mermaid 代码转换为 SVG 图像格式。
- 获取文档链接:提供官方 Mermaid 文档的链接。
适用场景
- 开发者需要快速验证 Mermaid 图表的语法。
- AI 助手需要渲染 Mermaid 图表为 SVG 格式。
- 需要快速访问 Mermaid 官方文档的场景。
工具列表
validate_mermaid
:验证 Mermaid 语法,无需渲染。render_mermaid_svg
:将 Mermaid 代码渲染为 SVG 格式。get_mermaid_docs_link
:获取官方 Mermaid 文档链接。
常见问题解答
- 确保 Node.js (v18 或更高版本) 已安装。
- 确保网络连接正常,以便 Puppeteer 下载 Chromium。
使用教程
使用依赖
- 安装 Node.js (v18 或更高版本)。
- 安装 npm 或 yarn。
- 确保有兼容的 MCP 客户端(如 Roo Cline VSCode 扩展)。
安装教程
- 全局安装 mermaid-mcp-server:
bash npm install -g mermaid-mcp-server
- 配置 Roo Cline 的 MCP 设置文件,添加以下配置:
json { "mcpServers": { "mermaid-mcp-server": { "command": "mermaid-mcp-server", "disabled": false, "alwaysAllow": [] } } }
- 重启 VSCode 或重新加载窗口。
调试方式
- 克隆仓库:
bash git clone https://github.com/TanisukeGoro/mermaid-mcp-server.git cd mermaid-mcp-server
- 安装依赖:
bash npm install
- 构建服务器:
bash npm run build
- 使用 MCP Inspector 测试:
bash npm run inspector