本頁面由 Cloud Translation API 翻譯而成。

搭配使用 Firestore 與 MCP、Gemini CLI 和其他代理程式

本頁說明如何將 Firestore 資料庫連結至各種開發人員工具。

如要享有整合式體驗，建議使用 Gemini CLI 專用的 Firestore 擴充功能。Gemini CLI 是 Google Cloud 的新一代指令列介面，可直接將基礎 MCP 伺服器套裝組合到擴充功能中，因此不需要另外設定伺服器。您可以設定 Gemini Code Assist 使用 Gemini CLI，在 IDE 中享有類似的設定優勢。

如要連結支援模型上下文協定 (MCP) 的其他開發人員工具，請手動設定資料庫適用的 MCP Toolbox。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 電腦版
Claude 程式碼

關於 Gemini CLI 和擴充功能

Gemini CLI 是開放原始碼 AI 代理，可協助您完成程式碼編寫、偵錯、資料探索和內容建立等工作，提升開發流程效率。其任務是提供代理介面，與 Data Cloud 服務和熱門的開放原始碼資料庫互動。

擴充功能的運作方式

Gemini CLI 具有高度擴充性，可透過擴充功能新增工具和功能。您可以從 GitHub 網址、本機目錄或可設定的登錄檔載入擴充功能。這些外掛程式提供新的工具、斜線指令和提示，協助你完成工作流程。

使用 Firestore 的 Gemini CLI 擴充功能

與 Gemini CLI 整合時，需要使用專屬擴充功能，與標準 MCP 工具箱連線相比，這項擴充功能提供更多功能。這項擴充功能提供簡化的安裝程序和一系列工具。這個開放原始碼擴充功能包含安裝、設定和使用範例的詳細資訊。詳情請參閱「Gemini CLI Extension - 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`	將文件 qa_user_789 新增至 users-staging 集合，並加入 name: tester1 和 location: USA 欄位。
	`delete_documents`	從 users-staging 集合中刪除文件 qa_user_789。
	`update_document`	更新 orders 集合中 ID 為 order-987 的文件，將狀態設為「已出貨」。請從這 20 位測試人員的願望清單中移除產品眼鏡(已停用)。
管理安全性規則	`get_rules`	顯示這個資料庫目前使用的 Firestore 安全性規則。
管理安全性規則	`validate_rules`	new_rules.txt 是我為暫存環境開發的新 Firestore 安全性規則。可以幫我驗證嗎？

事前準備

如要使用 Gemini CLI 擴充功能的 Firestore 工具，您必須具備下列其中一個 Identity and Access Management (IAM) 角色，或是具備同等權限的自訂角色：

工作	角色名稱	必要的身分與存取權管理 (IAM) 角色
在 Firestore 資料庫中讀取及寫入資料	Cloud Datastore 使用者	`roles/datastore.user`
查看及測試安全性規則	Firebase 規則檢視者	`roles/firebaserules.viewer`

設定 Firestore

建立新 Google Cloud 專案或選取現有專案。
為專案啟用 Firestore 原生模式 API。
如果尚未建立 Firestore 資料庫，請先建立資料庫。
為本機環境設定驗證方法。
- 安裝 gcloud CLI
- 執行 gcloud auth application-default login 進行驗證

設定 MCP 用戶端

本節說明如何設定各種開發人員工具，使用 MCP Toolbox for Databases 連線至 Firestore 執行個體。這個工具箱是開放原始碼的模型上下文協定 (MCP) 伺服器，位於 IDE 和資料庫之間，可為 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 會自動載入 Gemini CLI 擴充功能的 Firestore 擴充功能和工具，方便您與資料庫互動。

Gemini Code Assist

建議您將 Gemini Code Assist 設為使用 Gemini CLI，這樣就不必手動設定 MCP 伺服器。

請確認已安裝並設定 Gemini CLI 和 firestore-native 擴充功能。
設定 Gemini Code Assist 使用 Gemini CLI。
直接在 Gemini Code Assist 對話中，以自然語言與 Firestore 資料庫互動。

Claude 代碼

安裝 MCP Toolbox for Databases

以二進位檔形式下載最新版 Toolbox。選取與作業系統 (OS) 和 CPU 架構對應的二進位檔。你必須使用 Toolbox V0.15.0 以上版本。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 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 程式碼，套用新設定。

Claude 電腦版

安裝 MCP Toolbox for Databases

以二進位檔形式下載最新版 Toolbox。選取與作業系統 (OS) 和 CPU 架構對應的二進位檔。你必須使用 Toolbox V0.15.0 以上版本。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 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 架構對應的二進位檔。你必須使用 Toolbox V0.15.0 以上版本。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
將二進位檔設為可執行。
```
chmod +x toolbox
```
驗證安裝。
```
./toolbox --version
```

連線至 MCP 伺服器

在 VS Code 中開啟 Cline 擴充功能，然後輕觸「MCP Servers」圖示。
按一下「設定 MCP 伺服器」開啟設定檔。
新增下列設定，將環境變數換成您的值，然後儲存。 FIRESTORE_DATABASE 變數為選用項目，預設為 (default)。

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

伺服器連線成功後，會顯示綠色的「有效」狀態。

Cursor

安裝 MCP Toolbox for Databases

以二進位檔形式下載最新版 Toolbox。選取與作業系統 (OS) 和 CPU 架構對應的二進位檔。你必須使用 Toolbox V0.15.0 以上版本。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 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"
        }
      }
    }
  }

開啟「游標」，然後依序前往「設定」>「游標設定」>「MCP」。伺服器連線後，會顯示綠色的「有效」狀態。

Visual Studio Code (Copilot)

安裝 MCP Toolbox for Databases

以二進位檔形式下載最新版 Toolbox。選取與作業系統 (OS) 和 CPU 架構對應的二進位檔。你必須使用 Toolbox V0.15.0 以上版本。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 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"
        }
      }
    }
  }

滑浪風帆

安裝 MCP Toolbox for Databases

以二進位檔形式下載最新版 Toolbox。選取與作業系統 (OS) 和 CPU 架構對應的二進位檔。你必須使用 Toolbox V0.15.0 以上版本。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 v0.15.0。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
將 version 替換為工具箱版本號碼，例如 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 代碼

安裝 MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

連線至 MCP 伺服器

Claude 電腦版

安裝 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 伺服器

Cursor

安裝 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 伺服器

滑浪風帆

安裝 MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

連線至 MCP 伺服器