此页面由 Cloud Translation API 翻译。

将 Firestore 与 MCP、Gemini CLI 和其他代理搭配使用

本页介绍了如何将 Firestore 数据库连接到各种开发者工具。

为了获得集成式体验，我们建议使用 Gemini CLI 专用的 Firestore 扩展程序。作为 Google Cloud 的新一代命令行界面，Gemini CLI 直接将底层 MCP 服务器捆绑到扩展程序中，从而无需单独设置服务器。您可以将 Gemini Code Assist 配置为使用 Gemini CLI，从而在 IDE 中获得类似的设置优势。

对于支持 Model Context Protocol (MCP) 的其他开发者工具，您可以通过手动配置 MCP Toolbox for Databases 来进行连接。MCP Toolbox 是一款开源 MCP 服务器，可通过管理身份验证和连接池等任务，将 AI 智能体连接到您的数据。这样一来，您就可以直接在 IDE 中使用自然语言与数据互动。对于这些工具，此方法提供了核心数据库交互功能。本页介绍如何使用 MCP Toolbox for Databases 通过以下 IDE 将开发者辅助工具公开给 Firestore 实例：

Gemini CLI
Gemini Code Assist
Cursor
Windsurf (Codium)
Visual Studio Code (Copilot)
Cline（VS Code 扩展程序）
Claude Desktop
Claude code

Gemini CLI 和扩展服务简介

Gemini CLI 是一款开源 AI 智能体，旨在通过协助编码、调试、数据探索和内容创建来帮助完成开发工作流程。其使命是为与 Data Cloud 服务和热门开源数据库的互动提供代理接口。

扩展程序的运作方式

Gemini CLI 具有高度可扩展性，可通过扩展程序添加新工具和功能。您可以从 GitHub 网址、本地目录或可配置的注册表中加载扩展程序。它们提供新的工具、斜杠命令和提示，可帮助您完成工作流程。

使用适用于 Firestore 的 Gemini CLI 扩展程序

与 Gemini CLI 的集成是通过专用扩展程序实现的，与标准 MCP 工具箱连接相比，该扩展程序提供了更多功能。该扩展程序提供简化的安装流程和一套工具。该开源扩展程序包含有关安装、配置和使用示例的详细信息。如需了解详情，请参阅 Gemini CLI 扩展程序 - Firestore。

firestore-native 扩展程序包含用于查询数据库、更新文档和管理 Firestore 安全规则的工具。

类别	工具	自然语言提示示例
文档和数据检索	`get_documents`	显示 users-staging 集合中测试用户 qa_user_123 和 qa_user_456 的 Firestore 数据。
	`list_collections`	列出 users-staging 集合下的所有子集合。
	`query_collection`	查找 users-staging 集合中心愿单包含 product-glasses 的所有用户。
文档更新和删除	`add_documents`	向 users-staging 集合添加文档 qa_user_789，其中包含以下字段：name: tester1 和 location: USA。
	`delete_documents`	从 users-staging 集合中删除文档 qa_user_789。
	`update_document`	更新 orders 集合中 ID 为 order-987 的文档，将状态设置为“Shipped”。对于您刚刚找到的所有 20 位测试用户，请从他们的心愿单中移除 product-glasses（不活跃）。
安全规则管理	`get_rules`	显示此数据库的有效 Firestore 安全规则。
安全规则管理	`validate_rules`	new_rules.txt 是我正在为测试环境开发的新 Firestore 安全规则。您能帮我验证一下吗？

准备工作

如需使用 Gemini CLI 扩展程序中的 Firestore 工具，您必须拥有以下 Identity and Access Management (IAM) 角色之一，或者拥有具有同等权限的自定义角色：

任务	角色名称	所需的 Identity and Access Management (IAM) 角色
在 Firestore 数据库中读取和写入数据	Cloud Datastore 用户	`roles/datastore.user`
查看和测试安全规则	Firebase Rules Viewer	`roles/firebaserules.viewer`

设置 Firestore

创建新的 Google Cloud 项目或选择现有项目。
为您的项目启用 Firestore 原生模式 API。
创建 Firestore 数据库（如果您尚未创建）。
为本地环境设置身份验证。
- 安装 gcloud CLI
- 运行 gcloud auth application-default login 进行身份验证

配置 MCP 客户端

本部分介绍了如何配置各种开发者工具，以便使用 MCP Toolbox for Databases 连接到 Firestore 实例。该工具箱充当位于 IDE 和数据库之间的开源 Model Context Protocol (MCP) 服务器，为 AI 工具提供安全高效的控制平面。选择以下任一工具对应的标签页，查看配置说明。

Gemini CLI

安装 Gemini CLI。

使用以下命令从 GitHub 代码库安装 Gemini CLI 的 Firestore 扩展程序：

gemini extensions install https://github.com/gemini-cli-extensions/firestore-native

设置环境变量以连接到 Firestore 数据库。 FIRESTORE_DATABASE 变量是可选的，默认值为 (default)：
```
export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"
```
用于 Firestore 的 Gemini CLI 扩展程序使用您的应用默认凭据 (ADC) 进行身份验证。
以交互模式启动 Gemini CLI：
```
gemini
```
CLI 会自动加载 Firestore 扩展程序（适用于 Gemini CLI 扩展程序）及其工具，您可以使用这些工具与数据库进行交互。

