用途:把 Mermaid ERD 的整个工作流一次性处理完,包括 MCP 环境检查、mmd 生成、浏览器预览、PNG/SVG 保存,以及可选的 Git 提交。适用于需要维护数据库设计可视化、更新 ERD、增删表或修改关系时。
主要能力与产物:ERD 源码保存在 docs/erd/erd.mmd,PNG 渲染输出到 docs/erd/erd.png,SVG 渲染输出到 docs/erd/erd.svg,后两者用于提交到 git。
使用方式:先确认 mermaid MCP 是否注册,可用 claude mcp list 2>/dev/null | grep mermaid 检查;未注册时执行 npm install -g claude-mermaid 与 claude mcp add --scope user mermaid claude-mermaid,之后需重启 Claude Code 才能启用 MCP。若 docs/erd/erd.mmd 不存在,会创建目录并用默认模板生成文件(erDiagram + 示例实体)。修改后用 git diff --name-only | grep "erd.mmd" 判断是否变更:已修改则同时执行浏览器预览(mcp__mermaid__mermaid_preview,preview_id 为 erd-main,尺寸 1400x1200,scale 2)与 CLI 渲染保存 npx @mermaid-js/mermaid-cli@latest -i docs/erd/erd.mmd -o docs/erd/erd.png -s 2 以及同一命令输出 erd.svg;若预览失败则仅执行 CLI,保证 PNG/SVG 保存,并提示重启或注册 MCP。未修改时只做预览,不重新渲染。最后报告预览 URL 与文件路径,并检查 git 状态,询问是否提交、仅暂存或不处理。
ERD 编写规则:实体名用 ["英文名 (韩文名)"] 形式,关系线上只写实体名,否则渲染出错。索引标记写在列注释末尾方括号内:一般索引 [IDX]、Partial Index [PIDX]、唯一索引 [UIDX]、复合 Partial Index 形如 [PIDX:a+b]。主表审计字段为 is_delete、insert_seq、insert_date、update_seq、update_date,历史表仅 insert_seq、insert_date。
限制:资料未提供收费、价格、平台支持范围等其他信息。