适合谁
- 想要可视化复杂代码库的开发者
- 使用 AI 编码助手并希望审查生成代码的团队
- 需要快速架构和流程图的开发者
- 注重本地数据处理和隐私的用户
M
48FMRS · D
Mindpilot MCP 为 AI 编码助手提供了有用的可视化功能，支持在本地生成 Mermaid 图表。它多客户端共享和导出功能良好，但匿名使用跟踪和本地服务器可能需要谨慎。
Mindpilot MCP 是一个用于生成和渲染 Mermaid 图表的 MCP 服务器。它让你的人工智能编码助手能够按需创建架构、代码和流程图，并在本地 Web 应用中显示，使你能够直观地探索和理解代码库。所有图表均在本地处理，不会发送到云端。支持多客户端共享同一图表集合，并可导出为矢量图像。
工具能力
暂未整理工具清单。
安装接入
### Claude Code
运行 claude mcp add mindpilot -- npx @mindpilot/mcp@latest
### Cursor
在 Settings > Cursor Settings > MCP 中添加全局 MCP 服务器，配置如下：
{
"mcpServers": {
"mindpilot": {
"command": "npx",
"args": ["@mindpilot/mcp@latest"]
}
}
}### VS Code
按照 [VS Code MCP 指南](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) 启用 MCP，然后在 settings json 中添加：
{
"mcp": {
"servers": {
"mindpilot": {
"type": "stdio",
"command": "npx",
"args": ["@mindpilot/mcp@latest"]
}
}
}
}### Windsurf
在 Settings > Windsurf Settings > Manage Plugins 中查看原始配置，并在 mcpServers 对象中配置。
### Zed
在 AI 线程面板中点击三个点 ...，然后选择 Add Custom Server...，在命令字段输入 npx @mindpilot/mcp@latest。
claude_desktop_config.json
{
"mcpServers": {
"mindpilot": {
"command": "npx",
"args": [
"@mindpilot/mcp@latest"
]
}
}
}
选型与风险
不适合谁
- 不需要可视化图表或图表功能的用户
- 预算严格、希望完全禁止匿名使用跟踪的团队
- 需要图表通过云端共享或协作的用户
- 对 Mermaid 图表格式不熟悉的用户（需要 LLM 来生成语法）
所需权限
- 本地文件系统访问：在 `~/.mindpilot/data/` 或自定义数据路径中保存图表
- 网络：启动本地 Web 服务器（默认端口 4000），用于显示图表
- 匿名使用数据收集：默认启用，可通过 `--disable-analytics` 标志禁用
风险与副作用
- 默认收集匿名使用数据：可能不符合严格的隐私要求，但可以通过标志禁用
- 本地服务器在端口 4000 上监听：可能与现有服务冲突
- 依赖 LLM 生成有效的 Mermaid 语法：生成错误可能导致图表渲染失败
- 多客户端支持意味着多个会话共享同一个服务器，数据可能被意外暴露给其他本地客户端
常见排障
- 如果存在端口冲突，使用 `--port 5555` 指定不同的端口。
- 如果使用 asdf 并有 MCP 问题，从主目录设置全局 Node.js 版本（`asdf set nodejs x.x.x`）。
- 确保 Node.js 版本为 v20.0.0 或更高。
- 如果图表未显示，请检查本地 Web 应用是否在 `http://localhost:4000` 运行（或自定义端口）。
- 对于开发，以 `--debug` 标志运行 Claude 以查看 MCP 错误。
使用场景
可视化遗留代码库的架构，快速理解系统结构。
生成项目架构的 C4 上下文图。
以序列图形式展示 OAuth 流程。
检查 WebSocket 连接逻辑的状态机。
识别 AI 生成代码中的冗余和未使用构造。
支持客户端
Claude Desktop完整支持
VS Code完整支持
Cursor完整支持
Windsurf完整支持
Zed完整支持