使用 MCP Toolbox 将 IDE 连接到 BigQuery

本指南介绍了如何使用 MCP Toolbox for Databases 将 BigQuery 实例连接到各种集成开发环境 (IDE) 和开发者工具。它使用模型上下文协议 (MCP)，这是一种用于将大型语言模型 (LLM) 连接到 BigQuery 等数据源的开放协议，可让您直接通过现有工具运行 SQL 查询并与项目进行交互。

本指南演示了以下 IDE 的连接过程：

• Cursor
• Windsurf（以前称为 Codeium）
• Visual Studio Code (Copilot)
• Cline（VS Code 扩展程序）
• Claude Desktop
• Claude 代码

准备工作

1. 在 Trusted Cloud 控制台的项目选择器页面上，选择或创建 Trusted Cloud by S3NS 项目。

2. 确保您的 Trusted Cloud 项目已启用结算功能。

3. 在 Trusted Cloud 项目中启用 BigQuery API。

4. 配置完成此任务所需的角色和权限。您需要拥有 BigQuery User 角色 (roles/bigquery.user)、BigQuery Data Viewer 角色 (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 客户端

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

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

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

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

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

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

注意：BIGQUERY_PROJECT 环境变量用于指定 MCP Toolbox 将使用的默认 Trusted Cloud 项目的 ID。所有 BigQuery 操作（例如执行查询）都在此项目中运行。

使用这些工具

您的 AI 工具现在已使用 MCP 连接到 BigQuery。尝试让 AI 助理列出表、创建表或定义和执行其他 SQL 语句。

LLM 可使用以下工具：

• ask_data_insights：执行数据分析、获取分析洞见，或回答有关 BigQuery 表内容的复杂问题。
• execute_sql：执行 SQL 语句
• forecast：预测时序数据。
• get_dataset_info：获取数据集元数据
• get_table_info：获取表元数据
• list_dataset_ids：列出数据集
• list_table_ids：列出表