← 返回目录

BigQuery MCP Server

社区

让大语言模型安全只读地查询 BigQuery 数据。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 15 / 58
Stars: ★ 148 热门
传输方式: stdio（本地进程）
运行环境: Node.js 14+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 4 个月前

62FMRS · C

这个服务器提供了安全的只读 BigQuery 访问，非常适合希望利用 AI 进行数据查询但需要严格保护敏感数据的团队。它默认只读并支持字段级限制，增加了安全性。不过，用户必须了解数据会发送到 LLM 提供方，且字段限制不是防火墙。

最强项 · 安全与权限 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

16/20

维护活跃度

10/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 根据README和源码，服务器提供MCP握手和工具列表，但未提供可验证的CI工作流和测试套件证据以证明关键路径的可复现性。文档声称只读和干运行验证，但源代码中的实际实现细节未审查，因此无法确认端到端行为。由于缺乏执行证据，可靠性的评分上限为12，且未知的错误处理降低了分数。
安全与权限 16/20: 服务器设计为只读，并在文档中明确说明了干运行验证和字段限制。源码中未发现明显的恶意行为或凭据泄露。然而，安全模型依赖于合作性护栏，并未提供硬性保证。整体上，权限控制和数据边界似乎合理，但由于未对源代码进行深入审查，某些实施细节可能不完整。
维护活跃度 10/20: 仓库有145颗星和3个未关闭的问题，最近有提交，但没有提供发布日期和详细的更新历史。许可证为MIT，但没有明显的安全响应通道。维护活跃度尚可，但版本管理和治理存在缺口。
文档质量 15/20: README提供了安装、认证、配置和限制的详细说明，以及安全模型的文档。但缺少深入的故障排除指南和完整的工具参数参考。文档质量良好，但仍有改进空间。
安装易用性 13/20: 安装步骤清晰，提供了npx和本地构建的示例，以及客户端配置示例。但依赖Google Cloud认证和BigQuery环境，可能增加设置复杂性。由于未执行，无法确认安装步骤的顺利程度。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么连接数据库

适合谁

开发人员和分析师希望通过 AI 助手快速查询 BigQuery
希望在不让 AI 代理修改数据的情况下获得数据见解
处理敏感数据并需要字段级访问限制的组织

不适合谁

需要写入、更新或删除数据的场景
需要绕过字段限制或完全访问所有列的用户
不依赖云 LLM 处理查询结果的严格安全环境（因为数据会发送到 LLM 提供方）

所需权限

BigQuery 读取权限（例如 roles/bigquery.user 或 roles/bigquery.dataViewer）
对于服务账户认证，需要访问服务账户密钥文件
对于高级功能，可能需要列出数据集和表，以及运行 dry-run 查询

风险与副作用

数据外发：查询结果发送到 LLM 提供方（如 Anthropic、OpenAI），可能离开您的网络
尽管有字段限制，AI 代理仍可能通过巧妙的查询尝试推断数据
配置错误可能导致限制失效，例如误配置 preventedFields 或最大字节上限

安装接入

准备工作

运行环境：Node.js 14+

确保已安装 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "bigquery": {
      "command": "npx",
      "args": [
        "-y",
        "@ergut/mcp-bigquery-server",
        "--project-id",
        "your-project-id"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add bigquery -- npx -y @ergut/mcp-bigquery-server --project-id your-project-id

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

将服务器配置加入 claude_desktop_config. 或 .mcp. 并重启客户端后，向 Claude 提问例如“我的 BigQuery 数据集里有哪些表？”——如果它返回真实的表名，说明连接成功。

常见排障

检查 MCP 客户端配置是否正确，并确认 `npx` 可访问
验证 Google Cloud 身份验证：运行 `gcloud auth application-default login`
确保 BigQuery API 已启用，且项目 ID 正确
如果使用服务账户，请检查密钥文件路径是否正确
对于受保护模式，验证 config.json 是否存在且 schema 正确

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查一下上个月消费最高的前10位客户是谁。
列出我的 BigQuery 数据集里有哪些表和视图，并说明每个资源的类型。
统计一下 patients 表中最近30天的记录数（不要返回任何个人信息字段）。
这个数据集里哪些列可能包含敏感信息？

使用场景

用自然语言提问业务数据，例如“上个月我们的前 10 大客户是谁？”

浏览数据集模式，识别表和视图。

在不编写复杂 SQL 的情况下分析数据，但保持对敏感数据的控制。

支持客户端

Claude Desktop

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

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）或财务数据。