Lucashild MCP Server Bigquery

🚀 BigQuery MCP 服務器

BigQuery MCP 服務器是一個基於 Model Context Protocol 的服務器，它為用戶提供了對 BigQuery 的便捷訪問途徑。藉助該服務器，大語言模型（LLM）能夠輕鬆檢查數據庫架構並執行查詢操作。

✨ 主要特性

工具

該服務器實現了以下實用工具：

• execute-query：可使用 BigQuery 方言執行 SQL 查詢。
• list-tables：用於列出 BigQuery 數據庫中的所有表。
• describe-table：能夠描述特定表的架構。

📦 安裝指南

安裝

Claude Desktop

• 在 MacOS 上：配置文件路徑為 ~/Library/Application\ 支持/Claude/claude_desktop_config.json。
• 在 Windows 上：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json%。

請將 {{PATH_TO_REPO}}、{{GCP_PROJECT_ID}} 和 {{GCP_LOCATION}} 替換為適當的值。

🚀 快速開始

配置

該服務器可以通過以下參數進行配置：

• --project（必需）：GCP 項目 ID。
• --location（必需）：GCP 地理位置（例如 europe-west9）。
• --dataset（可選）：僅考慮特定的 BigQuery 數據集。可以通過重複參數指定多個數據集（例如 --dataset my_dataset_1 --dataset my_dataset_2）。如果未提供，默認將考慮項目中的所有表。

🔧 技術細節

開發

構建和發佈

要準備分發包，可按以下步驟操作：

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建包分佈：

uv build

這將在 dist/ 目錄中創建源和輪分佈。 3. 發佈到 PyPI：

uv publish

注意：你需要通過環境變量或命令標誌設置 PyPI 憑據：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

調試

由於 MCP 服務器通過 stdio 運行，調試可能會很困難。為了獲得最佳的調試體驗，我們強烈推薦使用 MCP Inspector。

你可以通過 npm 執行以下命令啟動 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory {{PATH_TO_REPO}} run mcp-server-bigquery

啟動後，Inspector 會顯示一個 URL，你可以在瀏覽器中訪問該 URL 開始調試。