Gemini Cloud Assist MCP Server

公式

Gemini Cloud Assist APIに接続するMCPサーバーで、自然言語を使用してGoogle Cloud環境の管理とトラブルシューティングを可能にします。

ドキュメント

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 以降を使用してください。移行期間中に従来のローカルサーバーを引き続き使用する場合は、設定を古いバージョンに固定してください。

このサーバーは、Gemini CLI などの Model Context Protocol (MCP) クライアントを Gemini Cloud Assist API に接続します。これにより、ローカルのコマンドラインから直接、自然言語を使用して 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 クライアントの構成

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

Gemini CLI

MCP サーバーを Gemini CLI 拡張機能としてインストールします。

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

または、~/.gemini/settings.json に手動で構成を追加することもできます。

"mcpServers": {
  "gemini_cloud_assist": {
    "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  },
  "application_design_center": {
    "httpUrl": "https://designcenter.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  }
}

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

Google Cloud プロジェクトで、デスクトップアプリ用の OAuth 2.0 クライアント ID を作成します。
リダイレクト URL として URI://anysphere.cursor-mcp/oauth/callback を構成します。
次の構成ブロックを追加またはマージします。

{
  "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 ページで問題を報告してください。
プルリクエストを送信する前に、貢献ガイドをご確認ください。

ライセンス

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