BigQuery MCP Server

基本能力

产品定位

BigQuery MCP Server 是一个专门为 Google BigQuery 设计的 MCP 服务器，旨在通过协议化的方式提供对 BigQuery 数据的访问能力，特别适用于需要集成 BigQuery 功能的 LLM 应用场景。

核心功能

1. 认证与连接管理
2. 支持应用默认凭证（ADC）或服务账户密钥文件
3. 可配置的项目 ID 和位置设置

4. 启动时的认证验证

5. 工具集

6. query: 执行只读（SELECT）BigQuery SQL 查询
7. list_all_datasets: 列出项目中的所有数据集
8. list_all_tables_with_dataset: 列出特定数据集中的所有表及其模式
9. get_table_information: 获取表模式和样本数据

10. dry_run_query: 检查查询有效性并估算成本

11. 安全特性

12. 仅允许 SELECT 查询（只读访问）
13. 默认限制查询处理量为 500GB 以防止过高成本
14. 分区表的分区过滤器推荐
15. 安全处理认证凭证

适用场景

• LLM 需要访问和分析 BigQuery 数据
• 需要自动化执行 BigQuery 查询的应用
• 数据探索和数据集结构分析
• 查询成本估算和验证

使用教程

使用依赖

1. 安装 Google Cloud SDK（如需使用应用默认凭证） ```bash # For macOS brew install --cask google-cloud-sdk

# For other platforms, see: https://cloud.google.com/sdk/docs/install ```

1. 运行认证命令 bash gcloud auth application-default login

安装教程

1. 本地安装 bash git clone https://github.com/yourusername/bigquery-mcp-server.git cd bigquery-mcp-server bun install bun run build cp dist/bigquery-mcp-server /path/to/your_place

2. Docker 安装 bash docker build -t bigquery-mcp-server . docker run -it --rm bigquery-mcp-server --project-id=your-project-id

调试方式

1. 使用 inspector 进行测试和调试 bash npx @modelcontextprotocol/inspector dist/bigquery-mcp-server --project-id={{your_own_project}}

2. 使用 helper 脚本 bash chmod +x run-server.sh ./run-server.sh --project-id=your-project-id

3. 手动执行 bash ./dist/bigquery-mcp-server --project-id=your-project-id

许可证

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