Cloud Run MCP 服务器和 Gemini CLI 扩展

使支持 MCP 的 AI 代理能够将应用部署到 Cloud Run。

json
"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 项目。

• create-project*：创建一个新的 GCP 项目，并将其附加到第一个可用的结算账户。可以可选地指定一个项目 ID。

* 仅在本地运行时可用

提示

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

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

作为 Gemini CLI 扩展使用

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

1. 安装扩展：

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

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

   bash
   gcloud auth login

3. 使用以下命令设置应用程序凭据：
   bash
   gcloud auth application-default login

在 MCP 客户端中使用

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

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

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

• 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 账户：

   bash
   gcloud auth login

3. 使用以下命令设置应用程序凭据：
   bash
   gcloud auth application-default login然后使用Node.js或Docker配置MCP服务器：

使用Node.js

1. 安装Node.js（推荐LTS版本）。

2. 更新您的MCP客户端的MCP配置文件，添加以下内容：

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

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

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

使用Docker

请参阅Docker的MCP目录，或者按照以下手动说明操作：

1. 安装Docker

2. 更新您的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服务器

[!WARNING]
请勿在没有认证的情况下使用远程MCP服务器。在以下说明中，我们将使用IAM认证来保护从本地机器到MCP服务器的连接。这对于防止未经授权访问您的Google Cloud资源非常重要。

在Cloud Run上运行Cloud Run MCP服务器，并通过IAM从本地机器进行身份验证。
使用此选项，您只能将代码部署到与MCP服务器相同的Google Cloud项目中。

1. 安装Google Cloud SDK并使用您的Google帐户进行身份验证。

2. 使用以下命令登录您的Google Cloud帐户：
   bash
   gcloud auth login

3. 使用以下命令设置您的Google Cloud项目ID：
   bash
   gcloud config set project YOUR_PROJECT_ID

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

   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-remote：

   json
   "cloud-run": {
   "command": "npx",
   "args": ["-y", "mcp-remote", "http://localhost:3000/sse"]
   }Google Cloud Platform 服务条款（可访问于 https://cloud.google.com/terms/）和数据处理与安全条款（可访问于 https://cloud.google.com/terms/data-processing-terms）不适用于 Cloud Run MCP Server 软件的任何组件。