适合谁
- 开发人员和分析师希望通过 AI 助手快速查询 BigQuery
- 希望在不让 AI 代理修改数据的情况下获得数据见解
- 处理敏感数据并需要字段级访问限制的组织
B
62FMRS · C
这个服务器提供了安全的只读 BigQuery 访问，非常适合希望利用 AI 进行数据查询但需要严格保护敏感数据的团队。它默认只读并支持字段级限制，增加了安全性。不过，用户必须了解数据会发送到 LLM 提供方，且字段限制不是防火墙。
BigQuery MCP Server 是一个模型上下文协议（Model Context Protocol, MCP）服务器，提供对 BigQuery 数据集的只读访问。它作为 AI 助手与数据仓库之间的翻译层，允许您用自然语言提问，而 AI 代理会安全地执行 SQL 查询。该服务器仅允许 SELECT 语句，并通过 BigQuery 的 dry-run 规划器验证每次查询，从而阻止 INSERT、UPDATE、DELETE、DROP、TRUNCATE、EXPORT DATA 和 MERGE 等操作。它支持配置查询字节上限、字段级访问限制，并自动发现敏感列（如姓名、邮箱、SSN 等），防止 AI 代理读取个人身份信息（PII）、受保护健康信息（PHI）或财务数据。
工具能力
暂未整理工具清单。
安装接入
- 确保已安装 Node.js 14 或更高版本，并拥有已启用 BigQuery 的 Google Cloud 项目。
- 使用
gcloud auth application-default login进行身份验证。 - 在 MCP 客户端配置文件中添加服务器配置，例如对于 Claude Desktop 或 Claude Code，使用类似以下 JSON：
{
"mcpServers": {
"bigquery": {
"command": "npx",
"args": ["-y", "@ergut/mcp-bigquery-server", "--project-id", "your-project-id"]
}
}
}
- 重新启动 MCP 客户端并开始对话。
claude_desktop_config.json
{
"mcpServers": {
"bigquery": {
"command": "npx",
"args": [
"-y",
"@ergut/mcp-bigquery-server",
"--project-id",
"your-project-id"
]
}
}
}
选型与风险
不适合谁
- 需要写入、更新或删除数据的场景
- 需要绕过字段限制或完全访问所有列的用户
- 不依赖云 LLM 处理查询结果的严格安全环境（因为数据会发送到 LLM 提供方）
所需权限
- BigQuery 读取权限（例如 roles/bigquery.user 或 roles/bigquery.dataViewer）
- 对于服务账户认证，需要访问服务账户密钥文件
- 对于高级功能，可能需要列出数据集和表，以及运行 dry-run 查询
风险与副作用
- 数据外发：查询结果发送到 LLM 提供方（如 Anthropic、OpenAI），可能离开您的网络
- 尽管有字段限制，AI 代理仍可能通过巧妙的查询尝试推断数据
- 配置错误可能导致限制失效，例如误配置 preventedFields 或最大字节上限
常见排障
- 检查 MCP 客户端配置是否正确，并确认 `npx` 可访问
- 验证 Google Cloud 身份验证：运行 `gcloud auth application-default login`
- 确保 BigQuery API 已启用，且项目 ID 正确
- 如果使用服务账户，请检查密钥文件路径是否正确
- 对于受保护模式，验证 config.json 是否存在且 schema 正确
使用场景
用自然语言提问业务数据，例如“上个月我们的前 10 大客户是谁？”
浏览数据集模式，识别表和视图。
在不编写复杂 SQL 的情况下分析数据，但保持对敏感数据的控制。
支持客户端
Claude Desktop完整支持
Claude Code完整支持