
BigQuery MCP Server

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:手动设置
- 使用 Google Cloud CLI 进行身份验证
bash gcloud auth application-default login
- 添加到 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 配置以指向本地构建。