Cloud Run MCP

🚀 Google 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リソースへの不正アクセスを防ぐために重要です。

IAMを介して認証されたローカルマシンからの接続で、Cloud Run上でCloud Run MCPサーバー自体を実行します。このオプションでは、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"]
      }