Repolode
googleapis

googleapis/gcloud-mcp

让 AI 助手通过自然语言调用 gcloud CLI,并管理 Google Cloud 存储、可观测性与备份容灾资源的 MCP 服务器。

Star
931
Fork
83
未关闭 Issue
69
最近提交
5天前

这是什么?

gcloud MCP 是一个基于 Model Context Protocol 的服务器,通过 gcloud CLI 让 AI 助手直接操作 Google Cloud。用户无需记忆命令语法、参数和标志,只需用自然语言描述目标,助手即可执行对应的 gcloud 操作。

仓库包含多个服务器:gcloud 用于执行 gcloud 命令;observability 用于查询日志、指标、追踪和错误分组;storage 用于管理 Cloud Storage 的存储桶和对象;backupdr 用于操作备份与容灾服务中的备份库、备份计划和备份。每个服务器都以 @google-cloud 命名空间下的 npm 包发布,可通过 npx 启动。

配置方式主要面向 Gemini CLI 和 Gemini Code Assist,同时提供 Claude Desktop、Cline、Cursor 和 Visual Studio Code 的手动配置示例。需要 Node.js 20 及以上版本和 gcloud CLI。默认会阻止部分交互式或可接受任意输入的 gcloud 命令,实际权限取决于当前 gcloud 账号的权限。

核心功能

  • 01通过 run_gcloud_command 工具,将自然语言指令转换为 gcloud 命令执行。
  • 02查询日志、监控指标、调用链追踪和错误分组。
  • 03对 Cloud Storage 对象进行列出、读取、上传、下载、复制和移动。
  • 04管理存储桶、IAM 策略,并执行 Storage Insights 查询。
  • 05查看和操作备份与容灾服务中的备份库、备份计划和备份记录。

适用场景

  • 让不熟悉 gcloud 的团队成员通过 AI 助手完成常见云操作。
  • 在对话中查询日志、调用链和指标,辅助排查线上问题。
  • 将多个 Cloud Storage 或备份操作串联为可重复执行的流程。
  • 通过服务账号模拟身份,在受限权限下运行 gcloud 命令。

快速上手

  1. 1

    前置条件:安装 Node.js 20 或更高版本以及 gcloud CLI

  2. 2

    将 gcloud MCP 服务器添加到你的 AI 客户端配置中(例如 Claude Desktop、Cline、Cursor 或 VS Code)

    npx -y @google-cloud/gcloud-mcp
  3. 3

    或者对于 Gemini CLI,在主目录中运行安装命令

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

使用前须知

  • 需要已安装并配置 gcloud CLI,且 Node.js 版本需为 20 或更高。
  • 通过智能体执行的命令会作用于真实的 Google Cloud 资源,因此应谨慎限制访问权限。

收录于专题

标签

常见问题

gcloud-mcp 是什么?
让 AI 助手通过自然语言调用 gcloud CLI,并管理 Google Cloud 存储、可观测性与备份容灾资源的 MCP 服务器。 gcloud MCP 是一个基于 Model Context Protocol 的服务器,通过 gcloud CLI 让 AI 助手直接操作 Google Cloud。用户无需记忆命令语法、参数和标志,只需用自然语言描述目标,助手即可执行对应的 gcloud 操作。
gcloud-mcp 可以免费使用吗?用的什么许可证?
gcloud-mcp 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
gcloud-mcp 还在维护吗?
活跃维护中。gcloud-mcp 最近一次提交是在 2026年10月17日。
gcloud-mcp 适合用来做什么?
让不熟悉 gcloud 的团队成员通过 AI 助手完成常见云操作。 在对话中查询日志、调用链和指标,辅助排查线上问题。 将多个 Cloud Storage 或备份操作串联为可重复执行的流程。 通过服务账号模拟身份,在受限权限下运行 gcloud 命令。
gcloud-mcp 怎么安装和运行?
前置条件:安装 Node.js 20 或更高版本以及 gcloud CLI 将 gcloud MCP 服务器添加到你的 AI 客户端配置中(例如 Claude Desktop、Cline、Cursor 或 VS Code): npx -y @google-cloud/gcloud-mcp 或者对于 Gemini CLI,在主目录中运行安装命令: npx @google-cloud/gcloud-mcp init --agent=gemini-cli
在哪里获取 gcloud-mcp?
源代码和安装说明在 GitHub 上:https://github.com/googleapis/gcloud-mcp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目