Cloud Run MCP 服务器和 Gemini CLI 扩展

使兼容 MCP（模型上下文协议）的人工智能代理能够将应用部署到 Cloud Run。

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

从 Gemini CLI 和其他由 AI 驱动的 CLI 代理部署：

从由 AI 驱动的集成开发环境（IDE）部署：

从 AI 助手应用部署：

从代理软件开发工具包（SDK）部署，例如 Google Gen AI SDK 或 Agent Development Kit。

[!NOTE]
本仓库是一个用于将代码部署到 Cloud Run 的 MCP 服务器，要了解如何在 Cloud Run 上托管MCP 服务器，请访问 Cloud Run 文档。

工具

• deploy-file-contents：通过直接提供文件内容将文件部署到 Cloud Run。

• list-services：列出指定项目和区域中的 Cloud Run 服务。

• get-service：获取特定 Cloud Run 服务的详细信息。

• get-service-log：获取特定 Cloud Run 服务的日志和错误信息。

• deploy-local-folder*：将本地文件夹部署到 Google Cloud Run 服务。

• list-projects*：列出可用的 GCP（Google Cloud Platform）项目。

• create-project*：创建一个新的 GCP 项目并将其关联到第一个可用的结算账号。可以选填项目 ID。

* 仅在本地运行时可用

提示词

提示词是可用来执行常见任务的自然语言命令。它们是使用预填充参数执行工具调用的快捷方式。

• deploy：将当前工作目录部署到 Cloud Run。如果未提供服务名称，将使用 DEFAULT_SERVICE_NAME 环境变量或当前工作目录的名称。
• logs：获取 Cloud Run 服务的日志。如果未提供服务名称，将使用 DEFAULT_SERVICE_NAME 环境变量或当前工作目录的名称。

环境变量

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

变量	描述
GOOGLE_CLOUD_PROJECT	用于 Cloud Run 服务的默认项目 ID。
GOOGLE_CLOUD_REGION	用于 Cloud Run 服务的默认区域。
DEFAULT_SERVICE_NAME	用于 Cloud Run 服务的默认服务名称。
SKIP_IAM_CHECK	控制是否检查 Cloud Run 服务的 IAM（身份和访问管理）权限。设置为 false 以启用检查。默认为 true，这是将服务公开的建议方式。
ENABLE_HOST_VALIDATION	通过验证 Host 请求头防止 DNS 重绑定攻击。默认禁用。
ALLOWED_HOSTS	允许的 Host 请求头的逗号分隔列表（如果启用了主机验证）。默认值为 localhost,127.0.0.1,::1。

用作 Gemini CLI 扩展

要将此工具安装为 Gemini CLI 扩展，请运行以下命令：

2. 安装扩展：

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

3. 使用以下命令登录您的 Google Cloud 账号：

   gcloud auth login
   

4. 使用以下命令设置应用凭据：

   gcloud auth application-default login
   

在 MCP 客户端中使用

了解如何配置您的 MCP 客户端

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

不同客户端的配置文件语法可能不同。请参考以下链接获取最新的预期语法：

• Antigravity
• Windsurf
• VSCode
• Claude Desktop
• Cursor

确定如何配置您的 MCP 客户端后，请选择以下两个选项之一来设置 MCP 服务器。 我们建议使用 Node.js 将其设置为本地 MCP 服务器。

设置为本地 MCP (模型上下文协议) 服务器

使用本地 Google Cloud 凭据在本地机器上运行 Cloud Run MCP 服务器。如果您使用的是 AI 辅助 IDE (集成开发环境)（例如 Cursor）或桌面 AI 应用程序（例如 Claude），这是最佳选择。

1. 安装 Google Cloud SDK (软件开发工具包) 并使用您的 Google 账号进行身份验证。

2. 使用以下命令登录您的 Google Cloud 账号：

   gcloud auth login
   

3. 使用以下命令设置应用凭据：

   gcloud auth application-default login
   

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

使用 Node.js

0. 安装 Node.js（建议使用 LTS 版本）。

1. 使用以下内容更新您的 MCP 客户端的 MCP 配置文件：

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

2. [可选] 添加默认配置

      "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"
         }
      }
   

使用 Docker

请参阅 Docker 的 MCP 目录，或使用以下手动说明：

0. 安装 Docker

1. 使用以下内容更新您的 MCP 客户端的 MCP 配置文件：

      "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 Run MCP 服务器本身，并通过 IAM 对来自本地机器的连接进行身份验证。 使用此选项，您只能将代码部署到与 MCP 服务器运行位置相同的 Google Cloud 项目中。

1. 安装 Google Cloud SDK (软件开发工具包) 并使用您的 Google 账号进行身份验证。

