Bigquery

🚀 BigQuery MCP 服務器

一個提供對 BigQuery 訪問的模型上下文協議（Model Context Protocol，MCP）服務器。此服務器讓大型語言模型（LLMs）能夠檢查數據庫架構並執行查詢，為數據交互提供了便捷途徑。

🚀 快速開始

安裝

使用 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}} 替換為適當的值。

✨ 主要特性

該服務器實現了以下工具，為用戶提供了便捷的數據庫操作方式：

• 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 安裝 BigQuery 服務器
npx -y @smithery/cli install mcp-server-bigquery --client claude

高級用法

# 開發/未發佈的服務器配置示例
"mcpServers": {
  "bigquery": {
    "command": "uv",
    "args": [
      "--directory",
      "{{PATH_TO_REPO}}",
      "run",
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{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 開始調試。