← 返回目录

Mindpilot MCP

社区

通过你的智能体的视角，可视化遗留代码、架构新系统、理解一切。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 280 / 438
Stars: ★ 90 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20.0.0+
凭据: 无需凭据
许可证: MIT
最近提交: 3 个月前

48FMRS · D

Mindpilot MCP 为 AI 编码助手提供了有用的可视化功能，支持在本地生成 Mermaid 图表。它多客户端共享和导出功能良好，但匿名使用跟踪和本地服务器可能需要谨慎。

最强项 · 文档质量 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

8/20

维护活跃度

10/20

文档质量

12/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 证据表明服务器在README中声明的功能（渲染Mermaid图表）与基本设计一致，且提供了Node.js环境要求。然而，源代码未提供，无法验证关键路径（如MCP初始化、工具列表握手、错误处理）的实际实现。缺少测试和CI工作流，无法确认声明功能的可靠性。因此，给予8分。
安全与权限 8/20: 代码未提供，无法检查凭证处理、数据边界或外部网络行为。README提到匿名使用统计，但未提供详细信息。未发现明显的恶意或危险操作。基于有限证据，给予8分，但存在不确定性。
维护活跃度 10/20: 仓库有MIT许可证，活跃度较高（90星，11个未解决问题，未归档）。README显示有版本和发布。但缺少安全响应渠道和详细的维护历史，因此给予10分。
文档质量 12/20: README提供了安装、配置和故障排除的详细说明，包括多种客户端的配置示例。但缺少工具参数、限制和成本说明，且未提供验证性证据。因此给予12分。
安装易用性 10/20: README提供了明确的安装步骤和主流客户端的配置示例。但未提供源代码或验证性证据，因此给予10分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

想要可视化复杂代码库的开发者
使用 AI 编码助手并希望审查生成代码的团队
需要快速架构和流程图的开发者
注重本地数据处理和隐私的用户

不适合谁

不需要可视化图表或图表功能的用户
预算严格、希望完全禁止匿名使用跟踪的团队
需要图表通过云端共享或协作的用户
对 Mermaid 图表格式不熟悉的用户（需要 LLM 来生成语法）

所需权限

本地文件系统访问：在 `~/.mindpilot/data/` 或自定义数据路径中保存图表
网络：启动本地 Web 服务器（默认端口 4000），用于显示图表
匿名使用数据收集：默认启用，可通过 `--disable-analytics` 标志禁用

风险与副作用

默认收集匿名使用数据：可能不符合严格的隐私要求，但可以通过标志禁用
本地服务器在端口 4000 上监听：可能与现有服务冲突
依赖 LLM 生成有效的 Mermaid 语法：生成错误可能导致图表渲染失败
多客户端支持意味着多个会话共享同一个服务器，数据可能被意外暴露给其他本地客户端

安装接入

准备工作

运行环境：Node.js 20.0.0+

### 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mindpilot": {
      "command": "npx",
      "args": [
        "@mindpilot/mcp@latest"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mindpilot -- npx @mindpilot/mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置后重启客户端，让 agent 生成一个图表（例如"create a diagram about x"），浏览器打开 http://localhost:4000 应能看到渲染的 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 错误。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建本项目架构的 C4 上下文图
展示 WebSocket 连接逻辑的状态机
用时序图展示 OAuth 流程

使用场景

可视化遗留代码库的架构，快速理解系统结构。

生成项目架构的 C4 上下文图。

以序列图形式展示 OAuth 流程。

检查 WebSocket 连接逻辑的状态机。

识别 AI 生成代码中的冗余和未使用构造。

支持客户端

Claude Desktop

VS Code

Cursor

Windsurf

Zed

依据项目文档列出，未经本站实测。

详细介绍

Mindpilot MCP 是一个用于生成和渲染 Mermaid 图表的 MCP 服务器。它让你的人工智能编码助手能够按需创建架构、代码和流程图，并在本地 Web 应用中显示，使你能够直观地探索和理解代码库。所有图表均在本地处理，不会发送到云端。支持多客户端共享同一图表集合，并可导出为矢量图像。