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