gemini-cloud-assist-mcp

Gemini Cloud Assist MCP サーバー

重要

プライベートプレビューに関するお知らせ Gemini Cloud Assist MCP サーバーの API は現在プライベートプレビュー段階で、アクセスが許可リストによって制限されています。アクセスをリクエストするには、Google Cloud アカウントチームにお問い合わせください。

警告

非推奨化とリモート MCP サーバーへの移行に関するお知らせ

Gemini Cloud Assist MCP サーバーは、ローカル Node.js アーキテクチャからリモート MCP サーバーアーキテクチャに移行しました。旧式のローカル Node.js サーバーは、今後数か月以内にサポートが終了します。

新しいリモート MCP サーバーを使用するには、v0.8.0 以降をご利用ください。移行期間中に従来のローカルサーバーを引き続き使用する場合は、設定で旧バージョンを固定してください。

このサーバーは、Model Context Protocol（MCP）クライアントをGemini Cloud Assist APIに接続します。自然言語を使って、ローカルのコマンドラインから Google Cloud 環境を直接理解、管理、トラブルシューティングできます。

このリポジトリの設定では、Cloud Operator エンドポイント https://geminicloudassist.googleapis.com/mcp/autocloud に接続します。このエンドポイントでは、Cloud Operator ツール（ask_cloud_operator、search_operator_sessions、fetch_operator_session）を利用できます。リファレンスドキュメントに記載されているその他の Gemini Cloud Assist ツールは、https://geminicloudassist.googleapis.com/mcp 上で提供されており、これらの設定からはアクセスできません。

メモ

Google Cloud Platform 利用規約（https://cloud.google.com/terms/ で提供）およびデータ処理およびセキュリティに関する規約（https://cloud.google.com/terms/data-processing-terms で提供）は、Gemini Cloud Assist MCP Server ソフトウェアのいずれのコンポーネントにも適用されません。

Gemini Cloud Assist の詳細については、Google Cloud ドキュメントのGemini Cloud Assist の概要をご覧ください。

✨ 主な機能

Cloud Operator は、プロジェクトのライブコンテキストを扱うオペレーターエージェントです。ask_cloud_operator を通じて、次のタスクを実行します。

• 問題のトラブルシューティング： Google Cloud 環境におけるインシデントと根本原因を調査します。
• ロールアウトのレビュー： ロールアウトの準備状況と監視状況をレビューします。
• インフラストラクチャの設計とレビュー： Terraform のベストプラクティスに基づくレビューと生成、Kubernetes および Helm のマニフェスト作成を行い、レビュー可能なファイル編集として結果を適用します。
• コストの最適化： 支出を分析し、効率化の機会を特定します。
• 一般的なサポートの利用： ドキュメントに基づいた操作方法の回答や、Google Cloud のベストプラクティス、アーキテクチャ、運用に関するガイダンスを提供します。

クイックスタート

開始する前に、次の項目が設定されていることを確認してください。

• Google Cloud SDK がインストールされ、設定されていること。
• Google Cloud プロジェクトがあること。
• ユーザーアカウントに次の IAM ロールが付与されていること。
  • roles/serviceusage.serviceUsageAdmin：Cloud Assist API を有効にするために必要です。
  • roles/geminicloudassist.user：Cloud Assist API にリクエストを送信するために必要です。

ステップ 1：Google Cloud に認証する

Gemini Cloud Assist MCP サーバーは、ローカルの Application Default Credentials（ADC）を使用して Google Cloud に安全に認証します。ADC を設定するには、次の gcloud コマンドを実行します。

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

MCP クライアントを設定する

クライアントエージェントの設定は、使用するエージェントによって異なります。

Cloud Operator プラグイン：Claude Code、ChatGPT Codex、Google Antigravity

重要

プライベートプレビュー。 Cloud Operator とその MCP サーバーはプライベートプレビュー中です。

