Bq MCP Py

BigQuery MCP服务器

一个最小的MCP（模型上下文协议）服务器，提供对Google Cloud BigQuery命令的直通访问。此服务器使用您现有的 gcloud CLI身份验证，并提供用于查询BigQuery表模式、例程信息以及执行带有安全检查的BigQuery查询的工具。

特性

• 最小设置：使用您现有的 gcloud CLI身份验证
• 模式检查：获取JSON格式的BigQuery表和视图模式
• 常规信息：获取BigQuery例程（TVF、存储过程、函数）详细信息
• 查询执行：执行BigQuery查询，并进行安全检查，要求用户批准危险操作（DELETE、DROP、TRUNCATE等）

先决条件

• 谷歌云SDK(gcloud 和 bq 命令）已安装和配置
• Python 3.13+
• uv 包管理器

编码剂的安装

克劳德代码

有关设置说明，请参阅：https://docs.anthropic.com/en/docs/claude-code/mcp

VS代码

有关设置说明，请参阅：https://code.visualstudio.com/docs/copilot/chat/mcp-servers

使用此服务器配置：

"bq-mcp": {
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/bq-mcp-py",
    "run",
    "bq-mcp.py"
  ]
}

用法

安装后，服务器提供以下工具：

• get_bq_schema(table_id)：获取BigQuery表或视图的架构 project.dataset.table 格式
• get_bq_routine(routine_id)：在中获取有关BigQuery例程（TVF、存储过程、函数）的信息 project.dataset.routine_name 格式
• execute_bq_query(query, project_id)：执行BigQuery查询，对危险操作进行安全检查和用户批准提示

认证

此服务器使用您现有的 gcloud CLI身份验证。请确保您已通过Google Cloud的身份验证：

gcloud auth login
gcloud config set project YOUR_PROJECT_ID