BigQuery MCP Server

BigQuery MCP Server

这是一个模型上下文协议（MCP）服务器，为BigQuery数据集提供安全的只读访问。它使大型语言模型（LLMs）能够通过标准化接口安全地查询和分析数据。

GitHub
Created Byergutergut

概述

BigQuery MCP 服务器允许您的大语言模型（如 Claude）直接与 BigQuery 数据交互，无需手动编写 SQL 查询。它充当 AI 助手和数据库之间的翻译器，支持自然语言查询。

smithery 徽章

功能

  • 通过自然语言提问执行 SQL 查询
  • 访问表和物化视图
  • 探索数据集模式
  • 安全地分析数据（默认查询限制为1GB）
  • 只读访问，确保数据安全

前提条件

  • Node.js 14+
  • 启用了 BigQuery 的 Google Cloud 项目
  • Google Cloud CLI 或服务账户密钥
  • Claude Desktop（目前唯一支持的接口）

安装方法

选项1：通过 Smithery 安装（推荐）

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

安装程序会提示您输入：

  • Google Cloud 项目 ID
  • BigQuery 位置（默认：us-central1）

选项2：手动设置

  1. 配置 Google Cloud 身份验证

    # 开发环境
gcloud auth application-default login

# 或使用服务账户（生产环境）
# 准备好服务账户密钥文件

  2. 添加到 Claude Desktop 配置

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

    使用服务账户时添加 --key-file 参数：

    "args": [
  // ...其他参数
  "--key-file",
  "/path/to/service-account-key.json"
]

必要权限

需要以下之一：

  • roles/bigquery.user（推荐）
  • 或同时具备 roles/bigquery.dataViewer 和 roles/bigquery.jobUser

使用方法

安装完成后，只需在 Claude Desktop 中自然地询问有关您数据的问题：

"上个月我们的前10名客户是谁？"

Claude 会查询您的 BigQuery 数据库并用自然语言回答。

限制

  • 目前仅在 Claude Desktop（开发者预览版）中支持
  • 仅支持本地 MCP 服务器
  • 只读查询，处理限制为1GB
  • 部分复杂视图类型可能有限制

支持资源

许可证

MIT