Gemini Cloud Assist

Gemini Cloud Assist MCP 服务器

[!IMPORTANT] 私有预览通知 Gemini Cloud Assist MCP 服务器 API 目前处于私有预览阶段，并且位于允许列表中。请联系您的 Google Cloud 客户团队以请求访问权限。

[!WARNING] 弃用通知及迁移至远程 MCP 服务器

Gemini Cloud Assist MCP 服务器已从本地 Node.js 架构迁移至远程 MCP 服务器架构。较旧的本地 Node.js 服务器将在未来几个月内失去支持。

要使用新的远程 MCP 服务器，请使用版本 v0.8.0 或更高版本。如果您希望在过渡期间继续使用旧版本地服务器，请将配置固定到较旧版本。

此服务器将 Model Context Protocol (MCP) 客户端连接到 Gemini Cloud Assist API。它允许您使用自然语言直接从本地命令行理解、管理和排查您的 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 资源（需要代理操作）。
• 优化成本： 分析您的支出、跟踪成本，并识别效率提升机会，例如闲置资源。
• 获取一般帮助： 提出问题并获取有关 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 服务器使用本地应用程序默认凭据 (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 中创建、更新和删除资源的工作流。仅在启用代理操作时有效。
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	管理基础设施设计的基础设施即代码 (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 页面上提交问题。
• 在发送拉取请求之前，请查看我们的 贡献指南。

许可证

本项目根据 Apache 2.0 许可证授权，并按“原样”提供，不附带任何明示或暗示的保证或陈述。有关详细信息，请参阅 LICENSE 文件。