Cloud Run MCP

🚀 MCP服务器：将代码部署到Google Cloud Run

本项目能够让兼容MCP的AI智能体将应用程序部署到Cloud Run上。

"mcpServers":{
  "cloud-run": {
    "command": "npx",
    "args": ["-y", "https://github.com/GoogleCloudPlatform/cloud-run-mcp"]
  }
}

支持的部署途径

• 从AI驱动的集成开发环境（IDE）部署
• 从AI助手应用程序部署
• 从智能体软件开发工具包（SDK）部署，例如 Google Gen AI SDK 或 智能体开发套件。

⚠️ 重要提示

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

✨ 主要特性

工具列表

• deploy-file-contents：直接通过提供文件内容将文件部署到Cloud Run。
• list-services：列出指定项目和区域中的Cloud Run服务。
• get-service：获取特定Cloud Run服务的详细信息。
• deploy-local-files*：将本地文件系统中的文件部署到Google Cloud Run服务。
• deploy-local-folder*：将本地文件夹部署到Google Cloud Run服务。
• list-projects*：列出可用的GCP项目。
• create-project*：创建一个新的GCP项目，并将其附加到第一个可用的计费账户。可选择指定项目ID。

* 仅在本地运行时可用

🚀 快速开始

💻 使用示例

作为本地MCP服务器使用

如果你使用的是AI辅助集成开发环境（如Cursor）或桌面AI应用程序（如Claude），可以使用本地Google Cloud凭证在本地机器上运行Cloud Run MCP服务器。

1. 安装Node.js：安装 Node.js（建议使用LTS版本）。
2. 安装Google Cloud SDK并认证：安装 Google Cloud SDK，并使用你的Google账户进行认证。
3. 登录Google Cloud账户：使用以下命令登录你的Google Cloud账户：

gcloud auth login

4. 设置应用程序凭证：使用以下命令设置应用程序凭证：

gcloud auth application-default login

5. 更新MCP配置文件：将MCP客户端的MCP配置文件更新为以下内容：

"cloud-run": {
  "command": "npx",
  "args": ["-y", "https://github.com/GoogleCloudPlatform/cloud-run-mcp"]
}

作为远程MCP服务器使用

⚠️ 重要提示

请勿在未进行身份验证的情况下使用远程MCP服务器。在以下说明中，我们将使用IAM身份验证来确保从本地机器到MCP服务器的连接安全。这对于防止未经授权访问你的Google Cloud资源至关重要。

通过IAM对本地机器的连接进行身份验证，可在Cloud Run上运行Cloud Run MCP服务器本身。使用此选项时，你只能将代码部署到与MCP服务器运行所在的同一Google Cloud项目中。

1. 安装Google Cloud SDK并认证：安装 Google Cloud SDK，并使用你的Google账户进行认证。
2. 登录Google Cloud账户：使用以下命令登录你的Google Cloud账户：

gcloud auth login

3. 设置Google Cloud项目ID：使用以下命令设置你的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. 在本地机器上运行Cloud Run代理：使用以下命令在本地机器上运行Cloud Run代理，以使用你的身份安全地连接到在Cloud Run上运行的远程MCP服务器：

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

这将在端口3000上创建一个本地代理，将请求转发到远程MCP服务器并注入你的身份。 6. 更新MCP配置文件：将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"]
}