BigQuery 分析 MCP 服务器

概述

此服务器是一个用于针对 Google BigQuery 执行 SQL 查询的 MCP 服务器，提供以下功能：

• 查询验证（模拟运行）：验证查询是否有效并估计其处理大小
• 安全查询执行：仅运行 1TB 以下的 SELECT 查询（防止数据修改）
• JSON 格式的结果：以结构化的 JSON 格式返回查询结果

功能

工具

• dry_run_query - 执行 BigQuery 查询的模拟运行

  • 验证查询并估计其处理大小
  • 检查查询大小是否超过 1TB 限制

• run_query_with_validation - 运行带有验证的 BigQuery 查询

  • 检测并拒绝 DML 语句（数据修改查询）
  • 拒绝超过 1TB 的数据处理
  • 执行通过验证的查询并返回结果

开发

前提条件

• Node.js（v16 或更高版本）
• Google Cloud 身份验证设置（gcloud CLI 或服务帐户）

安装依赖

npm install

构建

npm run build

开发模式（自动重新构建）

npm run watch

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bigquery-analysis-server": {
      "command": "/path/to/bigquery-analysis-server/build/index.js"
    }
  }
}

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector：

npm run inspector

Inspector 将提供一个 URL 以在您的浏览器中访问调试工具。

身份验证设置

此服务器使用 Google Cloud 身份验证。 使用以下方法之一设置身份验证：

1. 使用 gcloud CLI 登录：

   gcloud auth application-default login
   

2. 使用服务帐户密钥：

   export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"
   

使用示例

1. 模拟运行查询：

   dry_run_query("SELECT * FROM `bigquery-public-data.samples.shakespeare` LIMIT 10")
   

2. 运行带有验证的查询：

   run_query_with_validation("SELECT word, word_count FROM `bigquery-public-data.samples.shakespeare` WHERE corpus='hamlet' LIMIT 10")