BigQuery Analysis

Executa e valida consultas SQL no Google BigQuery. Executa com segurança consultas SELECT abaixo de 1TB e retorna resultados em formato JSON.

GitHub

Experimente este MCPPatrocinado

Documentação

BigQuery Analysis MCP Server

Visão Geral

Este servidor é um servidor MCP para executar consultas SQL no Google BigQuery, fornecendo os seguintes recursos:

Validação de consultas (dry run): Verifica se uma consulta é válida e estima seu tamanho de processamento
Execução segura de consultas: Executa apenas consultas SELECT abaixo de 1TB (previne modificações de dados)
Resultados em formato JSON: Retorna os resultados das consultas em JSON estruturado

Recursos

Ferramentas

dry_run_query - Realiza um dry run de uma consulta do BigQuery
- Valida a consulta e estima seu tamanho de processamento
- Verifica o tamanho da consulta em relação ao limite de 1TB
run_query_with_validation - Executa uma consulta do BigQuery com validação
- Detecta e rejeita instruções DML (consultas de modificação de dados)
- Rejeita processamento de dados acima de 1TB
- Executa consultas que passam na validação e retorna os resultados

Desenvolvimento

Pré-requisitos

Node.js (v16 ou superior)
Configuração de autenticação do Google Cloud (CLI gcloud ou conta de serviço)

Instalar Dependências

npm install

Compilar

npm run build

Modo de Desenvolvimento (Recompilação Automática)

npm run watch

Instalação

Para usar com o Claude Desktop, adicione a configuração do servidor:

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"
    }
  }
}

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.

Configuração de Autenticação

Este servidor usa autenticação do Google Cloud. Configure a autenticação usando um dos seguintes métodos:

Entre com a CLI gcloud:
```
gcloud auth application-default login
```

Use uma chave de conta de serviço:

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

Exemplos de Uso

Fazer dry run de uma consulta:

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

Executar uma consulta com validação:

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

BigQuery Analysis MCP Server (Versão em Japonês)

Visão Geral

É um servidor MCP para executar consultas SQL no BigQuery. Ele realiza a validação (dry run) e execução de consultas, com recursos de segurança que previnem o processamento de dados acima de 1TB e consultas de modificação (DML).

Recursos

Este servidor é um servidor MCP para executar consultas SQL no Google BigQuery, fornecendo os seguintes recursos:

Validação de consultas (dry run): Verifica se uma consulta é válida e estima seu tamanho de processamento
Execução segura de consultas: Executa apenas consultas SELECT abaixo de 1TB (previne modificações de dados)
Retorno de resultados em formato JSON: Retorna os resultados das consultas em JSON estruturado

Recursos

Ferramentas

dry_run_query - Realiza um dry run de uma consulta do BigQuery
- Realiza a validação da consulta e a estimativa do tamanho de processamento
- Verifica o tamanho da consulta em relação ao limite de 1TB
run_query_with_validation - Executa uma consulta do BigQuery com validação
- Detecta e rejeita instruções DML (consultas de modificação de dados)
- Rejeita processamento de dados acima de 1TB
- Executa consultas que passam na validação e retorna os resultados

Método de Desenvolvimento

Pré-requisitos

Node.js (v16 ou superior)
Configuração de autenticação do Google Cloud (CLI gcloud ou conta de serviço)

Instalação de Dependências

npm install

Compilar

npm run build

Modo de Desenvolvimento (Recompilação Automática)

npm run watch

Instalação

Para usar com o Claude Desktop, adicione a configuração do servidor:

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"]
    }
  }
}

Depuração

Como os servidores MCP se comunicam via entrada e saída padrão (stdio), a depuração pode ser difícil. Recomendamos o uso do MCP Inspector:

npm run inspector

O Inspector fornece uma URL para acessar as ferramentas de depuração no navegador.

Configuração de Autenticação

Este servidor usa credenciais de autenticação do Google Cloud. Configure a autenticação usando um dos seguintes métodos:

Entre com a CLI gcloud:
```
gcloud auth application-default login
```

Use uma chave de conta de serviço:

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

Exemplos de Uso

Dry run de uma consulta:

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

Execução de consulta com validação:

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