Google Cloud MCP Server

官方

與 Google Cloud 服務互動，並管理您的雲端資源。

GitHub

842

文件

gcloud MCP 伺服器 ☁️

gcloud 模型上下文協定 (MCP) 伺服器讓 AI 助理能夠使用 gcloud CLI 輕鬆與 Google Cloud 環境互動。透過 gcloud MCP 伺服器，您可以：

使用自然語言與 Google Cloud 互動。 描述您想要的結果，無需記憶複雜的命令語法、旗標和引數。
自動化並簡化複雜的工作流程。 將多個雲端操作串聯成單一、可重複的命令，以減少手動作業和出錯機會。
降低雲端管理的進入門檻。 讓較不熟悉 gcloud 的團隊成員也能自信且安全地執行強大的操作。

📡 可用的 MCP 伺服器

除了 gcloud MCP 伺服器之外，此存放庫也託管了其他 MCP 伺服器。以下是最新列表，而託管在此存放庫外部的其他 Google Cloud MCP 伺服器連結則在這裡。

MCP 伺服器名稱	說明	套件名稱
gcloud	使用自然語言提示透過 gcloud CLI 與 Google Cloud 互動。	`gcloud-mcp`
observability	存取 Google Cloud Observability API 以查詢日誌、指標和追蹤。	`observability-mcp`
storage	與 Google Cloud Storage 互動以進行儲存桶和物件管理。	`storage-mcp`
backupdr	與 Google Cloud Backup and Disaster Recovery 互動。	`backupdr-mcp`

🚀 入門指南

先決條件

Node.js：版本 20 或更高
gcloud CLI

✨ 設定您的 MCP 伺服器

Gemini CLI 和 Gemini Code Assist

若要將 MCP 伺服器與 Gemini CLI 或 Gemini Code Assist 整合，請從您的家目錄針對表格中列出的 MCP 伺服器執行以下設定命令。這會將 MCP 伺服器安裝為目前使用者的 Gemini CLI 擴充功能，使其可用於您的所有專案。

npx @google-cloud/[PACKAGE_NAME] init --agent=gemini-cli

例如，針對 gcloud-mcp：

npx @google-cloud/gcloud-mcp init --agent=gemini-cli

初始化程序完成後，您可以透過執行以下命令來驗證 gcloud-mcp 伺服器是否已正確設定：

gemini mcp list

> ✓ gcloud: npx -y @google-cloud/gcloud-mcp (stdio) - Connected

針對其他 AI 客戶端

若要將此存放庫中的 MCP 伺服器與其他客戶端搭配使用，請針對每個 MCP 伺服器，將以下程式碼片段新增至其各自的 JSON 設定檔中：

"[SERVER_NAME]": {
  "command": "npx",
  "args": ["-y", "@google-cloud/[PACKAGE_NAME]"]
}

例如，針對 gcloud：

"gcloud": {
  "command": "npx",
  "args": ["-y", "@google-cloud/gcloud-mcp"]
}

熱門工具的說明：

Claude Desktop： 開啟 Claude > 設定 > 開發人員 > 編輯設定 並編輯 claude_desktop_config.json。
Cline： 點擊 MCP 伺服器圖示，然後點擊 設定 MCP 伺服器 以編輯 cline_mcp_settings.json。
Cursor： 針對單一專案編輯 .cursor/mcp.json，或針對所有專案編輯 ~/.cursor/mcp.json。
Gemini CLI（手動設定）： 如果不使用擴充功能，請針對單一專案編輯 .gemini/settings.json，或針對所有專案編輯 ~/.gemini/settings.json。

針對 Visual Studio Code，請編輯工作區中的 .vscode/mcp.json 檔案（用於單一專案），或編輯您的全域使用者設定檔案（用於所有專案）：

"servers": {
  "[SERVER_NAME]": {
    "command": "npx",
    "args": ["-y", "@google-cloud/[PACKAGE_NAME]"]
  }
}

例如，針對 gcloud 和 observability：

"servers": {
  "gcloud": {
    "command": "npx",
    "args": ["-y", "@google-cloud/gcloud-mcp"]
  },
  "observability": {
    "command": "npx",
    "args": ["-y", "@google-cloud/observability-mcp"]
  },
}

🛠 本機開發

如需有關在本機安裝存放庫的更多資訊，請參閱 development.md

🧰 可用的 MCP 工具

MCP 伺服器	工具	說明
gcloud	`run_gcloud_command`	執行 gcloud 指令。部分指令已限制代理程式執行。詳情請參閱 MCP 權限。
observability	`list_log_entries`	列出專案中的日誌條目。
	`list_log_names`	列出專案中的日誌名稱。
	`list_buckets`	列出專案中的日誌儲存桶。
	`list_views`	列出專案中的日誌檢視。
	`list_sinks`	列出專案中的日誌接收器。
	`list_log_scopes`	列出專案中的日誌範圍。
	`list_metric_descriptors`	列出專案的指標描述元。
	`list_time_series`	列出指定指標的時間序列資料。
	`list_alert_policies`	列出專案中的快訊政策。
	`list_traces`	在專案中搜尋追蹤記錄。
	`get_trace`	依 ID 取得專案中的特定追蹤記錄。
	`list_group_stats`	列出專案的錯誤群組。
