Bigquery MCP

🚀 大查詢 MCP 服務器

大查詢 MCP 服務器是專為大查詢（BigQuery）設計的模型上下文協議（MCP）服務器，它能為 AI 代理提供工具，幫助其處理數據相關任務，解決因對數據庫內容缺乏瞭解而導致的問題。

🚀 快速開始

先決條件

本項目和 mcp CLI 工具依賴於您已經安裝了依賴管理工具 uv。例如，使用 Homebrew 的用戶可以運行 brew install uv 進行安裝。更多安裝方法請參考這裡。

目前該項目假設您能夠“透明地”創建一個 BigQuery Client，這通常是 gcloud 已安裝在本地環境中的情況。在其他環境中，可能需要合適的服務賬戶憑據（並設置 GOOGLE_APPLICATION_CREDENTIALS 環境變量以指示這些憑據的位置到 BigQuery 客戶端庫）。

開發環境

您還需要安裝 Taskfile。對於 Homebrew 用戶，可以運行 brew install go-task 進行安裝。更多安裝方法請參考這裡。

光速開始（適用於 Cursor IDE）

1. 確保先決條件已安裝。
2. 克隆此倉庫。
3. 運行 uv sync 安裝依賴項。
4. 在 Cursor 設置 > MCP 服務器，啟動一個服務器，使用以下命令：

uv run --with mcp --directory /path/to/bigquery-mcp mcp run /path/to/bigquery-mcp/src/server.py

💡 使用建議：建議在項目中寫一個上下文規則到 .cursor/rules/tool-use-rule.mdc 文件。Cursor 代理需要一些指令才能正確使用工具。

📚 詳細文檔

AI 代理已經開始擅長編寫代碼，但在處理數據相關任務時卻常常遇到困難。這是由於程序邏輯與實際數據庫內容之間的耦合所致。

更具體地說，AI 代理在編寫 SQL 查詢以進行分析任務方面經常表現不佳。它們能夠編寫代碼，因此問題不在於這一領域的能力不足，而更多是因為對數據庫的 內容 缺乏瞭解。

此 MCP 服務器通過提供 AI 代理可用的工具來解決這個問題，這些工具可以用於檢查 BigQuery 數據倉庫的內容（即數據集、表、列、查詢歷史）。