内容
# 🧠 MCP 协作系统：大脑 + 图谱 + 双手
一款使用 **模型上下文协议（MCP）** 构建的超高效、高度协作的智能编码框架。该系统在规划、结构代码理解和执行之间建立分工，优化性能并降低成本。
---
## ⚡ 核心优势
* **📉 90% Token 成本降低：** **代码审查图谱** 索引您的存储库，并允许代理仅请求所需的最精确的最小行范围。不再需要将整个文件或递归目录转储到上下文窗口中。
* **🛡️ 回归和错误预防：** 通过将编码任务委派给 **OpenHands** 的沙盒实例，代码运行并在将更改写回之前验证测试。这隔离了语法和逻辑错误。
* **🧩 真正的关注点分离：**
* **大脑（协调器）：** 管理规划、规范和架构。
* **图谱（代码审查图谱）：** 提供深入的代码分析、社区识别和影响半径。
* **双手（OpenHands）：** 在干净的环境中执行代码编辑、构建和验证。
---
## 🔄 独立核心更新
为了确保您的环境始终保持与最新功能的更新，核心工具 **不会** 在此存储库中冻结。您直接从其官方来源下载并更新它们：
1. **OpenHands：** 您直接从 [官方 OpenHands GitHub 存储库](https://github.com/All-Hands-AI/OpenHands) 克隆和更新。
2. **代码审查图谱：** 您使用其官方包管理器全局安装和升级。
此存储库仅作为您的自定义集成、路由规则（`AGENTS.md`）和 FastMCP 连接层。
---
## ⚙️ 设置指南
### 1. 先决条件
确保您的机器上已安装以下内容：
* [Docker Desktop](https://www.docker.com/products/docker-desktop/)（运行 OpenHands 和 GitHub MCP Server 所需）
* [Python 3.10+](https://www.python.org/) 和 [uv](https://github.com/astral-sh/uv)（运行 python MCP 服务所需）
* [Node.js](https://nodejs.org/)（运行 Stitch / NPX 命令所需）
### 2. 核心设置
#### 步骤 A：设置代码审查图谱
在您的系统上全局安装 `code-review-graph`。按照您所使用的操作系统的官方安装说明，确保 `code-review-graph` CLI 在您的系统路径上可访问。
#### 步骤 B：设置 OpenHands
1. 克隆官方 OpenHands 存储库：
```bash
git clone https://github.com/All-Hands-AI/OpenHands.git
```
2. 根据 [开发指南](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md) 构建并运行 OpenHands 本地容器/实例。
3. 记录本地 URL（通常为 `http://localhost:8000`）和 API 令牌。
---
## 🚀 轻松上线（LLM 引导）
此工作区包含运行系统所需的配置文件和自定义规则。当您在智能 IDE（例如 Antigravity、Cursor 或带有 Cline 的 VS Code）中打开此工作区时，将以下提示复制并粘贴到代理的聊天窗口中。
代理将自动定位您的路径并设置本地 `mcp_config.json` 文件。
### 📋 复制粘贴上线提示：
```markdown
请帮助我引导我的本地 Antigravity 环境。
您需要创建我的用户特定的 `mcp_config.json` 文件。请通过执行以下步骤引导我：
1. 检测我计算机上此工作区的绝对路径。
2. 要求我粘贴我的 GitHub 个人访问令牌（PAT）。
3. 在我的本地目录中创建（或覆盖）`mcp_config.json` 文件，路径为：
`C:\Users\<my_username>\.gemini\antigravity-ide\mcp_config.json`
4. 使用以下 JSON 模板，替换检测到的工作区路径和您提供的 GitHub PAT：
{
"mcpServers": {
"github-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<INSERT_USER_GITHUB_TOKEN>"
}
},
"code-review-graph": {
"command": "code-review-graph",
"args": [
"serve",
"--auto-watch"
]
},
"openhands": {
"command": "uv",
"args": [
"run",
"<DETECTED_WORKSPACE_PATH>/infrastructure/openhands_mcp.py"
]
}
}
}
当您写入文件后，请验证配置并在我们准备好构建时确认。
```
*(注意：如果您正在使用带有 Cline 扩展的 VS Code，请指示代理将配置写入 `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`。)*
