BigQuery MCP server

BigQuery MCP server

site icon
2025.01.09 0
Python数据库服务BigQuery 访问数据查询数据库
BigQuery MCP server 是一个基于 Model Context Protocol 的服务,提供对 Google BigQuery 数据库的访问能力。该服务允许大型语言模型(LLMs)检查数据库模式并执行查询。
View on GitHub

Overview

基本能力

产品定位

BigQuery MCP server 是一个数据库访问服务,专门用于与 Google BigQuery 交互,为 LLMs 提供数据库查询和模式检查能力。

核心功能

  • 执行 BigQuery SQL 查询
  • 列出 BigQuery 数据库中的所有表
  • 描述特定表的模式

适用场景

  • 需要让 LLMs 访问和分析 BigQuery 数据的应用
  • 数据库模式检查和查询执行自动化
  • 数据分析和报告生成

工具列表

  1. execute-query: 使用 BigQuery 方言执行 SQL 查询
  2. list-tables: 列出 BigQuery 数据库中的所有表
  3. describe-table: 描述特定表的模式

常见问题解答

  • 调试建议:由于 MCP 服务器通过 stdio 运行,建议使用 MCP Inspector 进行调试

使用教程

使用依赖

需要安装 Python 环境和 uv 工具

安装教程

  1. 配置 Claude Desktop 的配置文件(MacOS 或 Windows)
  2. 添加 MCP 服务器配置

MacOS 配置示例:

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

调试方式

使用 MCP Inspector 进行调试:

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

许可证

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