storage	`list_objects`	列出 GCS 儲存桶中的物件。
	`read_object_metadata`	讀取特定物件的完整中繼資料。
	`read_object_content`	讀取特定物件的內容。
	`delete_object`	從儲存桶中刪除特定物件。
	`write_object`	將新物件寫入儲存桶。
	`update_object_metadata`	更新現有物件的自訂中繼資料。
	`copy_object`	將物件從一個儲存桶複製到另一個。
	`move_object`	將物件從一個儲存桶移動到另一個。
	`upload_object`	上傳檔案至 GCS 儲存桶。
	`download_object`	從 GCS 下載物件至本機檔案。
	`list_buckets`	列出專案中的所有儲存桶。
	`create_bucket`	建立新的儲存桶。
	`delete_bucket`	刪除儲存桶。
	`get_bucket_metadata`	取得特定儲存桶的完整中繼資料。
	`update_bucket_labels`	更新儲存桶的標籤。
	`get_bucket_location`	取得儲存桶的位置。
	`view_iam_policy`	檢視儲存桶的 IAM 政策。
	`check_iam_permissions`	測試儲存桶的 IAM 權限。
	`get_metadata_table_schema`	檢查 GCS 洞察服務是否已啟用，並傳回指定洞察資料集設定的 BigQuery 資料表結構定義。
	`execute_insights_query`	對洞察資料集執行 BigQuery SQL 查詢並傳回結果。
	`list_insights_configs`	列出指定專案的所有 Storage Insights 資料集設定名稱。
backupdr	`list_backup_vaults`	列出指定專案和位置中的所有備份保存庫。
	`get_backup_vault`	取得特定備份保存庫的詳細資料。
	`list_backup_plans`	列出指定專案和位置中的所有備份計畫。
	`get_backup_plan`	取得特定備份計畫的詳細資料。
	`list_backup_plan_associations`	列出備份計畫與資源之間的所有關聯。
	`get_backup_plan_association`	取得特定備份計畫關聯的詳細資料。
	`list_datasources`	列出備份保存庫中的所有資料來源。
	`get_datasource`	取得特定資料來源的詳細資料。
	`list_backups`	列出指定資料來源的所有備份。
	`get_backup`	取得特定備份的詳細資料。
	`find_protectable_resources`	探索可保護的資源（VM、磁碟、SQL）。
	`get_backupdr_operation`	擷取長時間執行的 BackupDR 作業狀態。
	`get_csql_operation`	擷取長時間執行的 Cloud SQL 作業狀態。
	`create_backup_vault`	在指定位置建立新的備份保存庫。
	`create_backup_plan`	建立包含定義規則和保留設定的新備份計畫。
	`update_backup_plan`	修改現有的備份計畫。
	`create_backup_plan_association`	將資源與備份計畫建立關聯以啟動保護。
	`restore_backup`	將備份還原至目標 Compute Engine 執行個體或磁碟。
	`csql_restore`	將 Cloud SQL 備份還原至目標執行個體。
	`delete_backup_vault`	刪除備份保存庫。
	`delete_backup_plan`	刪除備份計畫。
	`delete_backup_plan_association`	透過刪除資源的關聯來移除保護。
	`delete_backup`	刪除保存庫中的特定備份。

🔑 MCP 權限

gcloud MCP 的權限與作用中 gcloud 帳戶的權限直接相關。若要限制權限並遵循最小權限原則，您可以透過模擬身分授權為服務帳戶，並為該服務帳戶指派具備有限權限的角色。

預設情況下，gcloud MCP 會阻止執行對 AI 代理程式不合理的 gcloud 指令。這是為了限制可執行任意輸入及啟動互動式工作階段的指令。請參閱此處查看被拒絕的指令清單。

💫 其他 Google Cloud MCP 伺服器

Google Cloud 提供以下其他伺服器：

👥 貢獻

我們歡迎貢獻！無論是修正錯誤、分享意見回饋，或是改善文件，我們都歡迎您的貢獻。請閱讀我們的貢獻指南以開始參與。

📄 重要注意事項

此存放庫目前為預覽版本，可能會有重大變更。此存放庫提供的是解決方案，而非官方支援的 Google 產品。它不在 Google Cloud 服務條款的涵蓋範圍內。當 MCP 規格、其他 SDK，或其他解決方案與產品變更時，它可能會失效。另請參閱我們的安全性政策。