Configuracion del MCP Server

DataSpoc expone MCP (Model Context Protocol) servers tanto para Lens como para Pipe. Esto permite a los asistentes de IA descubrir tablas, ejecutar consultas, gestionar pipelines y mas --- directamente desde la conversacion.

Lens MCP Server

Instalar

pip install dataspoc-lens[mcp]

Ejecutar

dataspoc-lens mcp

Configuracion de Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "dataspoc-lens": {
      "command": "dataspoc-lens",
      "args": ["mcp"],
      "env": {
        "DATASPOC_BUCKET": "s3://my-data"
      }
    }
  }
}

Herramientas Disponibles

Herramienta	Descripcion
list_tables	Lista todas las tablas en el data lake
describe_table	Obtiene esquema, conteo de filas y particiones de una tabla
query	Ejecuta una consulta SQL y retorna resultados
ask	Hace una pregunta en lenguaje natural sobre los datos
cache_status	Muestra frescura y tamano del cache
cache_refresh	Actualiza todos los datos cacheados desde el bucket
cache_refresh_stale	Actualiza solo las tablas con cache desactualizado

Recursos Disponibles

Recurso	Descripcion
lens://tables	Catalogo completo de tablas con esquemas y metadatos

Pipe MCP Server

Instalar

pip install dataspoc-pipe[mcp]

Ejecutar

dataspoc-pipe mcp

Configuracion de Claude Desktop

{
  "mcpServers": {
    "dataspoc-pipe": {
      "command": "dataspoc-pipe",
      "args": ["mcp"],
      "env": {
        "DATASPOC_BUCKET": "s3://my-data"
      }
    }
  }
}

Herramientas Disponibles

Herramienta	Descripcion
list_pipelines	Lista todos los pipelines configurados
pipeline_config	Ver configuracion de un pipeline
run_pipeline	Ejecutar un pipeline
pipeline_status	Verificar estado de ejecucion y ultima sincronizacion
pipeline_logs	Ver logs de ejecucion
show_manifest	Leer el manifiesto del bucket
validate_pipeline	Validar la configuracion del pipeline

Recursos Disponibles

Recurso	Descripcion
pipe://pipelines	Catalogo completo de pipelines con configuraciones

Usar Ambos Servers Juntos

Puedes ejecutar ambos MCP servers simultaneamente. Agrega ambos a tu configuracion de Claude Desktop:

{
  "mcpServers": {
    "dataspoc-lens": {
      "command": "dataspoc-lens",
      "args": ["mcp"],
      "env": {
        "DATASPOC_BUCKET": "s3://my-data"
      }
    },
    "dataspoc-pipe": {
      "command": "dataspoc-pipe",
      "args": ["mcp"],
      "env": {
        "DATASPOC_BUCKET": "s3://my-data"
      }
    }
  }
}

Esto le da al agente control total: ingestar datos nuevos con Pipe, luego consultarlos con Lens --- todo desde una sola conversacion.

Cursor y Windsurf

Tanto Cursor como Windsurf soportan MCP servers. Agrega la misma configuracion a sus respectivos archivos de settings. Consulta la documentacion de Cursor o Windsurf para la ubicacion exacta del archivo de configuracion.