Mindpilot MCP 是一个用于在本地 Web 应用中可视化代码、架构及其他概念的 Mermaid 图表生成与渲染工具，主要面向使用 AI 编码智能体的开发者。其核心目的是帮助开发者从不同视角理解遗留代码、检查复杂流程、审视 AI 生成代码中的冗余结构，并辅助设计新系统。
主要能力：
- 按需生成架构、代码和流程示意图：通过自然语言请求，AI 智能体会调用 MCP 服务器生成 Mermaid 图并在浏览器中渲染。
- 支持多种图表类型：如状态机图、C4 上下文图、时序图等。
- 本地处理：图表不会发送到云端，整个过程仅在用户、智能体和智能体所用 LLM 提供商之间进行。
- 导出与分享：可将任意图表导出为矢量图像。
- 多客户端支持：同时运行多个 AI 助手（如多个 Claude Desktop 窗口或 IDE 实例）时，首个使用 Mindpilot 的 MCP 客户端启动共享 Web 服务器，其他助手自动连接，共享同一份图表历史与 Web 界面；最后一个客户端断开后服务器约一分钟自动关闭。
- 匿名使用数据收集：默认收集匿名使用数据，可通过参数禁用。
使用方式： 需要 Node.js v20.0.0 或更高版本。 可作为 MCP 服务器安装到各类编码智能体中。例如在 Claude Code 中运行：claude mcp add mindpilot -- npx @mindpilot/mcp@latest 在 Cursor 中，进入 Settings > Cursor Settings > MCP，点击 Add new global MCP server，在 mcpServers 对象中配置 mindpilot。 VS Code 需按官方指引启用 MCP（参考 https://code.visualstudio.com/docs/copilot/chat/mcp-servers）。 Windsurf 中进入 Settings > Windsurf Settings > Manage Plugins，点击 view raw config 并在 mcpServers 对象中配置 mindpilot。 在 AI Thread 面板中点击三个点 ...，选择 Add Custom Server...，在 Command to run MCPserver 字段输入 npx @mindpilot/mcp@latest 并点击 Add Server。
配置选项：
- 端口：服务器默认端口为 4000，可通过 --port 命令行开关修改。
- 数据路径：图表默认保存到 ~/.mindpilot/data/，可通过 --data-path 指定自定义位置。
- 禁用分析：在 MCP 配置中添加 --disable-analytics 标志即可禁用匿名数据收集。
使用 MCP 服务器：配置完成后，可向编码智能体发出如“创建一个关于 x 的图表”等请求，智能体会使用 MCP 服务器在浏览器中渲染 Mermaid 图。示例请求包括："Show me the state machine for WebSocket connection logic"、"Create a C4 context diagram of this project's architecture."、"Show me the OAuth flow as a sequence diagram"。MCP 设计为接受 Mermaid 语法并在 http://localhost:4000（默认端口）上运行的 Web 应用中渲染图表。
轻量技能替代：Mindpilot 现在也提供轻量智能体技能，无需本地 MCP 服务器。安装命令：npx skills add abrinsmead/skills/mermaid-viewer。安装后，让智能体生成图表，它会构建一个自包含、可交互的 Mermaid 查看器，可在浏览器中打开或作为 Claude artifact 发布。
故障排除：
- 若端口 4000 被其他服务占用，可配置不同端口，例如：claude mcp add mindpilot -- npx @mindpilot/mcp@latest --port 5555
- 自定义数据路径示例：claude mcp add mindpilot -- npx @mindpilot/mcp@latest --data-path /path/to/custom/location
- 使用 asdf 版本管理器时若 MCP 无法工作，可能需要在主目录设置“全局” nodejs 版本。
开发配置： 在编码智能体中配置 MCP，例如使用 claude：claude mcp add mindpilot -- npx tsx <path to...>/src/server/server.ts 如需查看 MCP 错误，运行 claude 时加上 --debug 标志。 启动开发客户端（Vite）以获得热模块重载，打开本地开发客户端 localhost:5173。
适用场景：可视化遗留代码、检查复杂流程、AI 生成代码的“氛围检查”（发现需清理的区域）、辅助系统架构设计，以及需要将图表导出为矢量图像进行分享的场景。
