使用 MCP Toolbox 将 IDE 连接到 BigQuery
本指南介绍了如何使用 MCP Toolbox for Databases 将 BigQuery 实例连接到各种集成开发环境 (IDE) 和开发者工具。它使用模型上下文协议 (MCP)，这是一种用于将大型语言模型 (LLM) 连接到 BigQuery 等数据源的开放协议，可让您直接通过现有工具运行 SQL 查询并与项目进行交互。
本指南演示了以下 IDE 的连接过程：
- Cursor
- Windsurf (Codium)
- Visual Studio Code (Copilot)
- Cline（VS Code 扩展程序）
- Claude Desktop
- Claude 代码
准备工作
在 Trusted Cloud 控制台的项目选择器页面上，选择或创建 Trusted Cloud by S3NS 项目。
配置完成此任务所需的角色和权限。您需要拥有 BigQuery User 角色 (
roles/bigquery.user)、BigQuery Data Viewer 角色 (roles/bigquery.dataViewer) 或等效的 IAM 权限才能连接到实例。为您的环境配置应用默认凭证 (ADC)。
安装 MCP Toolbox
下载最新版本的 MCP Toolbox 二进制文件。选择与您的操作系统 (OS) 和 CPU 架构相对应的二进制文件。您必须使用 MCP Toolbox 版本 V0.6.0 或更高版本：
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.6.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/v0.6.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.6.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.6.0/windows/amd64/toolbox
将该二进制文件设为可执行文件：
chmod +x toolbox验证安装：
./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 Desktop
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 服务器图标。
2. 点按“配置 MCP 服务器”以打开配置文件。
3. 添加以下配置，将环境变量替换为您的值，然后保存：
{
"mcpServers": {
"bigquery": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","bigquery","--stdio"],
"env": {
"BIGQUERY_PROJECT": "PROJECT_ID"
}
}
}
}
光标
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. 添加以下配置，将环境变量替换为您的值，然后保存：
{
"mcp":{
"servers": {
"bigquery": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","bigquery","--stdio"],
"env": {
"BIGQUERY_PROJECT": "PROJECT_ID"
}
}
}
}
}
Windsurf
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：列出表