MCP Services - BigQuery MCP Server

概述

BigQuery MCP 服务器允许大语言模型（如 Claude）直接查询和分析您的 BigQuery 数据。无需手动编写 SQL，只需用自然语言提问即可。

前提条件

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 位置。

方法 2：手动设置

设置 Google Cloud 身份验证：

# 使用 Google Cloud CLI（适合开发）
gcloud auth application-default login

# 或者使用服务账户（适合生产环境）
# 保存服务账户密钥文件并在下一步中使用 --key-file 参数

配置 Claude Desktop：

编辑 claude_desktop_config.json：

{
  "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"
]

重启 Claude Desktop 并开始使用

命令行参数

--project-id：（必需）Google Cloud 项目 ID
--location：（可选）BigQuery 位置，默认为 'us-central1'
--key-file：（可选）服务账户密钥文件路径

所需权限

至少需要以下权限之一：

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

功能

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

BigQuery MCP Server

概述