Gemini Cloud Assist

Gemini Cloud Assist MCP サーバー

[!IMPORTANT] プライベートプレビューに関するお知らせ Gemini Cloud Assist MCP サーバー API は現在プライベートプレビュー中であり、許可リストの背後にあります。アクセスをリクエストするには、Google Cloud アカウントチームにお問い合わせください。

[!WARNING] 非推奨のお知らせとリモート MCP サーバーへの移行

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

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

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

[!NOTE] Google Cloud Platform 利用規約（https://cloud.google.com/terms/ で入手可能）およびデータ処理とセキュリティに関する条項（https://cloud.google.com/terms/data-processing-terms で入手可能）は、Gemini Cloud Assist MCP サーバーソフトウェアのいかなるコンポーネントにも適用されません。

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

✨ 主な機能

• インフラストラクチャの設計: Google Cloud 向けのインフラストラクチャ構成を作成および設計します。
• 問題のトラブルシューティング: 詳細な調査を実行して、Google Cloud 環境の複雑な問題の根本原因を特定します。
• リソースの管理: チャットワークフローから直接 Google Cloud リソースを作成、更新、削除します（エージェントアクションが必要です）。
• コストの最適化: 支出を分析し、コストを追跡し、アイドル状態のリソースなどの効率化の機会を特定します。
• 一般的な支援の取得: 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 サーバーは、ローカルのアプリケーションデフォルト認証情報（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 クライアントの構成

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

Antigravity

mcp_config.json に以下を追加します:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "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",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

特定のアプリケーションの構成手順に従ってください:

• Claude.ai

MCP ツール

Gemini Cloud Assist MCP ツール

Gemini Cloud Assist は、一連の MCP ツールを通じてアクセスできるエージェントです。MCP ツールの呼び出しによって呼び出されたエージェントは、Google Cloud に対して内部的に独自のツール呼び出しを行います。エージェントが利用できるように、次の MCP ツール が公開されています:

ツール	説明
ask_cloud_assist	Google Cloud 支援および Gemini Cloud Assist エージェントの主要なインターフェースです。すべての機能はこのツールからアクセスできます。
design_infra	Google Cloud でのインフラストラクチャの設計とアーキテクチャのワークフローをサポートします。
investigate_issue	Google Cloud でのトラブルシューティングのワークフローをサポートします。調査リソースを通じて、迅速なトラブルシューティングまたはより詳細なトラブルシューティングを実行できます。
invoke_operation	Google Cloud でのリソースの作成、更新、削除のワークフローをサポートします。エージェントアクションが有効な場合にのみ機能します。
optimize_costs	Google Cloud コストの分析、追跡、最適化のワークフローをサポートします。支出の内訳を提供し、コスト効率の機会を特定します。

Application Design Center MCP ツール

Application Design Center MCP ツールは、多くの場合 GCA の design_infra ツールによってオーケストレーションされ、Application Design Center を使用してインフラストラクチャアプリケーションのライフサイクルを管理します。テンプレート管理、セキュリティコンプライアンスと修復、デプロイなどが含まれます。

ツール	説明
setup_adc	Application Design Center 環境を初期化します。これは、他の ADC ツールを使用する前に実行する必要がある 1 回限りのセットアップ手順です。
manage_application	アプリケーションのデプロイライフサイクルを管理します。このツールを使用して、Application Design Center を使用して検証済みの設計をデプロイするか、既存のデプロイのステータスと詳細を取得します。これは、設計を Google Cloud 上のデプロイされたインフラストラクチャに変える最終ステップです。
manage_application_template	インフラストラクチャ設計の Infrastructure as Code (IaC) コンテンツを管理します。これを使用して、設計を Application Design Center テンプレートとして保存したり、設計を Terraform ファイルとしてエクスポートしたり、設計を更新したりします（例: コンポーネント、パラメータ構成など）。
assess_best_practices	デプロイ前にアプリケーション設計に対して包括的なセキュリティおよび構成監査を実行します。Security Command Center フレームワークと関連するコントロールに対して設計を検証し、修復のための実用的な調査結果を含むレポートを返します。
list_application_templates	利用可能なすべてのアプリケーション設計を一覧表示します。

注: これらのツールは安定した API として扱われるべきではありません。Gemini Cloud Assist の進化する機能に対応するために、パラメータが名前変更または変更される可能性があります。

エージェントスキル

Gemini Cloud Assist MCP ツールは、SKILL.md ファイルを活用して、ツールを適切に使用する方法をエージェントに指示します。スキルは、複数のツールをワークストリームに連鎖させ、関連するローカル情報を Gemini Cloud Assist に渡し、明示的な呼び出しを有効にする方法をエージェントにガイドするのに役立ちます。

スキル	説明
designing-and-deploying-infrastructure	Application Design Center (ADC) と Gemini Cloud Assist ツールを使用して、クラウドインフラストラクチャを設計、評価、デプロイ、トラブルシューティングする方法をエージェントにガイドします。
operating-google-cloud	専門の MCP ツールを使用して Google Cloud Platform (GCP) リソースと Kubernetes を管理するための手順を提供します。

貢献

• バグが発生した場合は、GitHub Issues ページに問題を報告してください。
• プルリクエストを送信する前に、Contributing Guide を確認してください。

ライセンス

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