# @google-cloud/gcloud-mcp 中文文档

规范地址：https://npmcn.com/package/%40google-cloud/gcloud-mcp/

版本：0\.5\.3
npm 元数据更新时间：2026-01-05T17:59:22.410Z
中文译文更新时间：2026-11-16T19:58:48.846Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40google-cloud/gcloud-mcp
原文对照：https://npmcn.com/package/%40google-cloud/gcloud-mcp/?lang=original
项目主页：https://github.com/googleapis/gcloud-mcp#readme
源码仓库：https://github.com/googleapis/gcloud-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.3 MB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：4 个
- 首次发布：2025-09-09T16:12:10.959Z
- 最新版本发布：2026-01-05T17:59:22.183Z
- 近 30 天下载量：265397（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 4 个）

## 中文简介

用于与 GCP API 互动的模拟上下文协议服务器

## 安装

```sh
npm install @google-cloud/gcloud-mcp
```

也可以使用：`pnpm add @google-cloud/gcloud-mcp`、`yarn add @google-cloud/gcloud-mcp`、`bun add @google-cloud/gcloud-mcp`

## README

[![Version](https://img.shields.io/npm/v/@google-cloud/gcloud-mcp)](https://www.npmjs.com/package/@google-cloud/gcloud-mcp)

# 克卢德磁共振 服务器 QQ

闪闪发光 [示范背景协议(MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) 服务器可以让 AI 助手轻松地与 Google Cloud 交互 使用 gcloud CLI 的环境。 您可以使用 gcloud MCP 服务器 :

-   **与Google Cloud互动使用自然语言.** 说明结果 您想要的不是记忆复杂的命令语法、旗帜和参数.
-   **自动化并简化复杂的工作流程.** 链式多云操作 变成一个单一的、可重复的命令,以减少手动努力和机会 错误.
-   **为云管理而降低入道障碍.** 授权小组成员: 不太熟悉gloud 以自信地进行强大的行动 安全无虞.

## 开始

### 先决条件

-   [节点.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)数字 : 版本20或以上
-   [克卢德 CLI](https://cloud.google.com/sdk/docs/install)

## QQ 设置您的 MCP 服务器

### 双子星CLI和双子星代码辅助

要将 MCP 服务器与双子座 CLI 或双子座代码辅助集成, 请运行设置 命令从表格中列出的 MCP 服务器的主目录中跳出。 这个 将安装 MCP 服务器为 [双子体 CLI 扩展](https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md)。 。 。 . 用于当前用户,并提供给您的所有项目.

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

初始化过程后,您可以验证gcloud-mcp服务器是 通过运行以下命令正确配置 :

```
gemini mcp list

> ✓ gcloud: npx -y @google-cloud/gcloud-mcp (stdio) - Connected
```

### 允许列表/ 拒绝列表命令

Gcloud MCP 服务器也允许允许列表/拒绝列表命令. 更多信息,请参见 [拒绝列表文档](https://npmcn.com/package/doc/denylist.md)。 。 。 .

### 其他AI客户端

要与其他客户端一起使用gcloud-mcp 服务器,请添加以下片段 每个 MCP 服务器的 JSON 配置文件 :

```json
"gcloud": {
  "command": "npx",
  "args": ["-y", "@google-cloud/gcloud-mcp"]
}
```

流行工具说明 :

-   **克劳德桌面 :** 打开 **克劳德 > 设置 > 开发者 > 编辑配置** 财务报告和审定财务报表 编辑 `claude_desktop_config.json`。 。 。 .
-   **线条 :** 然后单击 MCP 服务器图标 **配置 MCP 服务器** 要编辑 `cline_mcp_settings.json`。 。 。 .
-   **光标 :** 编辑 `.cursor/mcp.json` 用于单一项目或 `~/.cursor/mcp.json` 所有项目.
-   **双子座 CLI( 人工设置 ):** [如果不使用扩展名](https://npmcn.com/package/%40google-cloud/gcloud-mcp/#readme-gemini-cli-and-gemini-code-assist), (中文(简体) ), 编辑 `.gemini/settings.json` 用于单一项目或 `~/.gemini/settings.json` 页:1 所有项目.

对于 **视觉工作室代码** 编辑 `.vscode/mcp.json` 在工作空间中的文件 用于单个工程或您所有工程的全局用户设置文件:

```json
"servers": {
  "gcloud": {
    "command": "npx",
    "args": ["-y", "@google-cloud/gcloud-mcp"]
  }
}
```

## 地方发展

关于在当地安装寄存器的更多信息,请参见: [发展.md](https://npmcn.com/package/doc/DEVELOPMENT.md)

## 可用的 MCP 工具

| 工具 | 说明 |
| :-- | :-- |
| `run_gcloud_command` | 执行克云指令. 一些命令被特工限制执行. 见 [MCP 权限](https://npmcn.com/package/%40google-cloud/gcloud-mcp/#readme--mcp-permissions) 更多信息. |

## QQ MCP 权限

Gcloud MCP 的权限直接与活动者的权限挂钩 盖云帐. 限制许可和以最少原则运作 特权,你可以 [使用假冒授权作为服务账户](https://cloud.google.com/sdk/docs/authorizing#impersonation) 财务报告和审定财务报表 指定服务账户 a [带有有限权限的角色](https://cloud.google.com/iam/docs/roles-overview)。 。 。 .

默认情况下, gcloud MCP 阻止执行不执行的 gcloud 命令 对人工智能特工来说很合理 这样做是为了限制可以运行的命令 任意输入和启动交互式会议。 见 [这里](https://github.com/googleapis/gcloud-mcp/blob/ed743f04272744e57aa4990f5fcd9816a05b03ba/packages/gcloud-mcp/src/index.ts#L29) 用于拒绝的命令列表.

## 其他 Google Cloud MCP 服务器

Google Cloud提供这些其他服务器:

-   [火场MCP](https://firebase.google.com/docs/cli/mcp-server)
-   [谷歌分析MCP](https://github.com/googleanalytics/google-analytics-mcp)
-   [谷歌云源媒体 MCP](https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio/tree/main/experiments/mcp-genmedia)
-   [谷歌云运行 MCP](https://github.com/GoogleCloudPlatform/cloud-run-mcp)
-   [谷歌Kubernetes引擎(GKE) MCP](https://github.com/GoogleCloudPlatform/gke-mcp)
-   [谷歌安全业务和威胁情报MCP](https://github.com/google/mcp-security)
-   [MCP 数据库工具箱](https://github.com/googleapis/genai-toolbox)

## 捐款

我们欢迎捐款! 无论是修复错误,共享反馈,还是 欢迎你们的贡献。 请读我们的 [贡献指南](https://npmcn.com/package/CONTRIBUTING.md) 要开始.

## 重要笔记

此寄存器正在预览中, 可能看到断开的更改 。 这个 仓库提供了一个解决方案,而不是官方支持的Google产品. 这个 不包括在内 [谷歌云服务条款](https://cloud.google.com/terms)。 。 。 . 当 MCP 规格、 其他 SDK 或 当其他溶液出现时可能断裂 和产品改变。 也见我们的 [安全政策](https://npmcn.com/package/SECURITY.md)。 。 。 .

## 常见问题

### @google-cloud/gcloud-mcp 是什么？

用于与 GCP API 互动的模拟上下文协议服务器

### 如何安装 @google-cloud/gcloud-mcp？

在项目目录运行 npm install @google-cloud/gcloud-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gcloud-mcp，可以用 npx gcloud-mcp 直接运行。

### @google-cloud/gcloud-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/google-cloud\_\_gcloud-mcp 是否存在。

### @google-cloud/gcloud-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @google-cloud/gcloud-mcp 可以商用吗？

@google-cloud/gcloud-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @google-cloud/gcloud-mcp 的下载量有多少？

根据 npm 官方下载统计，@google-cloud/gcloud-mcp 在 2026/10/17 – 2026/11/15 这 30 天内被下载 265,397 次，日均约 8,847 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @google-cloud/gcloud-mcp 还在维护吗？

最新版本 0\.5\.3 发布于 2026/01/06（10 个月前）；至今共发布 9 个版本，其中过去 12 个月发布了 4 个；首次发布于 2025/09/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

