BigQuery MCP Server

BigQuery MCP Server

site icon
2024.12.27 0
JavaScript数据库连接自然语言查询AI 集成数据库开发效率
BigQuery MCP Server 是一个允许大型语言模型(如 Claude)直接与 BigQuery 数据库交互的服务。它充当 AI 助手和数据库之间的翻译器,使得用户可以通过自然语言查询数据库,而无需手动编写 SQL 查询。该服务支持运行 SQL 查询、访问表和物化视图、探索数据集架构,并在安全限制内分析数据。
View on GitHub

Overview

基本能力

产品定位

BigQuery MCP Server 是一个用于连接大型语言模型(如 Claude)和 BigQuery 数据库的中间件服务,使得用户可以通过自然语言与数据库交互。

核心功能

  • 通过自然语言运行 SQL 查询
  • 访问 BigQuery 中的表和物化视图
  • 探索数据集架构,清晰标记资源类型(表 vs 视图)
  • 在安全限制内分析数据(默认 1GB 查询限制)
  • 提供只读数据访问,确保数据安全

适用场景

  • 数据分析师希望通过自然语言快速查询数据库
  • 开发人员需要将 AI 模型与 BigQuery 数据库集成
  • 团队希望简化数据库查询流程,减少手动编写 SQL 的需求

工具列表

  • Smithery CLI:用于快速安装和配置 BigQuery MCP Server
  • Google Cloud CLI:用于身份验证和项目配置
  • Claude Desktop:当前唯一支持的 LLM 接口

常见问题解答

  • 支持的语言模型:目前仅支持 Claude Desktop
  • 连接限制:仅支持本地运行的 MCP 服务器
  • 查询限制:只读访问,默认 1GB 处理限制

使用教程

使用依赖

  • 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 位置(默认为 us-central1)

选项 2:手动设置

  1. 使用 Google Cloud CLI 进行身份验证 bash gcloud auth application-default login
  2. 添加到 Claude Desktop 配置claude_desktop_config.json 中添加以下内容: json { "mcpServers": { "bigquery": { "command": "npx", "args": [ "-y", "@ergut/mcp-bigquery-server", "--project-id", "your-project-id", "--location", "us-central1" ] } } }

调试方式

启动 Claude Desktop 并开始询问有关数据的问题。

开发者设置(可选)

git clone https://github.com/ergut/mcp-bigquery-server
cd mcp-bigquery-server
npm install
npm run build

更新 Claude Desktop 配置以指向本地构建。

许可证

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