Cloud Run MCP

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

本项目可让支持MCP的AI代理将应用程序部署到Cloud Run。通过简单配置和使用相关工具，能从不同途径实现代码部署，为开发者提供便捷高效的部署体验。

🚀 快速开始

配置MCP服务器

要使MCP服务器能将代码部署到Cloud Run，需在配置文件中添加如下内容：

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

部署途径

• 从AI驱动的IDE部署：可直接在支持的IDE中进行代码部署操作。
• 从AI助手应用部署：借助AI助手应用实现代码部署。
• 从代理SDK部署：例如使用 Google Gen AI SDK 或 Agent Development Kit 进行部署。

⚠️ 重要提示

此为将代码部署到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辅助IDE（如Cursor）或桌面AI应用（如Claude），可在本地机器上使用本地Google Cloud凭证运行Cloud Run MCP服务器。

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

   gcloud auth login
   

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

   gcloud auth application-default login
   

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

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

作为远程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. 在本地机器上运行Cloud Run代理，使用您的身份安全连接到在Cloud Run上运行的远程MCP服务器：

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

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

6. 使用以下内容更新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"]
      }