Cloud Run MCP

🚀 Cloud Runへのコードデプロイ用MCPサーバー

MCP互換のAIエージェントがCloud Runにアプリをデプロイできるようにします。

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

AI搭載のIDEからのデプロイ:

AIアシスタントアプリからのデプロイ:

Google Gen AI SDK や Agent Development Kit などのエージェント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サーバーとしての使用

ローカルのGoogle Cloud資格情報を使用して、ローカルマシン上でCloud Run MCPサーバーを実行します。これは、AI支援のIDE（例: Cursor）やデスクトップAIアプリケーション（例: Claude）を使用している場合に最適です。

0. Node.js をインストールします（LTSバージョンを推奨）。

1. Google Cloud SDK をインストールし、Googleアカウントで認証します。

2. 以下のコマンドを使用してGoogle Cloudアカウントにログインします。

   gcloud auth login
   

3. 以下のコマンドを使用してアプリケーション資格情報を設定します。

   gcloud auth application-default login
   

4. 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サーバーに自分のIDを使用して安全に接続します。

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

   これにより、ポート3000にローカルプロキシが作成され、リモートMCPサーバーにリクエストを転送し、自分のIDを注入します。

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