内容
# 抗重力-克劳德-MCP
> **给克劳德代码一个第二大脑。** 在克劳德代码内部,询问谷歌抗重力 — Gemini 3 Pro、克劳德或GPT-OSS — 进行独立的代码审查或第二意见,只需一个命令。无需依赖。
[](https://www.npmjs.com/package/antigravity-claude-mcp)
[](https://nodejs.org)
[](./LICENSE)
```bash
claude mcp add antigravity -- npx -y antigravity-claude-mcp
```
就这样。重启克劳德代码,克劳德现在可以调用 **`ask_antigravity`** 来获取第二个模型的意见,适用于任何计划或差异。
---
## 为什么
克劳德审查自己的代码只是克劳德审查自己的代码。你不能通过更努力思考来发现自己的盲点 — 你需要用 **不同的思维** 来发现它们。
这将 [克劳德代码](https://docs.anthropic.com/en/docs/claude-code) 连接到 [谷歌抗重力的CLI](https://antigravity.google) (`agy`),这样克劳德可以将计划或差异交给 **不同的模型家族** (默认为Gemini 3 Pro)并获得独立的裁决 — 在你之前。两个模型检查工作;你做出决定。
这是简单循环背后的线路:
```
你 ── 提示 ──▶ 克劳德验证 ──▶ 请求抗重力(Gemini) ──▶ 他们同意一个计划
│
你批准 ◀── 抗重力审查差异 ◀── 克劳德编写代码
```
参见 [`examples/CLAUDE_ANTIGRAVITY_LOOP.md`](./examples/CLAUDE_ANTIGRAVITY_LOOP.md) 以获取完整的工作协议,您可以将该协议添加到任何项目中。
---
## 快速入门(2分钟)
**1. 安装抗重力CLI** (如果您没有安装)并登录一次:
```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
~/.local/bin/agy -p "ping" --print-timeout 5m # 首次打开谷歌登录页面
```
**2. 将MCP服务器添加到克劳德代码:**
```bash
claude mcp add antigravity -- npx -y antigravity-claude-mcp
```
**3. 检查是否健康** (可选):
```bash
npx antigravity-claude-mcp doctor
```
**4. 重启克劳德代码**,运行 `/mcp` 以批准该工具,并询问:
> “使用 `ask_antigravity` 审查我在 `src/auth.ts` 中的更改是否存在边缘情况。”
---
## 工作原理
```
┌────────────┐ MCP(stdio, ┌─────────────────────────┐ agy -p ┌──────────────────┐
│ 克劳德代码│ JSON-RPC 2.0) │ antigravity-claude-mcp │ --model … │ 抗重力CLI │
│ (克劳德) │ ───────────────▶ │ ask_antigravity 工具 │ ───────────▶ │ Gemini 3 Pro / │
│ │ ◀─────────────── │ (此软件包) │ ◀─────────── │ 克劳德 / GPT-OSS │
└────────────┘ 工具结果 └─────────────────────────┘ 标准输出 └──────────────────┘
```
该软件包是一个小型stdio MCP服务器,它会调用 `agy -p` (抗重力的无头打印模式),可选地添加文件/文件夹作为上下文,并将模型的文本返回给克劳德。
### `ask_antigravity` 工具
| 参数 | 类型 | 必需 | 描述 |
|---------|------------|----------|-------------|
| `prompt`| 字符串 | ✅ | 问题,建议方法或审查请求。 |
| `paths` | 字符串数组 | | 绝对文件/文件夹路径。抗重力读取它们 **全部** 作为上下文。 |
| `model` | 字符串 | | 重写模型(见下文)。默认值:`Gemini 3.1 Pro (High)`。 |
---
## 模型
您的抗重力账户通过 `agy models` 公开的内容,例如:
- `Gemini 3.1 Pro (High)` ← **默认** (强大,且与克劳德不同的家族)
- `Gemini 3.5 Flash (Low|Medium|High)` (快速/廉价)
- `克劳德 Sonnet 4.6 (Thinking)`,`克劳德 Opus 4.6 (Thinking)`
- `GPT-OSS 120B (Medium)`
> **为什么默认使用Gemini,而不是克劳德?** 重点是 **独立** 的审查。使用克劳德模型审查克劳德的工作会削弱交叉检查。如果您想使用特定的模型,可以通过 `model` 参数覆盖。
---
## 配置
在MCP服务器上设置环境变量(例如,通过 `claude mcp add ... -e KEY=VAL`):
| 变量 | 默认 | 用途 |
|---------------|-------------------------|---------|
| `AGY_BIN` | 自动检测 | `agy` 二进制文件的绝对路径。 |
| `AGY_MODEL` | `Gemini 3.1 Pro (High)` | 每次调用的默认模型。 |
| `AGY_TIMEOUT` | `5m` | 无头打印超时。 |
---
## 故障排除
**`agy` 运行但打印“传递给Electron/Chromium”的警告。**
您已安装抗重力 **IDE** ,而 `PATH` 上的纯 `agy` 是 `Antigravity.app` 的符号链接 — 那是编辑器,而不是CLI。此软件包会自动检测并跳过它,而是使用 `~/.local/bin/agy` 处的真实CLI。如果您手动调用 `agy` ,请使用完整路径或设置 `AGY_BIN`。
**“需要身份验证。”**
登录一次交互式:`~/.local/bin/agy -p "ping" --print-timeout 5m`,打开打印的谷歌链接,批准并粘贴代码回该提示。
**工具未出现在克劳德代码中。**
在 `claude mcp add` 后重启克劳德代码,然后运行 `/mcp` 并批准 `ask_antigravity`。`claude mcp list` 应该显示 `antigravity ✔ 已连接`。
---
## 与代理对比
一些项目通过Anthropic兼容的代理(即克劳德代码“由”抗重力提供支持)路由克劳德代码的 **自身** 流量。这是相反且互补的:克劳德代码保持克劳德,抗重力成为克劳德可以咨询的 **工具** — 因此您在一个循环中获得两个真正不同的模型,而不是用一个替换另一个。
---
## 要求
- [克劳德代码](https://docs.anthropic.com/en/docs/claude-code) CLI
- [抗重力CLI](https://antigravity.google) (`agy`),已登录
- Node.js ≥ 18
## 许可证
MIT © Arjun Thilak