进阶 mermaid.ai 2026-11-12 20:48:10 · 21 阅读
第23章 Claude MCP 应用之 Mermaid Claude MCP App
Mermaid Claude MCP App
Mermaid Claude MCP App 让 Claude 能直接在对话中创建、校验并渲染 Mermaid 图表。当你让 Claude 绘制流程图、时序图或其他任何 Mermaid 图表时,这个应用会自动完成整个流程——从语法校验,到渲染出一个带有图表的交互式组件,并提供复制功能和无效语法的修复链接。
Server URL: https://chatgpt.mermaid.ai/anthropic/mcp
可用工具 validate_and_render_mermaid_diagram 校验 Mermaid 图表语法,并将其渲染为交互式 UI 组件。 输入参数: 参数类型必填说明diagramCodestring是待校验和渲染的 Mermaid 图表代码titlestring否图表的可选标题 输出: 该工具返回包含以下字段的结构化内容: title - 图表标题 diagramCode - 原始 Mermaid 代码 valid - 图表语法是否有效 renderedSVG - 图表的 SVG 渲染结果(语法有效时) renderedPNG - 图表的 PNG 渲染结果(语法有效时) rawSVG - 原始 SVG 数据 diagramType - 检测到的图表类型(流程图、时序图等) liveEditUrl - 在 Mermaid Live 中编辑该图表的链接 error / validationError - 校验失败时的错误详情 工具标注: readOnlyHint: true - 不修改任何数据 openWorldHint: false - 不与外部域名交互 destructiveHint: false - 运行安全,无副作用
UI 组件 该应用包含一个交互式 UI 组件,用于展示: 渲染后的图表 - Mermaid 图表的可视化呈现 复制代码按钮 - 一键复制图表代码 修复链接 - 如果图表语法无效,会提供在 Mermaid Live 中修复的链接 组件权限: clipboardWrite - 允许将图表代码复制到剪贴板
工作原理 当你让 Claude 创建 Mermaid 图表时: Claude 根据你的需求生成 Mermaid 语法 validate_and_render_mermaid_diagram 工具对语法进行校验 校验通过后,图表被渲染为 SVG/PNG 交互式组件展示结果,并附带复制和编辑选项 校验失败时,你会看到一个带有修复链接的 UI,可跳转到 Mermaid Live 修复图表
可用工具 validate_and_render_mermaid_diagram 校验 Mermaid 图表语法,并将其渲染为交互式 UI 组件。 输入参数: 参数类型必填说明diagramCodestring是待校验和渲染的 Mermaid 图表代码titlestring否图表的可选标题 输出: 该工具返回包含以下字段的结构化内容: title - 图表标题 diagramCode - 原始 Mermaid 代码 valid - 图表语法是否有效 renderedSVG - 图表的 SVG 渲染结果(语法有效时) renderedPNG - 图表的 PNG 渲染结果(语法有效时) rawSVG - 原始 SVG 数据 diagramType - 检测到的图表类型(流程图、时序图等) liveEditUrl - 在 Mermaid Live 中编辑该图表的链接 error / validationError - 校验失败时的错误详情 工具标注: readOnlyHint: true - 不修改任何数据 openWorldHint: false - 不与外部域名交互 destructiveHint: false - 运行安全,无副作用
UI 组件 该应用包含一个交互式 UI 组件,用于展示: 渲染后的图表 - Mermaid 图表的可视化呈现 复制代码按钮 - 一键复制图表代码 修复链接 - 如果图表语法无效,会提供在 Mermaid Live 中修复的链接 组件权限: clipboardWrite - 允许将图表代码复制到剪贴板
工作原理 当你让 Claude 创建 Mermaid 图表时: Claude 根据你的需求生成 Mermaid 语法 validate_and_render_mermaid_diagram 工具对语法进行校验 校验通过后,图表被渲染为 SVG/PNG 交互式组件展示结果,并附带复制和编辑选项 校验失败时,你会看到一个带有修复链接的 UI,可跳转到 Mermaid Live 修复图表
使用示例
让 Claude 创建任意类型的 Mermaid 图表:
“创建一个展示用户登录流程的流程图”
“为 API 请求流程制作一个时序图”
“为 User 模型生成一个类图”
“绘制一个订单生命周期的状态图”
Claude 会自动使用该工具,通过交互式组件验证并渲染你的图表。
故障排查
如果遇到问题:
语法无效 - 使用组件中提供的修复链接,在 Mermaid Live 中修正语法错误
渲染问题 - 确保图表代码符合 Mermaid 语法规范
复制功能失效 - 检查应用是否已启用剪贴板权限
如需更多帮助,请前往 Mermaid Chart Issue Tracker 报告问题。
让 Claude 创建一个 Mermaid 图表,即可通过交互式组件即时查看渲染效果!