Bigquery Analysis MCP Server

🚀 BigQuery 分析 MCP サーバ

このプロジェクトは、Google BigQuery 上で SQL クエリを実行するための MCP サーバです。以下の機能を提供します。

• クエリ検証（事前実行）：クエリが有効かどうかを検証し、処理規模を見積もります。
• 安全なクエリ実行：1TB 未満の SELECT クエリのみを実行できるように制限し、データの変更を防止します。
• JSON 形式の結果：クエリ結果を構造化された JSON 形式で返します。

✨ 主な機能

ツール

• dry_run_query - BigQuery クエリの事前実行操作を行います。

  • クエリを検証し、処理規模を見積もります。
  • クエリサイズが 1TB の制限に適合するかを確認します。

• run_query_with_validation - 検証付きで BigQuery クエリを実行します。

  • DML ステートメント（データ変更クエリ）を検出し、拒否します。
  • 1TB を超えるデータ処理のクエリを拒否します。
  • 検証を通過したクエリを実行し、結果を返します。

📦 インストール

Claude Desktop で使用するには、サーバ設定を追加してください。

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bigquery": {
      "command": "node",
      "args": ["/path/to/bigquery-server/build/index.js"]
    }
  }
}

デバッグ

MCP サーバは標準入出力（stdio）で通信するため、デバッグが難しい場合があります。MCP Inspector の使用をおすすめします。

npm run inspector

Inspector は、ブラウザでデバッグツールにアクセスするための URL を提供します。

🔧 開発

前提条件

• Node.js (v16 以上)
• Google Cloud の認証設定（gcloud CLI またはサービスアカウント）

依存関係のインストール

npm install

ビルド

npm run build

開発モード（自動再構築）

npm run watch

📄 認証設定

このサーバは Google Cloud の認証が必要です。以下の方法のいずれかで設定してください。

1. gcloud CLI を使用してログインする場合：

gcloud auth application-default login

2. サービスアカウントキーを使用する場合：

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"

💻 使用例

基本的な使用法

dry_run_query("SELECT * FROM `bigquery-public-data.samples.shakespeare` LIMIT 10")

高度な使用法

run_query_with_validation("SELECT word, word_count FROM `bigquery-public-data.samples.shakespeare` WHERE corpus='hamlet' LIMIT 10")