local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables querying and management of Google Cloud Platform resources including Compute Engine, Cloud Storage, Cloud Functions, Cloud Run, BigQuery, Cloud SQL, GKE, Cloud Logging, Cloud Billing and Resource Manager using natural language.
Provides tools for listing and managing Google Kubernetes Engine (GKE) clusters across different regions.

GCP MCP

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

特徴

🔍 自然言語を使用して GCP リソースをクエリおよび変更する
☁️ 複数の GCP プロジェクトのサポート
🌐 マルチリージョンサポート
🔐 安全な資格情報の取り扱い（資格情報は外部サービスに公開されません）
🏃‍♂️ GCP 認証情報を使用したローカル実行
🔄 信頼性向上のための自動再試行

前提条件

Node.js
クロードデスクトップ/カーソル/ウィンドサーフィン
ローカルに構成された GCP 認証情報 (アプリケーションのデフォルト認証情報)

インストール

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

git clone https://github.com/eniayomi/gcp-mcp
cd gcp-mcp

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

npm install

構成

クロードデスクトップ

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

npm経由:

{
  "mcpServers": {
    "gcp": {
      "command": "sh",
      "args": ["-c", "npx -y gcp-mcp"]
    }
  }
}

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

{
  "mcpServers": {
    "gcp": {
      "command": "npm",
      "args": [
        "--silent",
        "--prefix",
        "/path/to/gcp-mcp",
        "start"
      ]
    }
  }
}

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

カーソル

カーソルを開いて設定に移動します（⌘,）
AI -> モデルコンテキストプロトコルに移動します
新しい MCP 構成を追加します。

{
  "gcp": {
    "command": "npx -y gcp-mcp"
  }
}

ウィンドサーフィン

~/.windsurf/config.jsonを開きます（存在しない場合は作成します）
MCP 構成を追加します。

{
  "mcpServers": {
    "gcp": {
      "command": "npx -y gcp-mcp"
    }
  }
}

GCPのセットアップ

GCP 認証情報を設定します。
- gcloud auth application-default loginを使用してアプリケーションのデフォルト認証情報を設定する
AIアシスタント（Claude Desktop/Cursor/Windsurf）をリフレッシュ

使用法

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

「アクセスできるすべての GCP プロジェクトを一覧表示する」
「プロジェクト X のすべての Cloud SQL インスタンスを表示」
「現在の請求状況はどうなっていますか？」
「Cloud Run サービスのログを表示してください」
「us-central1 内のすべての GKE クラスタを一覧表示する」
「プロジェクト X のすべての Cloud Storage バケットを表示」
「us-central1 にはどのような Cloud Functions がデプロイされていますか?」
「すべての Cloud Run サービスを一覧表示する」
「BigQuery のデータセットとテーブルを表示」

利用可能なツール

run-gcp-code : TypeScript コードを使用して GCP API 呼び出しを実行する
list-projects : アクセス可能なすべての GCP プロジェクトを一覧表示する
select-project : 後続の操作のために GCP プロジェクトを選択します
get-billing-info : 現在のプロジェクトの請求情報を取得する
get-cost-forecast : 現在のプロジェクトのコスト予測を取得する
get-billing-budget : 現在のプロジェクトの請求予算を取得する
list-gke-clusters : 現在のプロジェクト内のすべての GKE クラスタを一覧表示する
list-sql-instances : 現在のプロジェクト内のすべての Cloud SQL インスタンスを一覧表示します
get-logs : 現在のプロジェクトの Cloud Logging エントリを取得する

やり取りの例

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

List all GCP projects I have access to

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

Use project my-project-id

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

What's my current billing status?

ログを表示:

Show me the last 10 log entries from my project

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

Google コンピューティングエンジン
クラウドストレージ
クラウド関数
クラウドラン
ビッグクエリ
クラウドSQL
Google Kubernetes Engine (GKE)
クラウドロギング
クラウド課金
リソースマネージャー
すぐにさらに追加されます...

トラブルシューティング

ログを表示するには:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log

よくある問題:

認証エラー: gcloud auth application-default loginを実行したことを確認してください
権限エラー: アカウントのIAMロールを確認してください
APIエラー: プロジェクトで必要なAPIが有効になっていることを確認してください

貢献

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

ライセンス

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Claude のような AI アシスタントが自然言語を通じて Google Cloud Platform 環境と対話できるようにするモデルコンテキストプロトコルサーバー。これにより、ユーザーは会話中に GCP リソースを照会および管理できるようになります。

Related Resources

Reddit Discussion about this server