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

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

版本：1\.12\.0
npm 元数据更新时间：2026-11-09T07:41:47.458Z
中文译文更新时间：2026-11-16T20:09:39.227Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：15.3 MB，90 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：17 个
- 首次发布：2025-08-12T19:51:00.863Z
- 最新版本发布：2026-11-09T07:41:47.240Z
- 近 30 天下载量：40591（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 7 个）

## 中文简介

Cloud 运行 MCP 部署工具

## 安装

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

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

## README

# Cloud 运行 MCP 服务器和双子座 CLI 扩展

启用MCP相容的AI代理,将应用程序部署到Cloud Run.

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

从双子星CLI和其他AI授权的CLI特工部署:

![](https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/refs/heads/main/.github/images/deploycli.gif)

由AI驱动的IDE部署:

![](https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/refs/heads/main/.github/images/deploy_from_ide.gif)

从 AI 助理应用程序中部署:

![](https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/refs/heads/main/.github/images/deploy_from_apps.gif)

从SDK探员那里部署,就像 [Google Gen AI SDK 软件](https://ai.google.dev/gemini-api/docs/function-calling?example=meeting#use_model_context_protocol_mcp) 或者说 [代理开发工具箱](https://google.github.io/adk-docs/tools/mcp-tools/)。 。 。 .

> \[注\]  
> 这是 MCP 服务器的寄存器,用于向 Cloud Run 部署代码,以学习如何 **东道主** 云跑的MCP服务器, [访问 Cloud 运行文档](https://cloud.google.com/run/docs/host-mcp-servers)。 。 。 .

## 工具

-   `deploy-file-contents`:通过直接提供文件内容向 Cloud Run 部署文件 .
    
-   `list-services`: 列出云 在特定项目和地区运行服务.
    
-   `get-service`:获取特定云跑服务的细节.
    
-   `get-service-log`: 为特定云跑服务获取日志和出错消息.
    
-   `deploy-local-folder`\*:向谷歌云跑服务部署本地文件夹.
    
-   `list-projects`\*:现有全球气候方案项目清单.
    
-   `create-project`\*:创建新的GCP项目并附入第一个可用的计费账户. 工程ID可以选择指定.
    

_\* 仅在本地运行时可用_

## 提示

提示是可用于执行共同任务的自然语言命令. 它们是使用预填参数执行工具呼叫的快捷键 .

-   `deploy`: 将当前工作目录部署到 Cloud Run 。 如果不提供服务名称,它将使用 `DEFAULT_SERVICE_NAME` 环境变量,或当前工作目录的名称.
-   `logs`: 为"云跑"服务获得日志. 如果不提供服务名称,它将使用 `DEFAULT_SERVICE_NAME` 环境变量,或当前工作目录的名称.

## 环境变量

Cloud Run MCP 服务器可以使用以下环境变量配置:

| 变量 | 说明 |
| :-- | :-- |
| `GOOGLE_CLOUD_PROJECT` | 用于 Cloud 运行服务的默认项目 ID . |
| `GOOGLE_CLOUD_REGION` | 用于 Cloud 运行服务的默认区域 . |
| `DEFAULT_SERVICE_NAME` | 用于 Cloud Run 服务的默认服务名称 . |
| `SKIP_IAM_CHECK` | 控制是否检查 Cloud Run 服务的 IAM 权限 。 设定为 `false` 以允许检查。 这是 `true` 默认情况下,这是公布服务的建议方式. |
| `ENABLE_HOST_VALIDATION` | 预防 [DNS 重新绑定](https://en.wikipedia.org/wiki/DNS_rebinding) 通过验证主机头进行攻击。 此默认已禁用 . |
| `ALLOWED_HOSTS` | 以逗号分隔的允许主机头列表(如果启用主机验证). 默认值为 `localhost,127.0.0.1,::1`。 。 。 . |
| `OAUTH_ENABLED` | 启用 OAuth 2.0 当 HTTP/SSE 请求设定为 `true`。默认已禁用. |
| `GOOGLE_OAUTH_AUDIENCE` | 期待的 OAuth 2.0 令牌观众(通常为您的 OAuth 客户端ID). 需要时间 `OAUTH_ENABLED=true`。 。 。 . |

## 用作双子座 CLI 扩展名

要安装为 [双子座CLI](https://github.com/google-gemini/gemini-cli) 扩展名,运行以下命令:

2.  安装扩展名 :
    
    ```bash
    gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp
    ```
    
3.  使用命令登录您的 Google Cloud 账户 :
    
    ```bash
    gcloud auth login
    ```
    
4.  使用命令设置应用程序证书 :
    
    ```bash
    gcloud auth application-default login
    ```
    

## MCP 客户端中的使用

### 学习如何配置您的 MCP 客户端

大多数MCP客户端需要创建或修改配置文件来添加MCP服务器.

配置文件语法可以不同客户端. 关于最新的预期语法,请参考以下链接:

-   [**反重力**](https://antigravity.google/docs/mcp)
-   [**风起浪起**](https://docs.windsurf.com/windsurf/mcp)
-   [**虚拟系统**](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
-   [**克劳德桌面**](https://modelcontextprotocol.io/quickstart/user)
-   [**光标**](https://docs.cursor.com/context/model-context-protocol)

一旦您确定如何配置您的 MCP 客户端, 请选择其中之一来设置 MCP 服务器 . 我们建议使用Node.js建立本地的MCP服务器.

### 设置为本地 MCP 服务器

使用本地Google Cloud证书在您本地机器上运行 Cloud Run MCP 服务器. 这最好使用AI辅助的IDE(如Cursor)或桌面AI应用程序(如克洛德).

1.  安装 [谷歌云SDK](https://cloud.google.com/sdk/docs/install) 并认证您的谷歌账户.
    
2.  使用命令登录您的 Google Cloud 账户 :
    
    ```bash
    gcloud auth login
    ```
    
3.  使用命令设置应用程序证书 :
    
    ```bash
    gcloud auth application-default login
    ```
    

然后使用 Node.js 或 Docker 配置 MCP 服务器 :

#### 使用节点.js

0.  安装 [节点.js](https://nodejs.org/en/download/) (LTS版本推荐).
    
1.  更新您的 MCP 客户端的 MCP 配置文件如下 :
    
    ```json
       "cloud-run": {
         "command": "npx",
         "args": ["-y", "@google-cloud/cloud-run-mcp"]
       }
    ```
    
2.  \[可选 添加默认配置
    
    ```json
       "cloud-run": {
          "command": "npx",
          "args": ["-y", "@google-cloud/cloud-run-mcp"],
          "env": {
                "GOOGLE_CLOUD_PROJECT": "PROJECT_NAME",
                "GOOGLE_CLOUD_REGION": "PROJECT_REGION",
                "DEFAULT_SERVICE_NAME": "SERVICE_NAME"
          }
       }
    ```
    

#### 使用嵌入器

见多克的 [MCP 目录](https://hub.docker.com/mcp/server/cloud-run-mcp/overview),或使用这些手动说明:

0.  安装 [夹克](https://www.docker.com/get-started/)
    
1.  更新您的 MCP 客户端的 MCP 配置文件如下 :
    
    ```json
       "cloud-run": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "GOOGLE_APPLICATION_CREDENTIALS",
           "-v",
           "/local-directory:/local-directory",
           "mcp/cloud-run-mcp:latest"
         ],
         "env": {
           "GOOGLE_APPLICATION_CREDENTIALS": "/Users/slim/.config/gcloud/application_default-credentials.json",
           "DEFAULT_SERVICE_NAME": "SERVICE_NAME"
         }
       }
    ```
    

### 设置为远程 MCP 服务器

> \[尖叫声\]  
> 没有认证, 请不要使用远程 MCP 服务器 。 在以下指令中,我们将使用IAM认证,从您本地机器中确保与MCP服务器的连接. 这对于防止擅自访问你的Google Cloud资源很重要.

在 Cloud Run 上运行 Cloud 运行的 MCP 服务器本身, 通过 IAM 认证您的本地机器的连接 . 使用此选项, 您只能将代码部署到与 MCP 服务器运行位置相同的 Google Cloud 项目 .

1.  安装 [谷歌云SDK](https://cloud.google.com/sdk/docs/install) 并认证您的谷歌账户.
    
2.  使用命令登录您的 Google Cloud 账户 :
    
    ```bash
    gcloud auth login
    ```
    
3.  使用命令设置您的 Google Cloud 项目 ID :
    
    ```bash
    gcloud config set project YOUR_PROJECT_ID
    ```
    
4.  将 Cloud 运行 MCP 服务器部署到 Cloud 运行 :
    
    ```bash
    gcloud run deploy cloud-run-mcp --image us-docker.pkg.dev/cloudrun/container/mcp --no-allow-unauthenticated
    ```
    
    需要时,请选择一个区域,例如 `europe-west1`。 。 。 .
    
    注意 MCP 服务器是 _没有_ 它需要通过IAM认证.
    
5.  \[可选 添加默认配置
    
    ```bash
    gcloud run services update cloud-run-mcp --region=REGION --update-env-vars GOOGLE_CLOUD_PROJECT=PROJECT_NAME,GOOGLE_CLOUD_REGION=PROJECT_REGION,DEFAULT_SERVICE_NAME=SERVICE_NAME,SKIP_IAM_CHECK=false
    ```
    
6.  在您的本地机器上运行 Cloud Run 代理服务器, 以安全使用您的身份连接到运行在 Cloud Run 上的远程 MCP 服务器 :
    
    ```bash
    gcloud run services proxy cloud-run-mcp --port=3000 --region=REGION --project=PROJECT_ID
    ```
    
    这将在端口3000上创建一个本地代理,将请求转发到远程 MCP 服务器并注入您的身份.
    
7.  更新您的 MCP 客户端的 MCP 配置文件如下 :
    
    ```json
       "cloud-run": {
         "url": "http://localhost:3000/sse"
       }
    
    ```
    
    如果您的 MCP 客户端不支持 `url` 属性,您可以使用 [mcp 远程](https://www.npmjs.com/package/mcp-remote)数字 :
    
    ```json
       "cloud-run": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "http://localhost:3000/sse"]
       }
    ```
    

## 使用 MCP 软件 OAuth 服务器

Cloud Run MCP服务器支持OAuth作为认证机制. 为了使用OAuth,创建OAuth客户端,并配置一个 `.env` 与您的 OAuth 客户端相关的相应值。 A 类 `.env.example` 提供参考.

Cloud Run MCP服务器与Google Cloud SDK OAuth客户端无缝合作. 为了利用Google Cloud SDK OAuth客户端,您可以使用 `.env.gcloud-sdk-oauth` 文件为您的 `.env` 文档如下:

```bash
cp .env.gcloud-sdk-oauth .env
node mcp-server.js
```

### 配置 MCP 在双子座 CLI 上使用 OAuth 的服务器

当Cloud Run MCP服务器以OAuth模式启动时,MCP客户端也应当被配置到使用OAuth. 您可以在双子座 CLI 中以 OAuth 模式设置 MCP 服务器, 使用以下 JSON : `~/.gemini/settings.json` 文件 :

```json
{
  "mcpServers": {
    "cloud-run": {
      "httpUrl": "http://localhost:3000/mcp",
      "oauth": {
        "enabled": true,
        "clientId": "<OAUTH_CLIENT_ID>",
        "clientSecret": "<OAUTH_CLIENT_SECRET>"
      }
    }
  }
}
```

发布上述配置变化,启动双子座CLI. 您应该使用双子座 CLI 中的以下提示认证 Cloud 运行 MCP 服务器 :

```
/mcp auth cloud-run
```

这将带您到浏览器上的认证页面, 您需要在这里使用相应的 gmail ID 签名, 并接受条款和条件 。 一旦认证成功,你可以回到双子座CLI,而"云跑"MCP服务器将准备使用.

谷歌云平台服务条款(见 [https://cloud.google.com/terms/ 互联网档案馆的存檔,存档日期2013-12-02](https://cloud.google.com/terms/)以及《数据处理和安全术语》 (见 [https://cloud.google.com/terms/data-process-terms (中文(简体) )](https://cloud.google.com/terms/data-processing-terms))不适用于Cloud Run MCP服务器软件的任何组件.

# 云跑技能

我们引进了"云跑"技术,让AI代理在"云跑"上进行动作. 你可以用双子座CLI和其他代理AI工具使用这些技能. 职业技能: [云跑技能](https://github.com/GoogleCloudPlatform/cloud-run-mcp/blob/main/skills/cloud-run/SKILL.md)。 。 。 .

Cloud Run技巧基于gcloud cli的上方,用于Cloud Run授权代理使用gcloud执行"Cloud Run"上的所有动作,GCP用户使用gcloud cli可以执行.

为了使用"云跑"技能:

1.  确保你拥有 `gcloud` 安装和认证CLI `gcloud auth login` 财务报告和审定财务报表 `gcloud auth application-default login`。 。 。 .
2.  设定您的项目 `gcloud config set project [PROJECT_ID]`。 。 。 .
3.  启用您的代理 AI 工具的技能 。 例如,您可以在终端上使用以下命令启用双子座 CLI 的技能 :

```bash
gemini skills install https://github.com/GoogleCloudPlatform/cloud-run-mcp.git --path skills/cloud-run
```

4.  一旦技能被启用,您就可以在Cloud Run上使用它们来进行动作. 以下是一些让你开始的提示:

-   列出我们西部地区项目测试-gcp-项目中的"云跑"服务.
    
-   将文件夹 / home/username/workspace/hello-world作为Cloud Run服务 Hello-world 用于我们西部地区的项目测试-gcp-项目.
    
-   描述欧洲西部地区项目测试-gcp-项目中的Cloud Run Hello-job.

## 常见问题

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

Cloud 运行 MCP 部署工具

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

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

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

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

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

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

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

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

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

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

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

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

