gemini-cloud-assist-mcp

Gemini Cloud Assist MCP 服务

重要

私人预览公告 Gemini Cloud Assist MCP 服务 API 目前处于私人预览阶段，并采用允许列表机制。请联系您的 Google Cloud 客户团队申请访问权限。

警告

弃用公告与迁移至远程 MCP 服务

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

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

此服务将 Model Context Protocol (MCP) 客户端连接到 Gemini Cloud Assist API。您可以直接通过本地命令行使用自然语言了解、管理和排查 Google Cloud 环境的问题。

此代码库中的配置连接到 Cloud Operator 端点 https://geminicloudassist.googleapis.com/mcp/autocloud，该端点提供 Cloud Operator 工具（ask_cloud_operator、search_operator_sessions、fetch_operator_session）。参考文档中列出的其他 Gemini Cloud Assist 工具仍由 https://geminicloudassist.googleapis.com/mcp 提供，无法通过这些配置访问。

说明

Google Cloud Platform 服务条款（可在 https://cloud.google.com/terms/ 查看）和数据处理与安全条款（可在 https://cloud.google.com/terms/data-processing-terms 查看）不适用于 Gemini Cloud Assist MCP Server 软件的任何组件。

如需详细了解 Gemini Cloud Assist，请参阅 Google Cloud 文档中的 Gemini Cloud Assist 概览。

✨ 主要功能

Cloud Operator 是一款能够实时获取项目上下文的运维 Agent。它通过 ask_cloud_operator 处理以下任务：

• 排查问题： 调查 Google Cloud 环境中的事件并查明根本原因。
• 审核发布： 审核发布准备情况并监控发布过程。
• 设计和审核基础设施： 审核并生成 Terraform 最佳实践配置、Kubernetes 和 Helm 清单，并将结果作为可审核的文件修改应用。
• 优化成本： 分析支出并找出提高效率的机会。
• 获取一般帮助： 基于文档提供操作方法解答，并就 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 客户端

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

Cloud Operator 插件：Claude Code、ChatGPT Codex 和 Google Antigravity

重要

私有预览。 Cloud Operator 及其 MCP 服务目前处于私有预览阶段。

Cloud Operator 插件（位于 plugins/cloud-operator；安装后名为 cloud-operator，因此其命令为 /cloud-operator:…）可将 Claude Code、ChatGPT Codex 或 Google Antigravity 连接到 Cloud Operator（ask_cloud_operator）。它可以：

• 设置与 Cloud Operator 的 MCP 连接，并将工具超时设为 30 分钟；
• 询问要使用哪个操作员 Agent，并检查其是否有响应；
• 保存你的 Google Cloud 偏好设置，并将其传递给 Cloud Operator；
• 添加一项技能，帮助你的 Agent 判断何时以及如何使用 Cloud Operator。

如需安装，请参阅 plugins/cloud-operator。 在这些 Agent 中，该插件会替代本仓库根目录下的 gemini-cloud-assist-mcp 插件，因此请勿同时安装两者。

Antigravity

将以下内容添加到你的 mcp_config.json：

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp/autocloud",
    "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/autocloud",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

请遵循适用于你所用应用的配置说明：

• Claude.ai
• Claude Code：请参阅 Cloud Operator 插件。

MCP 工具

Cloud Operator MCP 工具

Cloud Operator 是一个可通过一组 MCP 工具访问的 Agent。由 MCP 工具调用的 Agent 会在内部自行调用 Google Cloud 工具。/mcp/autocloud 端点提供以下工具。这些工具处于私有预览阶段，并且仅限获准项目使用。

工具	描述
ask_cloud_operator	将多步骤运维工作委派给 Cloud Operator Agent：事件和根因调查、发布审核、成本优化、Terraform 最佳实践审核与生成，以及基于文档的操作指南回答。返回一个 contextId，供后续调用继续该会话。
search_operator_sessions	列出你在某个项目中的 Cloud Operator 会话。每个会话的 contextId 会标识为其提供服务的操作员 Agent。
fetch_operator_session	通过 contextId 获取 Cloud Operator 会话，包括其中的轮次。

其他 Gemini Cloud Assist 工具（ask_cloud_assist、design_infra、investigate_issue、invoke_operation、optimize_costs）由 https://geminicloudassist.googleapis.com/mcp 提供，详情请参阅 Gemini Cloud Assist MCP 参考文档。这些工具无法通过本仓库中的配置使用。

注意： 不应将这些工具视为稳定 API。随着 Gemini Cloud Assist 功能不断演进，参数可能会重命名或修改。

Agent 技能

Gemini Cloud Assist MCP 工具使用 SKILL.md 文件来指导你的 Agent 如何正确使用这些工具。这些技能会指导你的 Agent 何时将工作委派给 Cloud Operator、向其传递相关的本地信息，以及如何显式调用它。

技能	描述
autocloud-operator	将 Google Cloud 运维工作委派给 Cloud Operator Agent（ask_cloud_operator）：事件调查、发布审核、成本优化、Terraform 审核与生成，以及操作指南相关问题；Terraform 结果会以可供审核的文件编辑形式应用。需要拥有私有预览访问权限。

贡献

• 如果遇到错误，请在我们的 GitHub Issues 页面提交问题。
• 提交拉取请求前，请先阅读我们的贡献指南。

许可证

本项目采用 Apache 2.0 许可证，并按“原样”提供，不对任何用途或目的作出保证或声明。详情请参阅 LICENSE 文件。