Bigquery Analysis MCP Server

🚀 BigQuery 分析 MCP 服務器

這是一個運行於 Google BigQuery 之上的 MCP 服務器，可執行 SQL 查詢。它具備查詢驗證、安全查詢執行等功能，還能以結構化 JSON 格式返回查詢結果，為數據查詢工作提供了便利與保障。

🚀 快速開始

本 MCP 服務器可在 Google BigQuery 上執行 SQL 查詢，具備查詢驗證、安全執行和以 JSON 格式返回結果等功能。

✨ 主要特性

工具

• dry_run_query - 執行 BigQuery 查詢的預執行操作
  • 驗證查詢並估計其處理規模
  • 檢查查詢大小是否符合 1TB 的限制
• run_query_with_validation - 帶驗證地運行 BigQuery 查詢
  • 檢測並拒絕 DML 語句（數據修改查詢）
  • 拒絕超過 1TB 數據處理的查詢
  • 執行通過驗證的查詢並返回結果

📦 安裝指南

前提條件

• Node.js (v16 或更高版本)
• Google Cloud 身份認證設置（gcloud CLI 或服務賬戶）

安裝依賴項

npm install

構建

npm run build

開發模式（自動重建）

npm run watch

在 Claude Desktop 上使用

要在 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，用於在瀏覽器中訪問調試工具。

身份認證設置

此服務器需要 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")