使用 MCP Toolbox 將 IDE 連線至 BigQuery

本指南說明如何使用 MCP Toolbox for Databases，將 BigQuery 執行個體連線至各種整合開發環境 (IDE) 和開發人員工具。這項工具採用模型內容通訊協定 (MCP)，這是一項開放式通訊協定，可將大型語言模型 (LLM) 連線至 BigQuery 等資料來源，讓您直接透過現有工具執行 SQL 查詢及與專案互動。

本指南將示範下列 IDE 的連線程序：

事前準備

  1. 在 Google Cloud 控制台的專案選擇器頁面中，選取或建立 Google Cloud 專案。

  2. 確認您已為 Google Cloud 專案啟用計費功能。

  3. 在 Google Cloud 專案中啟用 BigQuery API。

  4. 設定完成這項工作所需的角色和權限。如要連線至執行個體，您需要 BigQuery 使用者角色 (roles/bigquery.user)、BigQuery 資料檢視者角色 (roles/bigquery.dataViewer) 或同等 IAM 權限。

  5. 為環境設定應用程式預設憑證 (ADC)。

安裝 MCP Toolbox

  1. 以二進位檔形式下載最新版 MCP Toolbox。選取與作業系統 (OS) 和 CPU 架構對應的二進位檔。您必須使用 MCP Toolbox V0.7.0 以上版本：

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox

    將 VERSION 替換為 MCP Toolbox 版本，例如 v0.7.0。

    macOS darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox

    將 VERSION 替換為 MCP Toolbox 版本，例如 v0.7.0。

    macOS darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox

    將 VERSION 替換為 MCP Toolbox 版本，例如 v0.7.0。

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox

    將 VERSION 替換為 MCP Toolbox 版本，例如 v0.7.0。

  2. 將二進位檔設為可執行檔：

    chmod +x toolbox

  3. 驗證安裝：

    ./toolbox --version

設定 MCP 用戶端

Claude 代碼


1. 安裝 Claude Code。
2. 如果專案根目錄中沒有 .mcp.json 檔案，請建立該檔案。
3. 新增設定、將環境變數替換為您的值，然後儲存：

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

Claude 電腦版


1. 開啟 Claude Desktop，然後前往「設定」。
2. 在「開發人員」分頁中，按一下「編輯設定」開啟設定檔。
3. 新增設定、將環境變數替換為您的值，然後儲存：

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

4. 重新啟動 Claude Desktop。
5. 新的即時通訊畫面會顯示槌子 (MCP) 圖示和新的 MCP 伺服器。


Cline


1. 在 VS Code 中開啟 Cline 擴充功能，然後輕觸「MCP Servers」圖示。
2. 輕觸「設定 MCP 伺服器」開啟設定檔。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

伺服器連線成功後，會顯示綠色的「有效」狀態。

Cursor


1. 如果專案根目錄中沒有 .cursor 目錄，請建立該目錄。
2. 如果 .cursor/mcp.json 檔案不存在，請建立並開啟該檔案。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

4. 開啟「游標」，然後依序前往「設定」>「游標設定」>「MCP」。伺服器連線後，會顯示綠色的「有效」狀態。

Visual Studio Code (Copilot)


1. 開啟 VS Code，並在專案根目錄中建立 .vscode 目錄 (如果不存在)。
2. 如果 .vscode/mcp.json 檔案不存在，請建立並開啟該檔案。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：

{
  "servers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

滑浪風帆


1. 開啟 Windsurf，然後前往 Cascade 助理。
2. 按一下 MCP 圖示，然後點選「設定」開啟設定檔。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

使用工具

您的 AI 工具現在已透過 MCP 連線至 BigQuery。你可以要求 AI 助理列出資料表、建立資料表，或是定義及執行其他 SQL 陳述式。

LLM 可使用下列工具：

  • execute_sql：執行 SQL 陳述式
  • get_dataset_info：取得資料集中繼資料
  • get_table_info：取得資料表中繼資料
  • list_dataset_ids：列出資料集
  • list_table_ids：列出資料表