您可以使用 MCP Toolbox for Databases 執行本機 Model Context Protocol (MCP) 伺服器，直接從 IDE 和開發人員工具與 Cloud Storage 互動。完成這項設定後，Antigravity、Claude、Cline、Cursor、Visual Studio Code (Copilot) 和 Windsurf 等用戶端中的大型語言模型 (LLM)，就能建立 bucket、管理物件資料，以及檢查 Identity and Access Management (IAM) 政策。
開放原始碼 MCP Toolbox 支援 OAuth2 和 OIDC 驗證，並與 OpenTelemetry 整合，可提供觀測能力。Cloud Storage 整合功能需要 MCP Toolbox 1.2.0 以上版本。如要執行獨立本機 MCP 伺服器，而不使用工具箱，請使用 Cloud Storage MCP GitHub 存放區。
事前準備
在 Google Cloud 控制台的專案選取器頁面中，選取或建立 Google Cloud 專案。
設定完成這項工作所需的角色和權限。叫用 LLM 代理的使用者，必須具備 bucket 或專案層級的下列角色：
- 如要列出 bucket、建立 bucket 及刪除空白 bucket：Storage 管理員 (
roles/storage.admin) - 如要列出物件、讀取物件、取得物件中繼資料或 bucket 中繼資料：Storage 物件檢視者 (
roles/storage.objectViewer) - 如要將內容寫入物件或上傳物件：Storage 物件建立者 (
roles/storage.objectCreator) - 如要複製、移動或刪除物件：Storage 物件管理員 (
roles/storage.objectAdmin)
- 如要列出 bucket、建立 bucket 及刪除空白 bucket：Storage 管理員 (
為環境設定應用程式預設憑證 (ADC)。
連線至 Antigravity
您可以使用自訂設定，將 Cloud Storage 連結至 Antigravity。在這種情況下，「自訂 MCP 伺服器」是指您透過編輯設定檔 (例如 mcp_config.json) 手動設定的伺服器。這種手動設定方式，可用來取代直接從內建 MCP 伺服器庫目錄安裝伺服器的做法。
如要設定自訂 MCP 伺服器，請按照下列步驟操作：
- 在終端機中執行
npx --version，確認系統已安裝npx並正確設定。如需安裝 Node.js (包含npx)，請參閱 npm 的下載及安裝 Node.js 和 npm 指南。 - 開啟 Antigravity，然後使用編輯器代理面板頂端的「...」下拉式選單，前往 MCP 伺服器庫。
- 如要開啟 mcp_config.json 檔案，請依序點選「MCP 伺服器」>「管理 MCP 伺服器」>「查看原始設定」。
- 新增下列設定，將預留位置替換為專案 ID，然後儲存：
{ "mcpServers": { "storage": { "command": "npx", "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-storage","--stdio"], "env": { "CLOUD_STORAGE_PROJECT": "PROJECT_ID" } } } }
安裝 MCP Toolbox
Toolbox 是開放原始碼 Model Context Protocol (MCP) 伺服器，在本機電腦上執行。本機伺服器會管理 IDE 與 Cloud Storage 之間的通訊。這項連結可為 AI 工具提供安全高效的環境。
下載最新版本 MCP Toolbox 二進位檔。選取與作業系統和 CPU 架構對應的二進位檔。您必須使用 MCP Toolbox 1.2.0 以上版本：
linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
將
VERSION替換為 MCP Toolbox 版本，例如v1.2.0。macOS darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
將
VERSION替換為 MCP Toolbox 版本，例如v1.2.0。macOS darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
將
VERSION替換為 MCP Toolbox 版本，例如v1.2.0。windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
將
VERSION替換為 MCP Toolbox 版本，例如v1.2.0。將該二進位檔設為可執行：
chmod +x toolbox驗證安裝項目：
./toolbox --version
如要使用容器映像檔或 Homebrew 設定工具箱，請參閱「安裝工具箱」頁面。
設定用戶端和連線
本節說明如何在安裝 MCP Toolbox 後，將 Cloud Storage 連結至工具。
Claude Code
- 安裝 Claude Code。
- 在專案根目錄中建立
.mcp.json檔案 (如果不存在)。 - 新增設定，將預留位置替換為您的值，然後儲存：
{ "mcpServers": { "storage": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-storage","--stdio"], "env": { "CLOUD_STORAGE_PROJECT": "PROJECT_ID" } } } }./PATH/TO/toolbox：toolbox二進位檔的路徑。CLOUD_STORAGE_PROJECT：指定 Google Cloud 專案 ID 的環境變數。PROJECT_ID： Google Cloud 專案 ID。
- 重新啟動 Claude Code，載入新設定。Claude Code 重新開啟後，應用程式會偵測設定的 MCP 伺服器。
Claude 電腦版
- 開啟 Claude Desktop，然後前往「設定」。
- 在「開發人員」分頁中，點選「編輯設定」開啟設定檔。
- 新增設定，將預留位置替換為您的值，然後儲存：
{ "mcpServers": { "storage": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-storage","--stdio"], "env": { "CLOUD_STORAGE_PROJECT": "PROJECT_ID" } } } }./PATH/TO/toolbox：toolbox二進位檔的路徑。CLOUD_STORAGE_PROJECT：指定 Google Cloud 專案 ID 的環境變數。PROJECT_ID： Google Cloud 專案 ID。
- 重新啟動 Claude Desktop。
- 新的對話畫面會顯示鎚子 (MCP) 圖示和新的 MCP 伺服器。
Cline
- 在 VS Code 中開啟 Cline 擴充功能，然後按一下「MCP 伺服器」圖示。
- 按一下「設定 MCP 伺服器」，開啟設定檔。
- 新增下列設定，將預留位置替換為您的值，然後儲存：
{ "mcpServers": { "storage": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-storage","--stdio"], "env": { "CLOUD_STORAGE_PROJECT": "PROJECT_ID" } } } }./PATH/TO/toolbox：toolbox二進位檔的路徑。CLOUD_STORAGE_PROJECT：指定 Google Cloud 專案 ID 的環境變數。PROJECT_ID： Google Cloud 專案 ID。
伺服器連線成功後，會顯示綠色的「有效」狀態。
Cursor
- 如果專案根目錄中沒有
.cursor目錄，請建立該目錄。 - 如果
.cursor/mcp.json檔案不存在，請建立並開啟該檔案。 - 新增下列設定，將預留位置替換為您的值，然後儲存：
{ "mcpServers": { "storage": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-storage","--stdio"], "env": { "CLOUD_STORAGE_PROJECT": "PROJECT_ID" } } } }./PATH/TO/toolbox：toolbox二進位檔的路徑。CLOUD_STORAGE_PROJECT：指定 Google Cloud 專案 ID 的環境變數。PROJECT_ID： Google Cloud 專案 ID。
- 開啟 Cursor，然後依序前往「Settings」>「Cursor Settings」>「MCP」。伺服器連線後，會顯示綠色的「有效」狀態。
Visual Studio Code (Copilot)
- 開啟 VS Code，並在專案根目錄中建立
.vscode目錄 (如果尚未建立)。 - 如果
.vscode/mcp.json檔案不存在，請建立並開啟該檔案。 - 新增下列設定，將預留位置替換為您的值，然後儲存：
{ "mcpServers": { "storage": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-storage","--stdio"], "env": { "CLOUD_STORAGE_PROJECT": "PROJECT_ID" } } } }./PATH/TO/toolbox：toolbox二進位檔的路徑。CLOUD_STORAGE_PROJECT：指定 Google Cloud 專案 ID 的環境變數。PROJECT_ID： Google Cloud 專案 ID。
- 重新載入 VS Code 視窗。MCP 相容擴充功能會自動偵測設定並啟動伺服器。
風浪板
- 開啟 Windsurf，然後前往 Cascade 助理。
- 依序點按 MCP 圖示和「設定」，開啟設定檔。
- 新增下列設定，將預留位置替換為您的值，然後儲存：
{ "mcpServers": { "storage": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-storage","--stdio"], "env": { "CLOUD_STORAGE_PROJECT": "PROJECT_ID" } } } }./PATH/TO/toolbox：toolbox二進位檔的路徑。CLOUD_STORAGE_PROJECT：指定 Google Cloud 專案 ID 的環境變數。PROJECT_ID： Google Cloud 專案 ID。
預先建構的工具
將 MCP Toolbox 連結至 Cloud Storage 後，代理會使用下列預先建構的工具：
- list_buckets：列出設定專案中的 Cloud Storage bucket。
- list_objects：列出 bucket 中的物件，並可選擇以前置字串和分隔符號篩選。
- get_bucket_metadata：傳回 bucket 的中繼資料。
- get_bucket_iam_policy：傳回 bucket 的 IAM 政策繫結。
- get_object_metadata：傳回物件的中繼資料。
- read_object：讀取 UTF-8 文字物件 (或位元組範圍)。上限為 8 MiB，二進位物件會遭拒。
- download_object：將物件下載至本機路徑。
- create_bucket：在設定的專案中建立 bucket。
- delete_bucket：刪除空白 bucket。
- upload_object：將本機檔案上傳至物件。
- write_object：直接將文字內容寫入物件。
- copy_object：將物件複製到目的地物件。
- move_object：以不可分割的方式重新命名相同 bucket 中的物件。
- delete_object：刪除物件。