← 返回目录

Cloud Run MCP Server

官方

通过MCP在云端部署应用的服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 云存储第 13 / 15
Stars: ★ 633 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Docker
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 3 天前
工具数: 7

47FMRS · D

一个功能强大的MCP服务器，用于Cloud Run部署，提供多种工具和提示。它很适合AI辅助工作流，但需要谨慎配置身份验证和安全设置。

最强项 · 文档质量 13/20 最弱项 · 安全与权限 3/20

可靠性

6/20

安全与权限

3/20

维护活跃度

13/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: 仅能审阅 README 与仓库元数据，服务端 manifest 未提供；没有源码、CI 工作流或提交测试作为可验证的执行证据。README 列出了 7 个工具和 2 个 prompt，并提供 npx/docker/node 启动方式，但工具真实行为、错误处理和依赖可控性均无法确认；deploy-local-folder/list-projects/create-project 标注为仅本地可用，增加了条件性。因此按静态校准上限扣分，给 6 分。
安全与权限 3/20: 凭据处理使用 gcloud ADC / GOOGLE_APPLICATION_CREDENTIALS，远程模式强调 IAM 认证且警告不要无认证使用，OAuth 流程已说明；但默认 SKIP_IAM_CHECK=true 会使 Cloud Run 服务公开，ENABLE_HOST_VALIDATION 默认关闭（DNS Rebinding 防护禁用），deploy 类工具会直接触发部署副作用且 README 未描述任何确认机制。这触及“未经确认的部署”红线，因此安全分只能在 0-4 区间，给 3。
维护活跃度 13/20: 仓库未归档、Apache-2.0、GoogleCloudPlatform 所有权明确；README 持续更新（OAuth、skills、Gemini CLI）。但没有版本发布记录、提交频率、依赖更新或安全响应渠道证据，22 个未关闭 issue 也未见处理说明。维护活跃但治理/发布证据不足，给 13。
文档质量 13/20: README 提供本地/远程/Docker/OAuth 多路径安装、客户端配置示例、环境变量表、工具清单和 prompt 说明，也有指向各客户端配置的链接；但缺少每个工具的参数字段/输入 schema、配额与成本、故障排查和限制说明，也没有可审查的示例输出。文档可用但存在隐藏假设与排障缺口，给 13。
安装易用性 12/20: 本地路径步骤清晰：安装 gcloud、登录、配置 JSON；也提供 Docker 和远程运行方式，并给出多种主流客户端的配置示例。但需要 gcloud 认证、ADC、可选 OAuth/代理，步骤较多且依赖外部凭据；没有 CI/测试证据证明配置可复现成功，因此按静态校准低于 15。给 12。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络修改第三方账户数据

适合谁

希望将部署集成到AI工作流的开发者和团队
使用Google Cloud和Cloud Run的用户
希望快速原型化或部署应用程序的AI代理

不适合谁

需要本地部署或其他云平台支持的部署
需要精细IAM控制且不希望跳过权限检查的用户
寻求GitOps或完全自动化的CI/CD而不使用MCP/CLI的用户

所需权限

需要Google Cloud IAM凭据才能访问Cloud Run API。
需要`gcloud auth login`和`gcloud auth application-default login`进行身份验证。
部署需要适当的Cloud Run权限，例如`run.services.create`和`run.services.update`。
创建项目需要`resourcemanager.projects.create`等权限。

风险与副作用

使用未经身份验证的远程MCP服务器可能导致未经授权的访问。
IAM检查默认跳过（`SKIP_IAM_CHECK=true`），可能允许过度宽松的权限。
部署文件内容可能暴露敏感数据（如果在提示中提供）。
存在DNS重绑定风险，除非启用主机验证（`ENABLE_HOST_VALIDATION`）。

安装接入

准备工作

运行环境：Node.js · Docker

GOOGLE_APPLICATION_CREDENTIALS 可选密钥 Docker 运行方式下指向 gcloud 应用默认凭据 JSON 文件路径，通过 gcloud auth application-default login 生成。

其他可选配置项（6 个）

GOOGLE_CLOUD_PROJECT 可选默认的 GCP 项目 ID，可在 GCP 控制台或 gcloud config 中查看；可选。

GOOGLE_CLOUD_REGION 可选默认的 Cloud Run 部署区域，如 us-central1；可选。

DEFAULT_SERVICE_NAME 可选未指定服务名时使用的默认服务名；可选。

SKIP_IAM_CHECK 可选是否跳过 IAM 权限检查，默认 true；设为 false 启用检查；可选。

ENABLE_HOST_VALIDATION 可选启用 Host 头校验以防 DNS Rebinding，默认关闭；可选。

ALLOWED_HOSTS 可选启用主机校验后允许的 Host 列表，逗号分隔，默认 localhost,127.0.0.1,::1；可选。

安装Google Cloud SDK并进行身份验证：gcloud auth login和gcloud auth application-default login。
配置MCP客户端，例如使用npx命令：npx -y @google-cloud/cloud-run-mcp。
可选：设置环境变量，如GOOGLE_CLOUD_PROJECT、GOOGLE_CLOUD_REGION和DEFAULT_SERVICE_NAME。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add cloud-run -- npx -y @google-cloud/cloud-run-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中连接后应能看到 deploy-file-contents、list-services 等工具；然后执行类似“列出该项目中的 Cloud Run 服务”的提示，若返回服务列表则说明认证和连接正常。

常见排障

确保已安装gcloud并正确认证。
验证默认项目和区域设置。
检查`SKIP_IAM_CHECK`设置如果遇到权限错误。
对于远程设置，确保Cloud Run MCP服务器部署在同一个项目中。
如果连接问题，运行`gcloud auth application-default login`。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出项目 my-project 在 us-central1 区域的所有 Cloud Run 服务
把当前目录部署为 Cloud Run 服务 hello-world
查看服务 hello-world 的日志和错误信息
获取服务 hello-world 的详细信息

工具能力 7

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项目，并关联第一个可用的结算账户。

使用场景

从AI辅助IDE（如Cursor）或桌面AI应用（如Claude）部署应用

通过Gemini CLI或Agent SDK进行AI代理驱动的部署

在云环境中自动化Cloud Run服务管理

支持客户端

Gemini CLI

Claude Desktop部分支持

VS Code部分支持

Cursor部分支持

Windsurf部分支持

Antigravity部分支持

依据项目文档列出，未经本站实测。

详细介绍

Cloud Run MCP服务器允许MCP兼容的AI代理将应用部署到Google Cloud Run。它提供工具来部署文件或本地文件夹，列出和管理服务，以及获取日志。此外，它还包含用于常见任务的提示，以及用于管理项目的高级工具。