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