作者 ergut · ergut/mcp-bigquery-server
透過 Claude 以自然語言唯讀查詢 BigQuery — 支援結構描述探索、查詢用量限制、PII 欄位限制 — 使用服務帳號驗證。
mcp-bigquery-server 是一個 Node MCP 套件，讓 LLM 以安全的唯讀方式存取 BigQuery 資料集。可設定查詢掃描位元組上限（預設 1GB），支援 PII/PHI 欄位層級限制，可透過 Smithery 安裝或手動設定服務帳號憑證。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"bigquery-server": {
"command": "npx",
"args": [
"-y",
"mcp-bigquery-server"
],
"_inferred": true
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"bigquery-server": {
"command": "npx",
"args": [
"-y",
"mcp-bigquery-server"
],
"_inferred": true
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"bigquery-server": {
"command": "npx",
"args": [
"-y",
"mcp-bigquery-server"
],
"_inferred": true
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"bigquery-server": {
"command": "npx",
"args": [
"-y",
"mcp-bigquery-server"
],
"_inferred": true
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "bigquery-server",
"command": "npx",
"args": [
"-y",
"mcp-bigquery-server"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"bigquery-server": {
"command": {
"path": "npx",
"args": [
"-y",
"mcp-bigquery-server"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add bigquery-server -- npx -y mcp-bigquery-server一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 當你有個問題，答案就存在 BQ 的事件資料表中。
analytics 中的所有資料表，並描述 events 與 users 的結構。✓ 已複製結果： 幾分鐘內得到答案，不需再開資料團隊的需求單。
何時使用： 你希望透過聊天介面開放更多人使用 BQ，但不想讓每個人都能讀取客戶的電子郵件。
users.email、users.phone、users.ssn。代理程式只能對這些欄位進行彙總，不能直接 SELECT 原始值。✓ 已複製結果： 為 LLM 時代提供更安全的自助式資料分析。
何時使用： 你希望每天早上在 Slack 收到 KPI，但不想建置 BI 工具。
結果： 無需付費 BI 工具，即可每日取得指標。
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| list_datasets | 第一步，用於了解整體結構 | free | |
| list_tables | dataset | 瀏覽特定資料集 | free |
| describe_table | dataset, table | 查詢前先了解資料表結構 | free |
| query | sql: str, max_bytes?: int | 主要讀取工具；預設限制掃描量為 1GB | BQ on-demand: $6.25 per TB scanned |
bigquery.dataViewer + bigquery.jobUser on specific datasets onlydataOwner / dataEditor to the MCP's service accountPERMISSION_DENIED on dataset服務帳號缺少 BQ Data Viewer 權限。請執行 gcloud projects add-iam-policy-binding ...。
gcloud bigquery datasets listQuery exceeds configured byte limit加上分區過濾條件或縮減查詢欄位；若確有需要，也可提高上限。
Restricted field still appearing in results正規表達式比對可能遺漏含別名的欄位 — 請使用 BQ 授權檢視表以達到強制隔離效果。
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| Looker / Metabase | 你需要的是 BI 工具，而非對話式查詢 | 儀表板功能更完善；但互動性較低 |
| postgres MCP via Cloud SQL | 你的分析資料存放在 Postgres 而非 BQ | 引擎不同；Postgres 在大規模彙總查詢上的擴展性不如 BQ |