Google Cloud MCP サーバー

Google Cloud サービスに接続して、Google Cloud リソースを操作するためのコンテキストとツールを提供するモデル コンテキスト プロトコル サーバー。

サービス

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

• [x] Googleクラウドロギング

• [x] Google Cloud モニタリング

• [x] Google Cloud Spanner

開発中のサーバー:

• [ ] Google Cloud Trace

• [ ] Google IAM

• [ ] Googleクラウドコンピューティング

• [ ] Google Cloud Run

• [ ] Googleクラウドストレージ

Google クラウド ロギング

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

• カスタムフィルターを使用してログをクエリする

• 特定の時間範囲内のログを検索する

• ログエントリを読み取り可能な形式でフォーマットして表示する

Google Cloud Spanner

Google Cloud Spanner データベースと対話する:

• Spanner データベースに対して SQL クエリを実行する

• 利用可能なデータベースとテーブルを一覧表示する

• データベーススキーマの探索

Google Cloud モニタリング

Google Cloud Monitoring から指標を取得して分析します。

• カスタムフィルターを使用したクエリメトリクス

• メトリックデータを時間経過とともに視覚化する

• 利用可能なメトリックの種類を一覧表示する

Google Cloud Trace

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

• IDでトレースを取得する

• フィルタリングオプションを使用して最近のトレースを一覧表示する

• ログに関連付けられたトレースを検索する

• 失敗したトレースを特定する

• 自然言語を使用してトレースを照会します（例：「過去 1 時間の失敗したトレースを表示してください」）

Related MCP server: GCP MCP

認証

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

1. サービス アカウント キー ファイル（推奨）： GOOGLE_APPLICATION_CREDENTIALS環境変数にサービス アカウント キー ファイルのパスを設定します。これは Google Cloud の標準認証方法です。

2. 環境変数： GOOGLE_CLIENT_EMAILおよびGOOGLE_PRIVATE_KEY環境変数を直接設定します。これは、キーファイルの保存が現実的でない環境で便利です。

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

インストール

# Clone the repository
git clone https://github.com/krzko/google-cloud-mcp.git
cd google-cloud-mcp

# Install dependencies
pnpm install

# Build
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"
          }
      }
  }
}

発達

サーバーの起動

# Build the project
pnpm build

# Start the server
pnpm start

開発モード

# Build the project
pnpm build

# Start the server and inspector
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環境変数を設定する

認証の問題が発生した場合は、次の点を確認してください。

• サービスアカウントに必要な権限がある

• キーファイルは適切にフォーマットされ、アクセス可能である

• 環境変数が正しく設定されている