BigQuery MCP服务器
提供对BigQuery访问的模型上下文协议服务器。此服务器使LLM能够检查数据库模式并执行查询。
组件
工具
服务器实现了一个工具：
execute-query：使用BigQuery方言执行SQL查询list-tables：列出BigQuery数据库中的所有表describe-table：描述特定表的架构
配置
服务器可以配置命令行参数或环境变量。
| 参数 | 环境变量 | 必填 | 描述 |
|---|---|---|---|
--project | BIGQUERY_PROJECT | 是 | GCP项目ID |
--location | BIGQUERY_LOCATION | 是 | GCP位置（例如。 europe-west9). |
--dataset | BIGQUERY_DATASETS | 否 | 仅考虑特定的BigQuery数据集。通过重复参数可以指定多个数据集（例如。 --dataset my_dataset_1 --dataset my_dataset_2)或者在环境变量中用逗号将它们连接起来（例如。 BIGQUERY_DATASETS=my_dataset_1,my_dataset_2).如果没有提供，将考虑项目中的所有数据集。 |
--key-file | BIGQUERY_KEY_FILE | 否 | BigQuery服务帐户密钥文件的路径。如果没有提供，服务器将使用默认凭据。 |
--timeout | BIGQUERY_TIMEOUT | 否 | 等待查询完成的最长时间（秒）。如果没有提供，查询将无限期等待。 |
安装
通过Smithery安装
通过以下方式自动安装BigQuery Server for Claude Desktop 铁匠铺:
npx -y @smithery/cli install mcp-server-bigquery --client claude克劳德代码
claude mcp add bigquery --scope user --transport stdio -- uvx mcp-server-bigquery --project {PROJECT_ID} --location {{LOCATION}}克劳德桌面版
在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json\ 在Windows上： %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"bigquery": {
"command": "uvx",
"args": ["mcp-server-bigquery"],
"env": {
"BIGQUERY_PROJECT": "{{GCP_PROJECT_ID}}",
"BIGQUERY_LOCATION": "{{GCP_LOCATION}}"
}
}
}
}光标
- 打开光标设置→ MCP
- 单击添加新的全局MCP服务器
- 按照以下模式为BigQuery MCP添加一个条目：
{
"mcpServers": {
"bigquery": {
"command": "uvx",
"args": ["mcp-server-bigquery"],
"env": {
"BIGQUERY_PROJECT": "{{GCP_PROJECT_ID}}",
"BIGQUERY_LOCATION": "{{GCP_LOCATION}}"
}
}
}
}