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 或更高版本。如果您希望在过渡期间继续使用旧版本地服务器，请将您的配置固定到旧版本。

此服务器将 模型上下文协议 (MCP) 客户端（例如 Gemini CLI）连接到 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 客户端

客户端代理配置取决于您使用的代理。

Gemini CLI

将 MCP 服务器安装为 Gemini CLI 扩展：

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

或者，您可以手动将配置添加到您的 ~/.gemini/settings.json 文件中：

"mcpServers": {
  "gemini_cloud_assist": {
    "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  },
  "application_design_center": {
    "httpUrl": "https://designcenter.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  }
}

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 中进行问题排查的工作流。可以通过调查资源进行快速排查或更深入的排查。
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 文件。