内容
# 反重力MCP服务器(实验性)
[](https://opensource.org/licenses/MIT)
[](https://github.com/alama777/antigravity-mcp-experimental)
[](https://open-vsx.org/extension/alama777/antigravity-mcp-experimental)
[](https://open-vsx.org/extension/alama777/antigravity-mcp-experimental)
> 一个实验性扩展,为Google Antigravity IDE引入了多智能体能力的触角,通过添加MCP工具来启动新智能体(启动新聊天)。
> 📚 **注意:** 有关最新说明和文档,请始终参考 [GitHub 仓库](https://github.com/alama777/antigravity-mcp-experimental)。
> [!WARNING]
> **实验性免责声明:** 此扩展程序大量依赖于Antigravity IDE的未文档化的内部功能(例如内部Webview和CDP连接)。因此,**它可能会在Antigravity更新后随时停止工作。** 它是高度实验性的,**不建议在关键或生产项目中使用。**
---
### 📸 概述

*自主智能体委托示例*

*Antigravity IDE中的扩展程序设置*
## 🌟 功能
此扩展程序将Antigravity IDE连接到模型上下文协议(MCP)。它允许AI智能体和外部工具以编程方式读取和写入聊天会话。这使得自动化工作流程、委托任务和启动后台智能体变得容易。
### 🤖 可用MCP工具
要启用这些功能,扩展程序提供了以下工具:
| 工具名称 | 描述 | 参数 |
| :--- | :--- | :--- |
| 💬 **`start_new_chat`** | 启动新的聊天,带有可选的起始提示。使用此工具委托任务给新的“智能体”。 <br>*(注意:此工具仅排队消息,不等待智能体完成回复。)* | `prompt`(字符串,可选) |
| 📨 **`send_prompt`** | 向活动(主/主要)聊天发送新的提示。返回确认字符串。 <br>*(注意:此工具仅排队消息,不等待智能体完成回复。)* | `prompt`(字符串,必填) |
| 🔍 **`get_active_chat`** | 获取活动(主/主要)聊天的ID、标题和消息数。返回带有`id`、`title`和`messageCount`的JSON对象。 | *无* |
> [!IMPORTANT]
> **执行范围和限制:** 这些MCP工具**仅与位于主Google Antigravity编辑器窗口侧边栏的主要聊天**交互。您可以从任何地方触发这些命令(从Agent Manager中的子智能体聊天,从Claude Desktop等),但操作将**始终**应用于主要IDE聊天界面。
>
> **超出范围(MCP无法执行的操作):**
> - 它无法读取或与通过Agent Manager在单独窗口中打开的聊天进行交互。
> - 它无法以编程方式选择或在现有历史聊天之间切换。
> [!TIP]
> **后台执行:** 当您触发 `start_new_chat` 时,主要IDE视图切换到新会话,但**您的前一个聊天不会中断**。它将继续在后台工作并生成响应!您可以通过聊天历史下拉菜单返回聊天,或使用Antigravity Agent Manager打开它。
> ⚙️ **技术要求:** 使用 `start_new_chat` 或 `send_prompt` 编写聊天依赖于内部IDE API,**不需要**调试端口。但是,读取聊天状态使用 `get_active_chat` 依赖于CDP Scraper,这意味着IDE**必须**使用 `--remote-debugging-port=9222` 标志启动。
> **💡 注意:** 确保您已正确配置Antigravity IDE,以便此扩展程序与Antigravity IDE交互。
#### 💡 现实世界用例(模式):
1. **任务委托(智能体到智能体):**
您要求您的活动Antigravity智能体实现一个大型功能。智能体意识到任务对于一个上下文窗口来说太复杂了,因此它使用 `start_new_chat` 并带有提示 *"编写后端测试..."* 以自主方式启动新的专用子智能体!
2. **“图书管理员”模式(卸载研究):**
您正在进行一个复杂的重构任务,而您的上下文窗口充满了源代码。您突然需要了解特定外部API的工作原理。为了避免污染您的活动上下文,您的智能体使用 `start_new_chat` 并带有提示: *"搜索网络上的Stripe API文档,找出路由并保存摘要到 `stripe_tips.md`"*. 新的智能体在后台充当图书管理员!
3. **自主智能体链:**
您可以指示您的活动智能体创建复杂的工作流程。例如: *"将后端审查委托给新的智能体。告诉它将审查结果保存到 `review.md`,然后指示它启动另一个新的智能体作为开发人员来立即处理这些结果。"* 这允许您构建自我编排的智能体团队!
4. **上下文管理和迁移:**
智能体使用 `get_active_chat` 验证其当前会话深度(消息数)。如果上下文变得太长,您可以指示它: *"总结我们的当前聊天,然后启动一个带有该总结的新聊天"*. 智能体生成总结并执行 `start_new_chat` 以无缝迁移您的工作流程到新的会话,避免令牌限制。
5. **外部集成(脚本编写):**
您仍然可以从外部命令IDE!例如,简单的外部监视bash脚本检测到服务器崩溃,并使用 `send_prompt` 通过代理将错误日志推送到您的活动Antigravity聊天中。
6. **持续TDD循环:**
外部监视器脚本监视您的文件系统。每次您保存文件时,它都会运行您的测试套件。如果测试失败,脚本会自动使用 `send_prompt` 将失败的日志推送到您的活动聊天中: *"您的上一次保存破坏了测试。以下是输出: [...]。请修复代码。"* 您的智能体修复了它,从而驱动了一个完全自动化的测试驱动开发循环。
7. **CI/CD集成(实时警报):**
当您在本地工作时,GitHub Actions管道在云中失败。CI/CD服务器使用 `send_prompt` ping您的本地代理,将消息注入您的IDE: *"Pipeline #402在Docker Build步骤中刚刚失败。以下是日志:[link]"*. 您的活动聊天成为实时通知中心。
8. **“沉默的批评者”(后台代码审查):**
外部守护进程定期检查您的 `get_active_chat` 状态。如果它注意到您5分钟内没有输入任何内容,它会使用 `start_new_chat` 启动后台智能体: *"对今天更改的所有文件进行完整的代码审查,并在代码中留下TODO注释。"* 它在后台执行此操作,不会打断您的主聊天窗口。
9. **“终端到IDE”管道:**
您的本地构建脚本失败,并出现巨大的、神秘的堆栈跟踪。您不是手动复制和粘贴日志到IDE,而是配置shell别名(例如 `fix-it`)。现在,运行 `make build || fix-it` 会自动捕获失败的输出并将其管道输入 `stdio-proxy.mjs`。错误通过 `send_prompt` 发送到您的活动聊天,准备好让智能体修复!
10. **“合并冲突谈判者”:**
您拉取 `main` 并在一个2000行的文件中遇到一个可怕的合并冲突。您不是在主要聊天中解决它(它被当前功能的业务逻辑污染),而是使用 `start_new_chat`: *"我在 `api.ts` 中有一个巨大的git冲突。读取标记并安全地组合逻辑。"* 这将复杂的高上下文任务隔离到一个新的会话中,从而保留您的主要聊天的思维模型。
## 📥 安装
有关完整的设置和安装说明,请仔细参考 [**INSTALL.md**](INSTALL.md) 指南,然后再继续。
## 🚀 使用方法
要开始使用此扩展程序:
1. **启动编辑器(推荐):** 如果您想使用 `get_active_chat` 工具(例如,让智能体读取聊天历史记录),请启用远程调试标志启动Antigravity编辑器:
```bash
antigravity --remote-debugging-port=9222
```
*(注意:如果您只打算使用 `start_new_chat` 或 `send_prompt`,可以跳过此标志。)*
2. 在Antigravity中按 `Ctrl+Shift+P` (或Mac上的 `Cmd+Shift+P` )并输入 `Antigravity MCP: Start Server`,如果它没有自动启动。
3. 启动服务器后, **AntigravityMCP** 将在Antigravity本身的MCP服务器设置部分中可用,允许内部智能体使用其工具。
4. **从Antigravity外部访问:** 要将外部AI客户端连接到IDE,您必须配置它执行代理脚本( `node bin/stdio-proxy.mjs` )。请参考 **[INSTALL.md](INSTALL.md)** 以获取详细的集成示例(例如Claude Desktop)。
## ⚙️ 要求
* 本地安装Antigravity IDE。
* Node.js(用于运行 `bin/stdio-proxy.mjs` 脚本)。
## 🛠 扩展程序设置
您可以通过在 `settings.json` 中调整以下设置来自定义扩展程序行为:
| 设置 | 描述 | 默认值 |
| --- | --- | --- |
| `antigravity-mcp.host` | HTTP MCP和仪表板服务器绑定的主机 | `127.0.0.1` |
| `antigravity-mcp.port` | HTTP MCP和仪表板服务器运行的端口 | `3033` |
| `antigravity-mcp.cdpHost` | Antigravity CDP(Chrome DevTools Protocol)的主机 | `localhost` |
| `antigravity-mcp.cdpPort` | CDP连接的端口(Antigravity IDE公开的调试端口)| `9222` |
> [!NOTE]
> **需要重启:** 为了确保您的新设置可靠地应用,并且**在安装扩展程序的新版本后**,请**重启Antigravity IDE**。
> [!TIP]
> **故障排除设置:** 如果 `AntigravityMCP` 服务器在IDE的MCP设置面板中显示错误(这可能在修改设置或更新扩展程序后发生),请尝试将其 **关闭然后再次打开** 。这强制IDE干净地重新读取更新的配置。扩展程序正确地尊重 `mcp_config.json` 中的 `disabled: true` 状态,这意味着如果您故意关闭代理,扩展程序将保留您的偏好并且不会强制启用它。此外,您可以随时通过检查IDE的 **输出** 面板(具体来说是 **“Antigravity MCP”** 通道)来监视详细的系统消息和诊断日志。
## 🏰 架构与开发
如果您是开发人员(或AI智能体),希望了解内部代理、Express服务器和CDP WebSocket的工作原理,或者希望为代码库做出贡献,请参考我们的完整 **[架构与开发指南](ARCHITECTURE.md)**。
## ⚠️ 已知问题
- **需要端口9222进行读取:** 端口9222对于读取聊天历史记录是必需的。虽然您可以发送命令( `start_new_chat` 、 `send_prompt` )而无需它,但完整的功能(例如 `get_active_chat` )需要使用 `--remote-debugging-port=9222` 标志启动Antigravity。
## 📝 版本说明
有关详细的发布历史,请参见 [CHANGELOG.md](CHANGELOG.md)。
---
## 🤝 贡献
我们欢迎拉取请求!如果您有兴趣帮助开发:
1. 在 [https://github.com/alama777/antigravity-mcp-experimental](https://github.com/alama777/antigravity-mcp-experimental) 处分叉仓库
2. 创建您的功能分支( `git checkout -b feature/AmazingFeature` )
3. 提交您的更改( `git commit -m 'Add some AmazingFeature'` )
4. 将其推送到分支( `git push origin feature/AmazingFeature` )
5. 打开拉取请求!
如果您发现一个错误,请创建一个 [问题](https://github.com/alama777/antigravity-mcp-experimental/issues)。
## 📄 许可证
该项目根据MIT许可证授权 - 有关详细信息,请参阅 [LICENSE](LICENSE) 文件。
连接信息
猜你喜欢
rea
用于编码代理的逆向工程:一个 CLI 和 MCP 服务器,用于检查任何应用程序,了解其功能,并按照您的方式构建它们。
everything-claude-code
完整的 Claude Code 配置集合 - agents、skills、hooks、commands、rules、MCPs。来自 Anthropic...
MarkItDown MCP
MarkItDown-MCP是一个轻量级服务器,用于将URI转换为Markdown。
cc-switch
跨平台的Claude Code、Codex和Gemini CLI一体化助手。
Agent-Reach
赋予你的AI Agent观察整个互联网的眼睛。读取并搜索...
servers
# 模型上下文协议服务器