跳到主要内容

Google Antigravity 配置指南

配置后，你可以在 Google Antigravity 的 AI 对话中直接操作 CloudBase 服务。

例如：

  • "创建用户表" - AI 自动创建数据库集合
  • "部署这个函数" - AI 自动上传并配置云函数
  • "部署前端到 CDN" - AI 自动上传文件并配置托管

无需切换到云控制台，所有操作都可以在 Google Antigravity 中用自然语言完成。

前置条件​

在开始配置之前，请确保满足以下条件：

已准备好Node.js 环境和云开发环境

Node.js 环境： 确保已安装 Node.js v18.15.0 或更高版本：

node --version

如果未安装，请从 Node.js 官网 下载安装。

云开发环境： 请参考文档 开通云开发环境。新用户可以免费开通体验。

Client

配置你的 MCP 客户端以连接 CloudBase 环境

步骤 1：安装

使用项目模板（推荐） - 模板已内置 MCP 配置和 AI 规则查看模板

将以下配置添加到 .agent/rules/:

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "command": "npx",
5      "args": ["@cloudbase/cloudbase-mcp@latest"],
6      "env": {
7        "INTEGRATION_IDE": "Antigravity"
8      }
9    }
10  }
11}
需要帮助？查看 Google Antigravity 文档

步骤 2：验证连接

配置完成后，在 AI 对话中输入以下内容验证:

prompt
检查 CloudBase 工具是否可用, 下载 CloudBase AI 开发规则到当前项目

配置步骤​

方法一：使用项目模板（推荐）​

使用项目模板可以自动配置 MCP 和规则文件：

npx @cloudbase/cloudbase-mcp downloadTemplate --template rules --ide antigravity

方法二：手动配置​

  1. 创建规则目录

    在项目根目录创建 .agent/rules/ 目录：

    mkdir -p .agent/rules

  2. 配置 MCP 服务器

    在项目根目录创建 .mcp.json 文件，添加以下配置：

    {
      "mcpServers": {
        "cloudbase": {
          "command": "npx",
          "args": ["@cloudbase/cloudbase-mcp@latest"],
          "env": {
            "INTEGRATION_IDE": "Antigravity"
          }
        }
      }
    }

  3. 添加规则文件

    将 CloudBase 规则文件复制到 .agent/rules/ 目录。规则文件支持以下激活方式：

    • Manual: 通过 @ 提及手动激活
    • Always On: 始终应用
    • Model Decision: 基于自然语言描述，模型决定是否应用
    • Glob: 基于 glob 模式（如 .js, src/**/.ts），匹配的文件会自动应用规则

验证连接​

配置完成后，在 Google Antigravity 的 AI 对话中输入：

检查 CloudBase 工具是否可用

如果配置成功，AI 应该能够识别并使用 CloudBase 工具。

常见问题​

Q: MCP 连接失败？ A: 检查配置文件格式是否正确，重启 Google Antigravity，确认网络连接正常。

Q: 规则文件不生效？ A: 检查规则文件的激活方式设置是否正确，确保文件位于 .agent/rules/ 目录下。

Q: 工具数量显示为 0？ A: 请参考常见问题。

更多问题请查看：完整 FAQ

相关资源