基本能力
产品定位
BigQuery MCP Server 是一个数据库交互工具，旨在简化 AI 与 BigQuery 数据库之间的通信，提供自然语言查询数据的能力。
核心功能
- 通过自然语言运行 SQL 查询
- 访问数据集中的表和物化视图
- 探索数据集架构，清晰标记资源类型（表与视图）
- 在安全限制内分析数据（默认 1GB 查询限制）
- 保持数据安全（只读访问）
适用场景
- 数据分析师希望通过自然语言快速查询 BigQuery 数据
- 开发人员需要将 AI 模型与 BigQuery 数据库集成
- 团队希望简化数据查询流程，减少手动编写 SQL 的需求
工具列表
- Smithery CLI：用于快速安装和配置 BigQuery MCP Server
- Google Cloud CLI：用于开发环境下的认证
- Claude Desktop：当前唯一支持的 LLM 接口
常见问题解答
- 目前仅支持 Claude Desktop（开发者预览版）
- 连接仅限于本地运行的 MCP 服务器
- 查询为只读，且有 1GB 处理限制
- 某些复杂视图类型可能有功能限制
使用教程
使用依赖
- Node.js 14 或更高版本
- 已启用 BigQuery 的 Google Cloud 项目
- 已安装 Google Cloud CLI 或服务账户密钥文件
- Claude Desktop（当前唯一支持的 LLM 接口）
安装教程
选项1：通过 Smithery 快速安装（推荐）
bash
npx @smithery/cli install @ergut/mcp-bigquery-server --client claude
选项2：手动设置
-
使用 Google Cloud CLI 认证：
bash
gcloud auth application-default login -
添加到 Claude Desktop 配置
基本配置示例：
json
{
"mcpServers": {
"bigquery": {
"command": "npx",
"args": [
"-y",
"@ergut/mcp-bigquery-server",
"--project-id",
"your-project-id",
"--location",
"us-central1"
]
}
}
}
调试方式
使用服务账户运行示例：
bash
npx @ergut/mcp-bigquery-server --project-id your-project-id --location europe-west1 --key-file /path/to/key.json
开发者设置（可选）
bash
git clone https://github.com/ergut/mcp-bigquery-server
cd mcp-bigquery-server
npm install
npm run build