Cloud Operator プラグイン（plugins/cloud-operator 内にあります）は、cloud-operator としてインストールされるため、コマンドは /cloud-operator:… です。Claude Code、ChatGPT Codex、または Google Antigravity を Cloud Operator（ask_cloud_operator）に接続します。このプラグインは次のことを行います。

• Cloud Operator への MCP 接続を設定し、ツールのタイムアウトを 30 分に設定します。
• 使用するオペレーターエージェントを尋ね、応答があることを確認します。
• Google Cloud の設定を保存し、Cloud Operator に渡します。
• Cloud Operator をいつ、どのように使用するかをエージェントが判断できるよう支援するスキルを追加します。

インストール方法については、plugins/cloud-operator をご覧ください。 これらのエージェントでは、このプラグインがリポジトリのルートにある gemini-cloud-assist-mcp プラグインを置き換えるため、両方をインストールしないでください。

Antigravity

次の内容を mcp_config.json に追加してください。

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp/autocloud",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

1. Google Cloud プロジェクトで、デスクトップアプリ用の OAuth 2.0 クライアント ID を作成します。
2. リダイレクト URL として URI://anysphere.cursor-mcp/oauth/callback を設定します。
3. 次の設定ブロックを追加するか、既存の設定に統合します。

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp/autocloud",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

使用するアプリケーションに応じた設定手順に従ってください。

• Claude.ai
• Claude Code：Cloud Operator プラグインをご覧ください。

MCP ツール

Cloud Operator MCP ツール

Cloud Operator は、一連の MCP ツールから利用できるエージェントです。MCP ツールの呼び出しによって起動されたエージェントは、Google Cloud に対して内部で独自にツールを呼び出します。/mcp/autocloud エンドポイントでは、次のツールを提供します。これらはプライベートプレビュー中で、許可リストに登録されたプロジェクトに制限されています。

ツール	説明
ask_cloud_operator	インシデントや根本原因の調査、ロールアウトのレビュー、コストの最適化、Terraform のベストプラクティスのレビューと生成、ドキュメントに基づく手順の回答など、複数の手順を伴う運用作業を Cloud Operator エージェントに委任します。後続の呼び出しでセッションを継続するための contextId を返します。
search_operator_sessions	プロジェクト内の Cloud Operator セッションを一覧表示します。各セッションの contextId は、そのセッションを担当したオペレーターエージェントを示します。
fetch_operator_session	contextId を指定して Cloud Operator セッションを取得します。セッション内のターンも含まれます。

その他の Gemini Cloud Assist ツール（ask_cloud_assist、design_infra、investigate_issue、invoke_operation、optimize_costs）は https://geminicloudassist.googleapis.com/mcp で提供され、Gemini Cloud Assist MCP リファレンスに記載されています。このリポジトリ内の設定では利用できません。

注： これらのツールは、安定した API として扱わないでください。Gemini Cloud Assist の機能の進化に対応するため、パラメーターの名前が変更されたり、修正されたりする場合があります。

エージェントスキル

Gemini Cloud Assist MCP ツールでは、SKILL.md ファイルを使って、ツールを適切に使用する方法をエージェントに指示します。スキルは、Cloud Operator に処理を委任するタイミングや、関連するローカル情報を渡す方法をエージェントが判断できるよう支援し、明示的な呼び出しも可能にします。

スキル	説明
autocloud-operator	インシデント調査、ロールアウトのレビュー、コストの最適化、Terraform のレビューと生成、手順に関する質問など、Google Cloud の運用作業を Cloud Operator エージェント（ask_cloud_operator）に委任します。Terraform の結果はレビュー可能なファイル編集として適用されます。プライベートプレビューへのアクセスが必要です。

コントリビューション

• バグが発生した場合は、GitHub Issues ページで問題を報告してください。
• プルリクエストを送信する前に、コントリビューションガイドをご確認ください。

ライセンス

このプロジェクトは Apache 2.0 License の下でライセンスされており、いかなる用途や目的についても、保証や表明を伴わず現状のまま提供されます。詳細については、LICENSE ファイルをご覧ください。