Servidor MCP de análisis de BigQuery

Descripción general

Este servidor es un servidor MCP para ejecutar consultas SQL en Google BigQuery y proporciona las siguientes funciones:

• Validación de consultas (ejecución en seco): verifica si una consulta es válida y estima su tamaño de procesamiento

• Ejecución segura de consultas: solo ejecuta consultas SELECT de menos de 1 TB (evita modificaciones de datos)

• Resultados en formato JSON: devuelve los resultados de la consulta en formato JSON estructurado

Related MCP server: BigQuery Validator

Características

Herramientas

• dry_run_query : realiza una ejecución en seco de una consulta de BigQuery

  • Valida la consulta y estima su tamaño de procesamiento

  • Comprueba el tamaño de la consulta frente al límite de 1 TB

• run_query_with_validation : ejecuta una consulta de BigQuery con validación

  • Detecta y rechaza sentencias DML (consultas de modificación de datos)

  • Rechaza el procesamiento de datos superiores a 1 TB

  • Ejecuta consultas que pasan la validación y devuelve resultados.

Desarrollo

Prerrequisitos

• Node.js (v16 o superior)

• Configuración de la autenticación de Google Cloud (gcloud CLI o cuenta de servicio)

Instalar dependencias

npm install

Construir

npm run build

Modo de desarrollo (reconstrucción automática)

npm run watch

Instalación

Para utilizar con Claude Desktop, agregue la configuración del servidor:

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

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

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. Recomendamos utilizar el Inspector MCP :

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Configuración de autenticación

Este servidor utiliza la autenticación de Google Cloud. Configure la autenticación utilizando uno de los siguientes métodos:

1. Iniciar sesión con gcloud CLI:

   gcloud auth application-default login

2. Utilice una clave de cuenta de servicio:

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

Ejemplos de uso

1. Ejecute una consulta en seco:

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

2. Ejecutar una consulta con validación:

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

Servidor MCP de análisis de BigQuery

descripción general

Un servidor MCP para ejecutar consultas SQL en BigQuery. Valida (dry run) y ejecuta consultas, y cuenta con funciones de seguridad que impiden el procesamiento y modificación de consultas de datos (DML) de más de 1TB.

función

Este servidor es un servidor MCP para ejecutar consultas SQL en Google BigQuery y ofrece las siguientes funciones:

• Validación de consultas (ejecución en seco): verifica si la consulta es válida y estima el tamaño del procesamiento

• Ejecución segura de consultas: solo ejecute consultas SELECT de 1 TB o menos (evite la modificación de datos)

• Devolver resultados en formato JSON: Devuelve los resultados de la consulta en JSON estructurado.

función

herramienta

• dry_run_query : ejecuta una ejecución en seco de una consulta de BigQuery

  • Validar consultas y estimar el tamaño del procesamiento

  • Comprobar el tamaño de la consulta frente al límite de 1 TB

• run_query_with_validation : ejecuta una consulta de BigQuery con validación

  • Detectar y rechazar sentencias DML (consultas de modificación de datos)

  • Negarse a procesar datos superiores a 1 TB

  • Ejecuta consultas que pasan la validación y devuelve los resultados.

Método de desarrollo

Prerrequisitos

• Node.js (v16 y superior)

• Configuración de autenticación de Google Cloud (gcloud CLI o cuenta de servicio)

Instalación de dependencias

npm install

Construir

npm run build

Modo de desarrollo (reconstrucción automática)

npm run watch

instalar

Para usarlo con Claude Desktop, agregue la configuración de su servidor:

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

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

depurar

Los servidores MCP se comunican a través de entrada/salida estándar (stdio) y pueden ser difíciles de depurar. Recomendamos utilizar MCP Inspector :

npm run inspector

Inspector proporciona una URL para acceder a las herramientas de depuración en su navegador.

Configuración de autenticación

Este servidor utiliza credenciales de Google Cloud. Configure la autenticación de una de las siguientes maneras:

1. Inicie sesión con gcloud CLI:

   gcloud auth application-default login

2. Utilice una clave de cuenta de servicio:

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

Ejemplo de uso

1. Ejecute la consulta en seco:

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

2. Ejecución de consulta con validación:

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