Bigquery

🚀 BigQuery MCP サーバー

BigQuery へのアクセスを提供するモデルコンテキストプロトコル（Model Context Protocol, MCP）サーバーです。このサーバーにより、大規模言語モデル（LLMs）がデータベーススキーマをinspectし、クエリを実行できるようになります。

✨ 主な機能

ツール

このサーバーは以下のツールを実装しています。

• execute-query：BigQuery 方言を使用して SQL クエリを実行します。
• list-tables：BigQuery データベース内のすべてのテーブルをリストします。
• describe-table：特定のテーブルのスキーマ情報を記述します。

📦 インストール

設定

サーバーは以下のパラメータで設定できます。

• --project（必須）：GCP プロジェクト ID です。
• --location（必須）：GCP の地理位置（例：europe-west9）です。
• --dataset（オプション）：特定の BigQuery データセットのみを考慮します。パラメータを繰り返すことで複数のデータセットを指定できます（例：--dataset my_dataset_1 --dataset my_dataset_2）。指定されない場合、プロジェクト内のすべてのデータセットが考慮されます。
• --key-file（オプション）：BigQuery サービスアカウントのキーファイルのパスです。指定されない場合、デフォルトの認証情報が使用されます。

🚀 クイックスタート

インストール

Smithery を使用したインストール

Smithery を通じて BigQuery サーバーを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install mcp-server-bigquery --client claude

Claude Desktop

• MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

開発/未公開のサーバー設定

"mcpServers": {
  "bigquery": {
    "command": "uv",
    "args": [
      "--directory",
      "{{PATH_TO_REPO}}",
      "run",
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{GCP_LOCATION}}"
    ]
  }
}

公開済みのサーバー設定

"mcpServers": {
  "bigquery": {
    "command": "uvx",
    "args": [
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{GCP_LOCATION}}"
    ]
  }
}

{{PATH_TO_REPO}}、{{GCP_PROJECT_ID}}、{{GCP_LOCATION}} を適切な値に置き換えてください。

🔧 開発

ビルドと公開

配布パッケージを準備するには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. リリース版をビルドします。

uv build

これにより、dist/ ディレクトリにソースコードと wheel リリース版が作成されます。 3. PyPI に公開します。

uv publish

注：PyPI の認証情報は環境変数またはコマンドパラメータで設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード：--username/UV_PUBLISH_USERNAME と --password/UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは標準入出力で動作するため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

以下のコマンドで MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory {{PATH_TO_REPO}} run mcp-server-bigquery

起動後、Inspector は URL を表示します。この URL をブラウザで開いてデバッグを開始できます。