Google Cloud MCP

🚀 Google Cloud MCP サーバー

モデルコンテキストプロトコル（Model Context Protocol）サーバーです。Google Cloud サービスに接続し、コンテキストとツールを提供して、Google Cloud リソースとのインタラクションを可能にします。

🚀 クイックスタート

このサーバーは、Google Cloud の様々なサービスと連携し、リソースとのインタラクションをサポートします。以下では、サポートされているサービスや、認証方法、インストール手順などについて説明します。

✨ 主な機能

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

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

• [x] Google Cloud Logging
• [x] Google Cloud Monitoring
• [x] Google Cloud Spanner

開発中のサービス

• [ ] Google Cloud Trace
• [ ] Google IAM
• [ ] Google Cloud Compute
• [ ] Google Cloud Run
• [ ] Google Cloud Storage

Google Cloud Logging

Google Cloud Logging からのログエントリをクエリおよびフィルタリングできます。

• カスタムフィルタを使用してログをクエリ
• 特定の時間範囲内でログを検索
• 読みやすい形式でログエントリを表示

Google Cloud Spanner

Google Cloud Spanner データベースとのインタラクションが可能です。

• Spanner データベースに対して SQL クエリを実行
• 利用可能なデータベースとテーブルをリスト
• データベーススキーマを探索

Google Cloud Monitoring

Google Cloud Monitoring からのメトリックデータを取得し、分析できます。

• カスタムフィルタを使用してメトリックをクエリ
• 時間の経過に伴うメトリックデータを可視化
• 利用可能なメトリックタイプをリスト

Google Cloud Trace

Google Cloud Trace からの分散トレースを分析できます。

• ID でトレースを取得
• フィルタオプション付きで最近のトレースをリスト
• ログと関連付けられたトレースを検索
• 失敗したトレースを特定
• 自然言語でトレースをクエリ（例：「過去 1 時間以内の失敗したトレースを表示」）

認証

このサーバーは、Google Cloud との認証に 2 つの方法をサポートしています。

1. サービスアカウントキーファイル（推奨）：GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービスアカウントキーファイルのパスに設定します。これは Google Cloud の標準的な認証方法です。
2. 環境変数：GOOGLE_CLIENT_EMAIL と GOOGLE_PRIVATE_KEY 環境変数を直接設定します。これは、キーファイルを保存できない環境で役立ちます。

サーバーは、GOOGLE_CLOUD_PROJECT 環境変数が設定されている場合にはそれを使用し、設定されていない場合は認証資格情報からプロジェクト ID を決定しようとします。

📦 インストール

# リポジトリをクローン
git clone https://github.com/krzko/google-cloud-mcp.git
cd google-cloud-mcp

# 依存関係をインストール
pnpm install

# ビルド
pnpm build

Google Cloud との認証：

gcloud auth application-default login

クライアントで mcpServers を設定：

{
  "mcpServers": {
      "google-cloud-mcp": {
          "command": "node",
          "args": [
              "/Users/foo/code/google-cloud-mcp/dist/index.js"
          ],
          "env": {
              "GOOGLE_APPLICATION_CREDENTIALS": "/Users/foo/.config/gcloud/application_default_credentials.json"
          }
      }
  }
}

💻 使用例

サーバーの起動

# プロジェクトをビルド
pnpm build

# サーバーを起動
pnpm start

開発モード

# プロジェクトをビルド
pnpm build

# サーバーとチェックツールを起動
npx -y @modelcontextprotocol/inspector node dist/index.js

Smithery との使用（近日公開）

このサーバーは、Smithery とともにデプロイして使用することができます。サーバーは認証の遅延読み込みを実装しており、すぐに起動し、実際に必要になるまで認証を延期します。認証は依然として必要ですが、遅延読み込みにより、サーバーは初期化中にタイムアウトすることがなくなります。

⚠️ 重要提示

Smithery のローカルサーバーサポートはまだ開発中であり、利用できない場合があります。

トラブルシューティング

サーバーのタイムアウト問題

Smithery でサーバーを実行する際にタイムアウト問題が発生した場合は、以下の手順を試してください。

1. デバッグログを有効にし、設定で debug: true を設定します。
2. lazyAuth: true を設定して、実際に必要になるまで認証を延期します。
3. 資格情報ファイルがアクセス可能で、形式が正しいことを確認します。
4. ログ内のエラーメッセージを確認します。

⚠️ 重要提示

認証は依然として操作に必要ですが、遅延読み込みを有効にすると、サーバーはすぐに起動し、必要になったときに認証を行います。初期化中には行われません。

認証問題

このサーバーは、2 つの認証方法をサポートしています。

1. サービスアカウントキーファイル：GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービスアカウントキーファイルのパスに設定します。
2. 環境変数：GOOGLE_CLIENT_EMAIL と GOOGLE_PRIVATE_KEY 環境変数を正しく設定します。

認証問題が発生した場合は、以下のことを確認してください。

• サービスアカウントに必要な権限があること。
• キーファイルの形式が正しく、アクセス可能であること。
• 環境変数が正しく設定されていること。