GCP MCP

ClaudeのようなAIアシスタントがGoogle Cloud Platform環境と対話できるようにするModel Context Protocol（MCP）サーバー。これにより、会話中に自然言語によるクエリやGCPリソースの管理が可能になります。

特徴

• 🔍 自然言語を使用して GCP リソースをクエリおよび変更する

• ☁️ 複数の GCP プロジェクトのサポート

• 🌐 マルチリージョンサポート

• 🔐 安全な資格情報の取り扱い（資格情報は外部サービスに公開されません）

• 🏃‍♂️ GCP 認証情報を使用したローカル実行

• 🔄 信頼性向上のための自動再試行

Related MCP server: MCP Gemini Server

前提条件

• Node.js

• クロード デスクトップ/カーソル/ウィンドサーフィン

• ローカルに構成された GCP 認証情報 (アプリケーションのデフォルト認証情報)

インストール

1. リポジトリをクローンします。

2. 依存関係をインストールします:

構成

クロードデスクトップ

1. Claudeデスクトップアプリを開き、「設定」->「開発者」->「設定の編集」に移動します。

2. claude_desktop_config.jsonに次のエントリを追加します。

npm経由:

ソースからインストールした場合:

ソース インストールを使用する場合は/path/to/gcp-mcpプロジェクト ディレクトリへの実際のパスに置き換えます。

カーソル

1. カーソルを開いて設定に移動します（⌘,）

2. AI -> モデルコンテキストプロトコルに移動します

3. 新しい MCP 構成を追加します。

ウィンドサーフィン

1. ~/.windsurf/config.jsonを開きます（存在しない場合は作成します）

2. MCP 構成を追加します。

GCPのセットアップ

1. GCP 認証情報を設定します。

   • gcloud auth application-default loginを使用してアプリケーションのデフォルト認証情報を設定する

2. AIアシスタント（Claude Desktop/Cursor/Windsurf）をリフレッシュ

使用法

プロジェクトを選択するか、次のような質問をすることから始めます。

• 「アクセスできるすべての GCP プロジェクトを一覧表示する」

• 「プロジェクト X のすべての Cloud SQL インスタンスを表示」

• 「現在の請求状況はどうなっていますか？」

• 「Cloud Run サービスのログを表示してください」

• 「us-central1 内のすべての GKE クラスタを一覧表示する」

• 「プロジェクト X のすべての Cloud Storage バケットを表示」

• 「us-central1 にはどのような Cloud Functions がデプロイされていますか?」

• 「すべての Cloud Run サービスを一覧表示する」

• 「BigQuery のデータセットとテーブルを表示」

利用可能なツール

1. run-gcp-code : TypeScript コードを使用して GCP API 呼び出しを実行する

2. list-projects : アクセス可能なすべての GCP プロジェクトを一覧表示する

3. select-project : 後続の操作のために GCP プロジェクトを選択します

4. get-billing-info : 現在のプロジェクトの請求情報を取得する

5. get-cost-forecast : 現在のプロジェクトのコスト予測を取得する

6. get-billing-budget : 現在のプロジェクトの請求予算を取得する

7. list-gke-clusters : 現在のプロジェクト内のすべての GKE クラスタを一覧表示する

8. list-sql-instances : 現在のプロジェクト内のすべての Cloud SQL インスタンスを一覧表示します

9. get-logs : 現在のプロジェクトの Cloud Logging エントリを取得する

やり取りの例

1. 利用可能なプロジェクトの一覧:

2. プロジェクトを選択してください:

3. 請求ステータスを確認する:

4. ログを表示:

サポートされているサービス

• Google コンピューティング エンジン

• クラウドストレージ

• クラウド関数

• クラウドラン

• ビッグクエリ

• クラウドSQL

• Google Kubernetes Engine (GKE)

• クラウドロギング

• クラウド課金

• リソースマネージャー

• すぐにさらに追加されます...

トラブルシューティング

ログを表示するには:

よくある問題:

1. 認証エラー: gcloud auth application-default loginを実行したことを確認してください

2. 権限エラー: アカウントのIAMロールを確認してください

3. APIエラー: プロジェクトで必要なAPIが有効になっていることを確認してください

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

マサチューセッツ工科大学