BigQuery MCP Server

基本能力

产品定位

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 快速安装（推荐）

npx @smithery/cli install @ergut/mcp-bigquery-server --client claude

选项2：手动设置

1. 使用 Google Cloud CLI 认证：

gcloud auth application-default login

1. 添加到 Claude Desktop 配置 基本配置示例：

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

调试方式

使用服务账户运行示例：

npx @ergut/mcp-bigquery-server --project-id your-project-id --location europe-west1 --key-file /path/to/key.json

开发者设置（可选）

git clone https://github.com/ergut/mcp-bigquery-server
cd mcp-bigquery-server
npm install
npm run build

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。