BigQuery MCP server

BigQuery MCP サーバー

BigQuery にアクセスする Model Context Protocol サーバーです。このサーバーを使用すると、LLM がデータベースのスキーマを調べ、クエリを実行できます。

コンポーネント

ツール

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

• execute-query：BigQuery の方言を使用して SQL クエリを実行します
• list-tables：BigQuery データベース内のすべてのテーブルを一覧表示します
• describe-table：指定したテーブルのスキーマを説明します

設定

サーバーは、コマンドライン引数または環境変数で設定できます。

引数	環境変数	必須	説明
--project	BIGQUERY_PROJECT	はい	GCP プロジェクト ID です。
--location	BIGQUERY_LOCATION	はい	GCP のロケーションです（例：europe-west9）。
--dataset	BIGQUERY_DATASETS	いいえ	特定の BigQuery データセットのみを対象にします。引数を複数回指定する（例：--dataset my_dataset_1 --dataset my_dataset_2）か、環境変数でカンマ区切りにして指定できます（例：BIGQUERY_DATASETS=my_dataset_1,my_dataset_2）。指定しない場合、プロジェクト内のすべてのデータセットが対象になります。
--key-file	BIGQUERY_KEY_FILE	いいえ	BigQuery 用のサービスアカウントキーファイルへのパスです。指定しない場合、サーバーはデフォルトの認証情報を使用します。
--timeout	BIGQUERY_TIMEOUT	いいえ	クエリの完了を待つ最大時間（秒）です。指定しない場合、クエリは無期限に待機します。

インストール

Smithery 経由でインストール

Smithery 経由で Claude Desktop 用の BigQuery Server を自動的にインストールするには：

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

Claude Code

claude mcp add bigquery --scope user --transport stdio -- uvx mcp-server-bigquery --project {PROJECT_ID} --location {{LOCATION}}

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bigquery": {
      "command": "uvx",
      "args": ["mcp-server-bigquery"],
      "env": {
        "BIGQUERY_PROJECT": "{{GCP_PROJECT_ID}}",
        "BIGQUERY_LOCATION": "{{GCP_LOCATION}}"
      }
    }
  }
}

Cursor

1. Cursor の設定 → MCP を開きます
2. Add new global MCP server をクリックします
3. 以下のパターンに従って、BigQuery MCP のエントリを追加します。

{
  "mcpServers": {
    "bigquery": {
      "command": "uvx",
      "args": ["mcp-server-bigquery"],
      "env": {
        "BIGQUERY_PROJECT": "{{GCP_PROJECT_ID}}",
        "BIGQUERY_LOCATION": "{{GCP_LOCATION}}"
      }
    }
  }
}