Bauplan

mcp-bauplan

Un servidor MCP (Model Context Protocol) minimalista para interactuar con tablas de datos y ejecutar consultas de Bauplan.

Bauplan gestiona un almacén de datos de tablas Iceberg en S3.

Características

• Obtener las tablas de datos de Bauplan y sus esquemas en el namespace configurado
• Consultar tablas de datos de Bauplan usando SQL (solo SELECT)

Soporta tanto transportes SSE como STDIO.

Herramientas

El servidor implementa las siguientes herramientas para interactuar con las tablas de datos de Bauplan:

• list_tables:
  • Lista todas las tablas en el namespace configurado
• get_schema:
  • Obtiene el esquema de una tabla de datos
• run_query:
  • Ejecuta una consulta SELECT en la tabla especificada

Configuración

1. Crea o edita el archivo de configuración de Claude Desktop ubicado en:

   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • En Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Añade lo siguiente:

{
  "mcpServers": {
    "mcp-bauplan": {
      "command": "/path/to/uvx",
      "args": ["mcp-bauplan"],
      "env": {
        "BAUPLAN_API_KEY": "your-api-key",
        "BAUPLAN_BRANCH": "your-branch",
        "BAUPLAN_NAMESPACE": "your-namespace",
        // Optional
        "BAUPLAN_TIMEOUT": "query-timeout-secs" // default 30 seconds
      }
    }
  }
}

3. Reemplaza /path/to/uvx con la ruta absoluta al ejecutable uvx. Encuentra la ruta con el comando which uvx en una terminal. Esto asegura que se use la versión correcta de uvx al iniciar el servidor.

4. Reinicia Claude Desktop para aplicar los cambios.

Ejecutar el servidor SSE independiente

Crea un archivo .env a partir de .env.example y luego ejecuta el siguiente comando:

$ uvx --env-file /path/to/.env mcp-bauplan --transport sse --port 9090

Nota: el uso de nvx y no uvx obtendrá mcp-bauplan del registro predeterminado https://pypi.org.

Desarrollo Futuro

Desarrollo - trabajo en progreso

1. Documentación de Bauplan (SDK y Plataforma) como Recurso
2. Automatización de la Ejecución de Bauplan - más comandos y ejecutar un pipeline
3. Generación de Consultas
4. Generación de Código Usando Plantillas
5. Gobernanza de Datos y Cumplimiento
6. Pruebas y Validación
7. Ecosistema de Integración

Configuración

1. Requisitos previos:

   • Python 3.10 o superior.
   • Una clave API de Bauplan (solicítala aquí).
   • Administrador de paquetes uv (instalación).

2. Clona el repositorio:

git clone https://github.com/marcoeg/mcp-bauplan
cd mcp-nvd

3. Configura las variables de entorno:

   • Crea un archivo .env en la raíz del proyecto:

     BAUPLAN_API_KEY=your-api-key
     BAUPLAN_BRANCH=your-branch
     BAUPLAN_NAMESPACE=your-namespace
     

4. Instala las dependencias:

uv sync
uv pip install -e .

Ejecutar con el MCP Inspector

cd /path/to/the/repo
source .env

CLIENT_PORT=8077 SERVER_PORT=8078 npx @modelcontextprotocol/inspector \
     uv run mcp-bauplan

Nota: omite CLIENT_PORT=8077 SERVER_PORT=8078 si los puertos estándar no entran en conflicto.

Luego abre el navegador en la URL indicada por el MCP Inspector, típicamente http://localhost:8077?proxyPort=8078

Cambia libremente entre los tipos de transporte stdio y sse en el inspector. Para usar sse necesitas ejecutar el servidor como se explica a continuación.

Pruebas con el transporte SSE

Ejecutar el servidor:

cd /path/to/the/repo
source .env

uv run mcp-bauplan --transport sse --port 9090

• Se ejecuta con transporte SSE en el puerto 9090 por defecto.

Luego abre el navegador en la URL indicada por el MCP Inspector. Selecciona el Tipo de Transporte SSE.