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或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服务器使用

使用本地Google Cloud凭证在本地机器上运行Cloud Run MCP服务器。如果您使用的是AI辅助的IDE（如Cursor）或桌面AI应用程序（如Claude），这种方式最为合适。

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