BigQuery Analysis MCP Server

BigQuery分析MCP服务器

概述

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

• 查询验证（模拟运行）：验证查询是否有效并估计其处理大小
• 安全查询执行：仅运行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\ 窗户： %APPDATA%/Claude/claude_desktop_config.json

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

调试

由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用 MCP检查员:

npm run inspector

检查器将提供一个URL，用于访问浏览器中的调试工具。

身份验证设置

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

1. 使用gcloud CLI登录：

   gcloud auth application-default login

1. 使用服务帐户密钥：

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

使用示例

1. 模拟查询：

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

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

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

______________________________________________________________________

BigQuery Analysis MCP服务器（日语版）

概要

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（v16）以上）
• Google Cloud认证设置（gcloud CLI或服务帐户）

安装相关性

npm install

构建

npm run build

开发模式（自动重建）

npm run watch

安装

Claude Desktop要在中使用，请添加服务器设置：

MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json\ 窗户： %APPDATA%/Claude/claude_desktop_config.json

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

调试

MCP由于服务器通过标准输入/输出（stdio）进行通信，因此调试可能很困难。MCP检查员建议使用：

npm run inspector

Inspector在浏览器中访问调试工具URL中描述的相应参数的值。

认证设定

这个服务器Google Cloud使用凭据。请使用以下方法之一设置认证：

1. gcloud CLI登录：

   gcloud auth application-default login

1. 使用服务帐户密钥：

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

使用例

1. 查询驱动程序：

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

1. 验证查询执行：

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