Gemini Cloud Assist

Gemini Cloud Assist MCP 伺服器

[!IMPORTANT] 私人預覽通知 Gemini Cloud Assist MCP 伺服器 API 目前處於私人預覽階段，並受到允許清單（allowlist）保護。請聯絡您的 Google Cloud 帳戶團隊以申請存取權限。

[!WARNING] 棄用通知與遷移至遠端 MCP 伺服器

Gemini Cloud Assist MCP 伺服器已從本機 Node.js 架構遷移至遠端 MCP 伺服器架構。較舊的本機 Node.js 伺服器將在未來幾個月內停止支援。

若要使用新的遠端 MCP 伺服器，請使用 v0.8.0 或更新版本。如果您希望在過渡期間繼續使用舊版本機伺服器，請將您的設定固定為較舊版本。

此伺服器將 Model Context Protocol (MCP) 用戶端連線至 Gemini Cloud Assist APIs。它讓您能夠直接從本機命令列使用自然語言來理解、管理及疑難排解您的 Google Cloud 環境。

[!NOTE] Google Cloud Platform 服務條款（可在 https://cloud.google.com/terms/ 取得）及資料處理與安全條款（可在 https://cloud.google.com/terms/data-processing-terms 取得）不適用於 Gemini Cloud Assist MCP 伺服器軟體的任何元件。

若要深入瞭解 Gemini Cloud Assist，請參閱 Google Cloud 文件中的 Gemini Cloud Assist 總覽。

✨ 主要功能

• 設計基礎架構： 為 Google Cloud 建立及架構基礎架構設定。
• 疑難排解問題： 執行深入調查，以找出 Google Cloud 環境中複雜問題的根本原因。
• 管理資源： 直接從您的聊天工作流程建立、更新及刪除 Google Cloud 資源（需要 Agent Actions）。
• 最佳化成本： 分析您的支出、追蹤成本，並找出效率提升的機會，例如閒置資源。
• 取得一般協助： 詢問問題並取得 Google Cloud 最佳實務、架構及營運方面的指引。

快速入門

開始之前，請確保您已具備以下項目：

• 已安裝並設定 Google Cloud SDK。
• 一個 Google Cloud 專案。
• 您的使用者帳戶具備下列 IAM 角色：
  • roles/serviceusage.serviceUsageAdmin：啟用 Cloud Assist API 所需。
  • roles/geminicloudassist.user：向 Cloud Assist API 發出請求所需。

步驟 1：向 Google Cloud 進行驗證

Gemini Cloud Assist MCP 伺服器使用本機 Application Default Credentials (ADC) 來安全地向 Google Cloud 進行驗證。若要設定 ADC，請執行下列 gcloud 指令：

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

設定您的 MCP 用戶端

用戶端代理程式設定取決於您使用的代理程式。

Antigravity

將以下內容新增至您的 mcp_config.json：

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

1. 在您的 Google Cloud 專案中，為桌面應用程式建立 OAuth 2.0 用戶端 ID。
2. 將 URI://anysphere.cursor-mcp/oauth/callback 設定為重新導向 URL。
3. 新增或合併下列設定區塊：

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

請依照您特定應用程式的設定說明操作：

• Claude.ai

MCP 工具

Gemini Cloud Assist MCP 工具

Gemini Cloud Assist 是一個可透過一組 MCP 工具存取的代理程式。由 MCP 工具呼叫所呼叫的代理程式，會在內部向 Google Cloud 發出自己的工具呼叫。下列 MCP 工具 已發布供代理程式使用：

工具	說明
ask_cloud_assist	Google Cloud 協助及 Gemini Cloud Assist 代理程式的主要介面。所有功能都可透過此工具存取。
design_infra	支援在 Google Cloud 上設計及架構基礎架構的工作流程。
investigate_issue	支援 Google Cloud 疑難排解的工作流程。可透過 Investigation 資源進行快速疑難排解或更深入的疑難排解。
invoke_operation	支援在 Google Cloud 中建立、更新及刪除資源的工作流程。僅在啟用 Agent Actions 時運作。
optimize_costs	支援分析、追蹤及最佳化 Google Cloud 成本的工作流程。提供支出明細並找出成本效率提升的機會。

Application Design Center MCP 工具

Application Design Center MCP 工具（通常由 GCA 的 design_infra 工具編排）使用 Application Design Center 管理基礎架構應用程式生命週期，包括範本管理、安全合規與修補，以及部署。

工具	說明
setup_adc	初始化 Application Design Center 環境。這是一次性的設定步驟，必須在其他 ADC 工具可使用之前執行。
manage_application	管理應用程式的部署生命週期。使用此工具可透過 Application Design Center 部署已驗證的設計，或擷取現有部署的狀態與詳細資料。這是將您的設計轉化為 Google Cloud 上已部署基礎架構的最後一步。
manage_application_template	管理基礎架構設計的 Infrastructure as Code (IaC) 內容。使用此工具可將設計儲存為 Application Design Center 範本、將設計匯出為 Terraform 檔案，或更新設計（例如元件、參數設定等）。
assess_best_practices	在部署前對您的應用程式設計執行全面的安全與設定稽核。它會根據 Security Command Center 架構及相關控制項驗證設計，並傳回包含可操作發現項目的報告以供修補。
list_application_templates	列出所有可用的應用程式設計。

注意： 這些工具不應被視為穩定的 API。參數可能會重新命名或修改，以因應 Gemini Cloud Assist 不斷演進的功能。

代理程式技能

Gemini Cloud Assist MCP 工具利用 SKILL.md 檔案來指示您的代理程式如何正確使用工具。這些技能有助於引導您的代理程式將多個工具串聯成工作流程、將相關的本機資訊傳遞給 Gemini Cloud Assist，並啟用明確的呼叫。

技能	說明
designing-and-deploying-infrastructure	引導代理程式如何使用 Application Design Center (ADC) 和 Gemini Cloud Assist 工具來設計、評估、部署及疑難排解雲端基礎架構。
operating-google-cloud	提供使用專門的 MCP 工具管理 Google Cloud Platform (GCP) 資源和 Kubernetes 的指示。

貢獻

• 如果您遇到錯誤，請在我們的 GitHub Issues 頁面回報問題。
• 在送出 pull request 之前，請先檢閱我們的 貢獻指南。

授權

此專案採用 Apache 2.0 授權，並按「現況」提供，不對任何使用或目的提供保證或陳述。如需詳細資訊，請參閱 LICENSE 檔案。