进阶 mermaid.ai 2026-11-12 20:48:10 · 20 阅读
第25章 Claude MCP 应用之 Mermaid 图表工具 v3
Mermaid Claude MCP App
Mermaid Claude MCP App 让 Claude 能够在对话中直接创建、渲染和管理 Mermaid 图表。当你让 Claude 绘制流程图、时序图或其他 Mermaid 图表时,这个应用会自动处理整个流程——渲染出一个交互式组件,包含图表、复制功能,以及对无效语法的修复选项。已登录用户还可以保存、更新和列出自己的个人图表。
服务器 URL: https://chatgpt.mermaid.ai/anthropic/v3/mcp
可用工具 display_mermaid 在交互式 UI 组件中展示 Mermaid 图表。图表通过 Mermaid 库在客户端渲染。需要登录认证。 输入参数: 参数类型 必填 描述 diagramCode string 是 要展示的 Mermaid 图表代码 title string 是 图表标题 documentID string 否 更新已有 documentID 的图表时必须提供;从头创建新图表时应省略 输出: 该工具返回包含以下字段的结构化内容: viewMode - 固定为 "diagramView" title - 图表标题 diagramCode - 原始 Mermaid 代码 documentID - 文档 ID(如有提供) isAuthenticated - 用户是否已登录 remainingCredits - 剩余 AI 额度(已登录时) 工具注解: readOnlyHint: true - 不修改任何数据 openWorldHint: false - 不与外部域名交互 idempotentHint: true - 可安全重复调用 destructiveHint: false - 无破坏性副作用
list_personal_diagrams 列出用户 Mermaid.ai 账户中已保存的 Mermaid 图表。需要登录认证。 输入参数:无 输出: 该工具返回包含以下字段的结构化内容: viewMode - 固定为 "listView" diagrams - { documentID, title } 对象数组 totalCount - 图表总数 isAuthenticated - 用户是否已登录 工具注解: readOnlyHint: true - 不修改任何数据 openWorldHint: false - 不与外部域名交互 idempotentHint: true - 可安全重复调用 destructiveHint: false - 无破坏性副作用
save_diagram 将新图表保存至用户的 Mermaid.ai 账户。此操作需通过身份验证。 输入参数: 参数 类型 是否必需 说明 diagramCode string 是 待保存的 Mermaid 图表代码 title string 否 图表的可选标题 输出: 该工具返回包含以下内容的结构化数据: documentID - 新文档的 ID projectID - 项目 ID id - 文档记录的 ID code - 已保存的图表代码 title - 图表标题 工具注解: readOnlyHint: false - 会创建新文档 openWorldHint: false - 不与外部域名进行交互 idempotentHint: false - 每次调用均创建新文档 destructiveHint: false - 不会覆盖现有数据
update_diagram 更新用户 Mermaid.ai 账户中已有的图表。此操作需通过身份验证。 输入参数: 参数 类型 是否必需 说明 documentID string 是 要更新的文档 ID diagramCode string 是 更新后的 Mermaid 图表代码 title string 否 图表的新可选标题 输出: 该工具返回包含以下内容的结构化数据: documentID - 文档 ID projectID - 项目 ID code - 更新后的图表代码 title - 图表标题 工具注解: readOnlyHint: false - 修改现有文档 openWorldHint: false - 不与外部域名进行交互 idempotentHint: true - 使用相同数据进行更新无额外影响 destructiveHint: true - 会覆盖现有图表数据
repair_diagram 利用 AI 尝试修复无效的 Mermaid 图表。此操作需通过身份验证,若修复成功将消耗 AI 积分。 输入参数: 参数 类型 是否必需 说明 code string 是 待修复的无效 Mermaid 图表代码 error string 是 图表验证产生的错误信息 输出: 该工具返回包含以下内容的结构化数据: diagramCode - 修复后的 Mermaid 图表代码 工具注解: readOnlyHint: false - 消耗 AI 积分 openWorldHint: false - 不与外部域名进行交互 idempotentHint: false - AI 修复结果可能不同,且每次调用均消耗积分 destructiveHint: false - 不会覆盖现有数据
sign_in 触发用户的 Mermaid.ai 账号 OAuth 登录流程。 输入参数:无 输出: 返回登录成功的文本确认信息。 工具注解: readOnlyHint: false - 会建立认证会话 openWorldHint: false - 不与外部域名交互 idempotentHint: true - 多次登录效果相同 destructiveHint: false - 无破坏性副作用 get_diagram_by_url 通过 URL 从用户的 Mermaid 账号获取图表标题和代码。需要认证。 输入参数: 参数类型必填说明urlstring是A MermaidChart diagram URL 输出: 该工具返回包含以下字段的结构化内容: documentID - 文档 ID projectID - 项目 ID code - 图表代码 title - 图表标题 工具注解: readOnlyHint: true - 不修改任何数据 openWorldHint: false - 不与外部域名交互 idempotentHint: true - 可安全地多次调用 destructiveHint: false - 无破坏性副作用
UI 组件 该应用包含一个交互式 UI 组件,展示以下内容: 渲染后的图表 - Mermaid 图表的可视化展示,在客户端渲染 复制代码按钮 - 一键复制图表代码 修复选项 - 如果图表存在语法错误,提供修复选项 图表列表 - 浏览并选择已保存的个人图表 组件权限: clipboardWrite - 允许将图表代码复制到剪贴板
工作原理 当你让 Claude 创建 Mermaid 图表时: Claude 根据你的需求生成 Mermaid 语法 display_mermaid 工具将代码发送到交互式组件 组件使用 Mermaid 库在客户端渲染图表 如果图表有语法错误,组件会提供修复选项 已认证的用户可将图表保存到 Mermaid.ai 账号,并通过 save_diagram、update_diagram 和 list_personal_diagrams 进行管理
使用示例 让 Claude 创建任意类型的 Mermaid 图表: “创建一个展示用户登录流程的流程图” “画一个 API 请求流程的时序图” “为 User 模型生成一个类图” “画一个订单生命周期的状态图” “展示我保存的图表” “把这个图表保存到我的账号” Claude 会自动调用合适的工具来渲染、保存或管理你的图表。
故障排查 遇到以下问题时: 无效语法 - 使用小部件中的修复选项,或让 Claude 调用 repair_diagram 工具 渲染问题 - 确保图表代码符合 Mermaid 语法规范 复制功能失效 - 检查是否已为应用启用剪贴板权限 认证问题 - 使用 sign_in 工具重新登录 Mermaid.ai 账户 如需进一步帮助,请在 Mermaid Chart 问题追踪器上报告问题。
让 Claude 创建一个 Mermaid 图表,即可通过交互式小部件即时查看渲染结果!
可用工具 display_mermaid 在交互式 UI 组件中展示 Mermaid 图表。图表通过 Mermaid 库在客户端渲染。需要登录认证。 输入参数: 参数类型 必填 描述 diagramCode string 是 要展示的 Mermaid 图表代码 title string 是 图表标题 documentID string 否 更新已有 documentID 的图表时必须提供;从头创建新图表时应省略 输出: 该工具返回包含以下字段的结构化内容: viewMode - 固定为 "diagramView" title - 图表标题 diagramCode - 原始 Mermaid 代码 documentID - 文档 ID(如有提供) isAuthenticated - 用户是否已登录 remainingCredits - 剩余 AI 额度(已登录时) 工具注解: readOnlyHint: true - 不修改任何数据 openWorldHint: false - 不与外部域名交互 idempotentHint: true - 可安全重复调用 destructiveHint: false - 无破坏性副作用
list_personal_diagrams 列出用户 Mermaid.ai 账户中已保存的 Mermaid 图表。需要登录认证。 输入参数:无 输出: 该工具返回包含以下字段的结构化内容: viewMode - 固定为 "listView" diagrams - { documentID, title } 对象数组 totalCount - 图表总数 isAuthenticated - 用户是否已登录 工具注解: readOnlyHint: true - 不修改任何数据 openWorldHint: false - 不与外部域名交互 idempotentHint: true - 可安全重复调用 destructiveHint: false - 无破坏性副作用
save_diagram 将新图表保存至用户的 Mermaid.ai 账户。此操作需通过身份验证。 输入参数: 参数 类型 是否必需 说明 diagramCode string 是 待保存的 Mermaid 图表代码 title string 否 图表的可选标题 输出: 该工具返回包含以下内容的结构化数据: documentID - 新文档的 ID projectID - 项目 ID id - 文档记录的 ID code - 已保存的图表代码 title - 图表标题 工具注解: readOnlyHint: false - 会创建新文档 openWorldHint: false - 不与外部域名进行交互 idempotentHint: false - 每次调用均创建新文档 destructiveHint: false - 不会覆盖现有数据
update_diagram 更新用户 Mermaid.ai 账户中已有的图表。此操作需通过身份验证。 输入参数: 参数 类型 是否必需 说明 documentID string 是 要更新的文档 ID diagramCode string 是 更新后的 Mermaid 图表代码 title string 否 图表的新可选标题 输出: 该工具返回包含以下内容的结构化数据: documentID - 文档 ID projectID - 项目 ID code - 更新后的图表代码 title - 图表标题 工具注解: readOnlyHint: false - 修改现有文档 openWorldHint: false - 不与外部域名进行交互 idempotentHint: true - 使用相同数据进行更新无额外影响 destructiveHint: true - 会覆盖现有图表数据
repair_diagram 利用 AI 尝试修复无效的 Mermaid 图表。此操作需通过身份验证,若修复成功将消耗 AI 积分。 输入参数: 参数 类型 是否必需 说明 code string 是 待修复的无效 Mermaid 图表代码 error string 是 图表验证产生的错误信息 输出: 该工具返回包含以下内容的结构化数据: diagramCode - 修复后的 Mermaid 图表代码 工具注解: readOnlyHint: false - 消耗 AI 积分 openWorldHint: false - 不与外部域名进行交互 idempotentHint: false - AI 修复结果可能不同,且每次调用均消耗积分 destructiveHint: false - 不会覆盖现有数据
sign_in 触发用户的 Mermaid.ai 账号 OAuth 登录流程。 输入参数:无 输出: 返回登录成功的文本确认信息。 工具注解: readOnlyHint: false - 会建立认证会话 openWorldHint: false - 不与外部域名交互 idempotentHint: true - 多次登录效果相同 destructiveHint: false - 无破坏性副作用 get_diagram_by_url 通过 URL 从用户的 Mermaid 账号获取图表标题和代码。需要认证。 输入参数: 参数类型必填说明urlstring是A MermaidChart diagram URL 输出: 该工具返回包含以下字段的结构化内容: documentID - 文档 ID projectID - 项目 ID code - 图表代码 title - 图表标题 工具注解: readOnlyHint: true - 不修改任何数据 openWorldHint: false - 不与外部域名交互 idempotentHint: true - 可安全地多次调用 destructiveHint: false - 无破坏性副作用
UI 组件 该应用包含一个交互式 UI 组件,展示以下内容: 渲染后的图表 - Mermaid 图表的可视化展示,在客户端渲染 复制代码按钮 - 一键复制图表代码 修复选项 - 如果图表存在语法错误,提供修复选项 图表列表 - 浏览并选择已保存的个人图表 组件权限: clipboardWrite - 允许将图表代码复制到剪贴板
工作原理 当你让 Claude 创建 Mermaid 图表时: Claude 根据你的需求生成 Mermaid 语法 display_mermaid 工具将代码发送到交互式组件 组件使用 Mermaid 库在客户端渲染图表 如果图表有语法错误,组件会提供修复选项 已认证的用户可将图表保存到 Mermaid.ai 账号,并通过 save_diagram、update_diagram 和 list_personal_diagrams 进行管理
使用示例 让 Claude 创建任意类型的 Mermaid 图表: “创建一个展示用户登录流程的流程图” “画一个 API 请求流程的时序图” “为 User 模型生成一个类图” “画一个订单生命周期的状态图” “展示我保存的图表” “把这个图表保存到我的账号” Claude 会自动调用合适的工具来渲染、保存或管理你的图表。
故障排查 遇到以下问题时: 无效语法 - 使用小部件中的修复选项,或让 Claude 调用 repair_diagram 工具 渲染问题 - 确保图表代码符合 Mermaid 语法规范 复制功能失效 - 检查是否已为应用启用剪贴板权限 认证问题 - 使用 sign_in 工具重新登录 Mermaid.ai 账户 如需进一步帮助,请在 Mermaid Chart 问题追踪器上报告问题。
让 Claude 创建一个 Mermaid 图表,即可通过交互式小部件即时查看渲染结果!