进阶 mermaid.ai 2026-11-12 20:48:10 · 24 阅读

第24章 Claude MCP App v2 详解:集成 Mermaid 图表生成与管理

Mermaid Claude MCP 应用 Mermaid Claude MCP 应用允许 Claude 在对话中直接创建、渲染和管理 Mermaid 图表。当要求 Claude 创建流程图、时序图或其他 Mermaid 图表时,该应用会自动处理整个流程——渲染出包含图表、复制功能和无效语法修复选项的交互式组件。经过身份验证的用户可以保存、更新和列出个人图表。 服务器地址: https://chatgpt.mermaid.ai/anthropic/v2/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是MermaidChart 图表 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 请求流程创建时序图” “为用户模型生成类图” “为订单生命周期绘制状态图” “给我看我的已保存图表” “将此图表保存到我的账户” Claude 会自动使用合适的工具来渲染、保存或管理你的图表。
故障排查 如果遇到问题: 语法无效——使用组件中的修复选项,或让 Claude 调用 repair_diagram 工具 渲染问题——确保图表代码符合 Mermaid 语法规范 复制无效——检查应用是否开启了剪贴板权限 认证问题——使用 sign_in 工具重新登录 Mermaid.ai 账号 如需更多帮助,可在 Mermaid Chart Issue Tracker 提交问题。
让 Claude 创建 Mermaid 图表,通过交互式组件即刻查看渲染效果!

评论 (0)