BigQuery Analysis MCP Server

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

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

Construir

Modo de desarrollo (reconstrucción automática)

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

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 :

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

Construir

Modo de desarrollo (reconstrucción automática)

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

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 :

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