BigQuery MCP server

概述

BigQuery MCP 服务器允许 LLM 通过 Model Context Protocol 直接与 BigQuery 数据库交互，执行查询并检查数据库模式。

功能

服务器提供三个核心工具：

• execute-query：执行 SQL 查询
• list-tables：列出所有可用表
• describe-table：获取表结构详情

安装与配置

必要参数

• --project：GCP 项目 ID（必需）
• --location：GCP 位置，例如 europe-west9（必需）
• --dataset：要访问的 BigQuery 数据集（可选，可多次指定）

在 Claude 桌面版中配置

配置文件位置：

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

开发环境配置:

"mcpServers": {
  "bigquery": {
    "command": "uv",
    "args": [
      "--directory",
      "{{PATH_TO_REPO}}",
      "run",
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{GCP_LOCATION}}"
    ]
  }
}

生产环境配置:

"mcpServers": {
  "bigquery": {
    "command": "uvx",
    "args": [
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{GCP_LOCATION}}"
    ]
  }
}

替换所有 {{...}} 占位符为实际值。

开发指南

构建和发布

# 同步依赖
uv sync

# 构建包
uv build

# 发布到 PyPI
uv publish

调试

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory {{PATH_TO_REPO}} run mcp-server-bigquery

启动后，在浏览器中打开提供的 URL 开始调试。