Gemini Code Assist

我们建议您将 Gemini Code Assist 配置为使用 Gemini CLI，这样就不需要手动配置 MCP 服务器。

确保您已安装并配置 Gemini CLI 和 firestore-native 扩展程序。
将 Gemini Code Assist 配置为使用 Gemini CLI。
直接在 Gemini Code Assist 对话中开始使用自然语言与 Firestore 数据库互动。

Claude Code

安装 MCP Toolbox for Databases

以二进制文件形式下载最新版本的 Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 V0.15.0 版或更高版本的 Toolbox。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
将该二进制文件设为可执行文件。
```
chmod +x toolbox
```
验证安装。
```
./toolbox --version
```

连接到 MCP 服务器

安装 Claude Code。
在项目根目录中创建 .mcp.json 目录（如果尚不存在）。
添加以下配置，将环境变量替换为您的值，然后保存。 FIRESTORE_DATABASE 变量是可选的，默认值为 (default)。

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

重启 Claude Code 以应用新配置。

Claude Desktop

安装 MCP Toolbox for Databases

以二进制文件形式下载最新版本的 Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 V0.15.0 版或更高版本的 Toolbox。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
将该二进制文件设为可执行文件。
```
chmod +x toolbox
```
验证安装。
```
./toolbox --version
```

连接到 MCP 服务器

打开 Claude Desktop，然后前往设置。
在开发者标签页中，点击修改配置以打开配置文件。
添加以下配置，将环境变量替换为您的值，然后保存。 FIRESTORE_DATABASE 变量是可选的，默认值为 (default)。

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

重启 Claude Desktop。
在新聊天界面中，您应该会看到锤子 (MCP) 图标，表示有新的 MCP 服务器可用。

Cline

安装 MCP Toolbox for Databases

以二进制文件形式下载最新版本的 Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 V0.15.0 版或更高版本的 Toolbox。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
将该二进制文件设为可执行文件。
```
chmod +x toolbox
```
验证安装。
```
./toolbox --version
```

连接到 MCP 服务器

在 VS Code 中打开 Cline 扩展程序，然后点按 MCP 服务器图标。
点击配置 MCP 服务器以打开配置文件。
添加以下配置，将环境变量替换为您的值，然后保存。 FIRESTORE_DATABASE 变量是可选的，默认值为 (default)。

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

服务器成功连接后，系统会显示绿色的活跃状态。

光标

安装 MCP Toolbox for Databases

以二进制文件形式下载最新版本的 Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 V0.15.0 版或更高版本的 Toolbox。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
将该二进制文件设为可执行文件。
```
chmod +x toolbox
```
验证安装。
```
./toolbox --version
```

连接到 MCP 服务器

在项目根目录中创建 .cursor 目录（如果尚不存在）。
创建 .cursor/mcp.json 文件（如果尚不存在）并打开该文件。
添加以下配置，将环境变量替换为您的值，然后保存。 FIRESTORE_DATABASE 变量是可选的，默认值为 (default)。

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

打开 Cursor，然后依次前往设置 > Cursor 设置 > MCP。服务器连接时，系统会显示绿色的活跃状态。

Visual Studio Code (Copilot)

安装 MCP Toolbox for Databases

以二进制文件形式下载最新版本的 Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 V0.15.0 版或更高版本的 Toolbox。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
将该二进制文件设为可执行文件。
```
chmod +x toolbox
```
验证安装。
```
./toolbox --version
```

连接到 MCP 服务器

打开 VS Code，并在项目根目录中创建 .vscode 目录（如果尚不存在）。
创建 .vscode/mcp.json 文件（如果尚不存在）并打开该文件。
添加以下配置，将环境变量替换为您的值，然后保存。 FIRESTORE_DATABASE 变量是可选的，默认值为 (default)。

 {
    "servers":{
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Windsurf

安装 MCP Toolbox for Databases

以二进制文件形式下载最新版本的 Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 V0.15.0 版或更高版本的 Toolbox。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
将 version 替换为 Toolbox 版本号，例如 v0.15.0。
将该二进制文件设为可执行文件。
```
chmod +x toolbox
```
验证安装。
```
./toolbox --version
```

连接到 MCP 服务器

打开 Windsurf 并前往 Cascade 助理。
点击 MCP 图标，然后点击配置以打开配置文件。
添加以下配置，将环境变量替换为您的值，然后保存。 FIRESTORE_DATABASE 变量是可选的，默认值为 (default)。

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

将 Firestore 与 MCP、Gemini CLI 和其他代理搭配使用

Gemini CLI 和扩展服务简介

扩展程序的运作方式

使用适用于 Firestore 的 Gemini CLI 扩展程序

准备工作

设置 Firestore

配置 MCP 客户端

Gemini CLI

Gemini Code Assist

Claude Code

安装 MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

连接到 MCP 服务器

Claude Desktop

安装 MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

连接到 MCP 服务器

Cline

安装 MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

连接到 MCP 服务器

光标

安装 MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

连接到 MCP 服务器

Visual Studio Code (Copilot)

安装 MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

连接到 MCP 服务器

Windsurf

安装 MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

连接到 MCP 服务器