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 時間の失敗したトレースを表示してください」）

認証

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

サービスアカウントキーファイル（推奨）： GOOGLE_APPLICATION_CREDENTIALS環境変数にサービスアカウントキーファイルのパスを設定します。これは Google Cloud の標準認証方法です。
環境変数： 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 を使用してサーバーを実行しているときにタイムアウトの問題が発生した場合は、次の操作を試してください。

設定でdebug: trueを設定してデバッグログを有効にする
実際に必要になるまで認証を延期するために、 lazyAuth: trueが設定されていることを確認します。
資格情報ファイルにアクセスでき、有効であることを確認してください
ログにエラーメッセージがないか確認してください

重要: 操作には依然として認証が必要ですが、遅延読み込みを有効にすると、サーバーは初期化時ではなく必要なときにすぐに起動して認証を行います。

認証の問題

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

サービスアカウントキーファイル: GOOGLE_APPLICATION_CREDENTIALS環境変数をサービスアカウントキーファイルのパスに設定します。
環境変数: GOOGLE_CLIENT_EMAILおよびGOOGLE_PRIVATE_KEY環境変数を設定する

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

サービスアカウントに必要な権限がある
キーファイルは適切にフォーマットされ、アクセス可能である
環境変数が正しく設定されている

Google Cloud MCP Server

Integrations

Google Cloud MCP サーバー

サービス

Google クラウドロギング

Google Cloud Spanner

Google Cloud モニタリング

Google Cloud Trace

認証

インストール

発達

サーバーの起動

開発モード

Smithery での使用（近日）

トラブルシューティング

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

認証の問題

Integrations

Google Cloud MCP サーバー

サービス

Google クラウド ロギング

Google Cloud Spanner

Google Cloud モニタリング

Google Cloud Trace

認証

インストール

発達

サーバーの起動

開発モード

Smithery での使用（近日）

トラブルシューティング

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

認証の問題

Google クラウドロギング