2. 使用以下命令登录您的 Google Cloud 账号：

   gcloud auth login
   

3. 使用以下命令设置您的 Google Cloud 项目 ID：

   gcloud config set project YOUR_PROJECT_ID
   

4. 将 Cloud Run MCP 服务器部署到 Cloud Run：

   gcloud run deploy cloud-run-mcp --image us-docker.pkg.dev/cloudrun/container/mcp --no-allow-unauthenticated
   

   出现提示时，选择一个区域，例如 europe-west1。

   请注意，MCP 服务器_不_可公开访问，它需要通过 IAM 进行身份验证。

5. [可选] 添加默认配置

   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 服务器：

   gcloud run services proxy cloud-run-mcp --port=3000 --region=REGION --project=PROJECT_ID
   

   这将在端口 3000 上创建一个本地代理，将请求转发到远程 MCP 服务器并注入您的身份。

7. 使用以下内容更新您的 MCP 客户端的 MCP 配置文件：

      "cloud-run": {
        "url": "http://localhost:3000/sse"
      }
   

   如果您的 MCP 客户端不支持 url 属性，您可以使用 mcp-remote：

      "cloud-run": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "http://localhost:3000/sse"]
      }
   

使用支持 OAuth (开放授权) 的 MCP 服务器

Cloud Run MCP 服务器支持 OAuth 作为身份验证机制。为了使用 OAuth，请创建 OAuth 客户端，并使用与您的 OAuth 客户端相关的适当值配置 .env 文件。提供了 .env.example 作为参考。

Cloud Run MCP 服务器可与 Google Cloud SDK OAuth 客户端无缝协作。为了利用 Google Cloud SDK OAuth 客户端，您可以按如下方式将 .env.gcloud-sdk-oauth 文件用作您的 .env 文件：

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

在 Gemini CLI (命令行界面) 上配置 MCP 服务器以使用 OAuth

当 Cloud Run MCP 服务器以 OAuth 模式启动时，MCP 客户端也应配置为使用 OAuth。您可以通过在 ~/.gemini/settings.json 文件中使用以下 JSON 在 Gemini CLI 中设置 OAuth 模式的 MCP 服务器：

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

完成上述配置更改后，启动 Gemini CLI。您应该使用 Gemini CLI 中的以下提示对 Cloud Run MCP 服务器进行身份验证：

/mcp auth cloud-run

这将带您进入浏览器中的身份验证页面，您需要使用适当的 Gmail 账号登录，并接受条款和条件。身份验证成功后，您可以返回 Gemini CLI，Cloud Run MCP 服务器即可使用。

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

cloud-run-mcp 快速上手指南

环境准备

系统要求

• Node.js: LTS 版本（推荐 v20+）
• Google Cloud SDK: 最新版
• 操作系统: macOS、Linux 或 Windows

前置依赖

1. 注册 Google Cloud 账号并创建项目
2. 安装 Node.js（国内可使用 淘宝镜像加速）
3. 安装 Google Cloud SDK

安装步骤

1. 配置 Google Cloud 认证

# 登录 Google Cloud 账号
gcloud auth login

# 设置应用默认凭证
gcloud auth application-default login

# 设置默认项目（可选）
gcloud config set project YOUR_PROJECT_ID

2. 配置 MCP 客户端

在您的 MCP 客户端配置文件中添加以下内容（如 Cursor、Claude Desktop 等）：

{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": ["-y", "@google-cloud/cloud-run-mcp"],
      "env": {
        "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID",
        "GOOGLE_CLOUD_REGION": "us-central1"
      }
    }
  }
}

国内加速方案：若 npx 下载缓慢，可配置 npm 淘宝镜像：

npm config set registry https://registry.npmmirror.com

基本使用

部署应用

在 AI 客户端中输入自然语言指令：

将当前目录部署到 Cloud Run

或使用默认服务名部署：

使用 cloud-run 部署

常用操作

• 查看服务列表: "列出 Cloud Run 服务"
• 获取服务详情: "获取服务 my-service 的信息"
• 查看日志: "获取 cloud-run 日志"

环境变量配置

在 MCP 配置中可设置以下变量：

变量名	说明	示例
GOOGLE_CLOUD_PROJECT	默认项目 ID	my-project-123
GOOGLE_CLOUD_REGION	默认区域	asia-east1
DEFAULT_SERVICE_NAME	默认服务名	my-app

快速部署示例

1. 进入项目目录：cd my-app
2. 在 AI 客户端输入：部署到 Cloud Run
3. 工具会自动打包当前目录并部署

提示：首次部署可能需要启用 Cloud Run API，按提示操作即可。