BigQuery Analysis MCP Server

基本能力

产品定位

BigQuery Analysis MCP Server 是一个用于执行 Google BigQuery SQL 查询的 MCP 服务器，提供查询验证（dry run）、安全查询执行和 JSON 格式结果返回等功能。

核心功能

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

适用场景

• 需要验证 BigQuery 查询的有效性和处理大小的场景。
• 需要安全执行 BigQuery 查询，防止数据修改或过大查询的场景。
• 需要以 JSON 格式获取查询结果的场景。

工具列表

• dry_run_query：执行 BigQuery 查询的 dry run，验证查询并估计处理大小，检查查询大小是否超过 1TB 限制。
• run_query_with_validation：在验证后执行 BigQuery 查询，检测并拒绝 DML 语句（数据修改查询），拒绝超过 1TB 的数据处理，执行通过验证的查询并返回结果。

常见问题解答

• 如何调试 MCP 服务器？推荐使用 MCP Inspector 进行调试。
• 如何设置 Google Cloud 认证？可以通过 gcloud CLI 登录或使用服务账户密钥。

使用教程

使用依赖

• Node.js（v16 或更高版本）
• Google Cloud 认证设置（gcloud CLI 或服务账户）

安装教程

1. 安装依赖：

npm install

1. 构建：

npm run build

1. 开发模式（自动重建）：

npm run watch

1. 在 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"
    }
  }
}

调试方式

1. 使用 MCP Inspector 进行调试：

npm run inspector

1. Inspector 将在浏览器中提供调试工具的 URL。

许可证

None