BigQuery Analysis MCP Server

BigQuery Analysis MCP Server

概述

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

• 查询验证（试运行）：验证查询是否有效，并估算其处理的数据量
• 安全执行查询：仅运行处理量低于 1TB 的 SELECT 查询（防止修改数据）
• JSON 格式结果：以结构化 JSON 格式返回查询结果

功能

工具

• dry_run_query - 对 BigQuery 查询执行试运行

  • 验证查询并估算其处理的数据量
  • 检查查询的数据量是否超过 1TB 上限

• run_query_with_validation - 验证后运行 BigQuery 查询

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

开发

前提条件

• Node.js 22.23.4+、24.22.1+ 或 26.12.1+（使用受支持版本系列的最新补丁版本）
• pnpm 12.4.2（在 package.json 中固定）
• Google Cloud 身份验证设置（gcloud CLI 或服务账号）

安装依赖项

pnpm install --frozen-lockfile

测试

pnpm test

构建

pnpm run build

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

pnpm 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：

pnpm 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")
   

---

BigQuery Analysis MCP Server（日本語版）

概述

这是一个用于在 BigQuery 中执行 SQL 查询的 MCP 服务。它能够验证（试运行）并执行查询，并提供安全功能，以防止处理 1TB 以上的数据以及执行修改数据的查询（DML）。

功能

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

• 查询验证（试运行）：确认查询是否有效，并估算处理的数据量
• 安全执行查询：仅执行处理量不超过 1TB 的 SELECT 查询（防止修改数据）
• 以 JSON 格式返回结果：以结构化 JSON 格式返回查询结果

功能

工具

• dry_run_query - 对 BigQuery 查询执行试运行

  • 验证查询并估算处理的数据量
  • 检查查询的数据量是否超过 1TB 上限

• run_query_with_validation - 验证后执行 BigQuery 查询

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

开发方法

前提条件

• Node.js 22.23.4 及以上、24.22.1 及以上，或 26.12.1 及以上（使用受支持版本系列的最新补丁版本）
• pnpm 12.4.2（在 package.json 中固定）
• Google Cloud 身份验证设置（gcloud CLI 或服务账号）

安装依赖项

pnpm install --frozen-lockfile

测试

pnpm test

构建

pnpm run build

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

pnpm run watch

安装

如需在 Claude Desktop 中使用，请添加服务配置：

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

{
  "mcpServers": {
    "bigquery": {
      "command": "node",
      "args": ["/path/to/bigquery-server/build/index.js"]
    }
  }
}

调试

由于 MCP 服务通过标准输入输出（stdio）通信，调试可能会比较困难。建议使用 MCP Inspector：

pnpm 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")