ETL-D MCP Server 🌊

ETL-D es un middleware de datos determinista diseñado para actuar como un escudo para los Agentes de IA. Evita que los LLM "alucinen" sobre datos estructurados al proporcionar una arquitectura de análisis estricta de 3 capas a través del Protocolo de Contexto de Modelo (MCP).

⚠️ El Problema: El "Impuesto de Datos" y las Alucinaciones

Los LLM estándar son terribles leyendo archivos B2B sin procesar (CSV, PDF, EDI, Norma 43). Sufren de:

1. Agotamiento de Tokens: Enviar un CSV de 5,000 filas al contexto es un desperdicio de dinero.

2. Pérdida de Precisión: Los LLM luchan con la alineación espacial. Una coma mal colocada en un extracto bancario es una catástrofe financiera.

3. No Determinismo: No puedes construir un pipeline confiable si el formato de salida depende del "estado de ánimo" del LLM.

Related MCP server: document-parser

✅ La Solución: Arquitectura de Cascada de 3 Capas

El motor ETL-D procesa cada solicitud a través de una jerarquía estricta:

• Capa 1 (Heurística): Analizadores deterministas 100% nativos de Python. 0% de riesgo de alucinación. ~70ms de latencia.

• Capa 2 (Semántica): Alineación de columna a esquema mediante enrutamiento basado en incrustaciones.

• Capa 3 (Escudo LLM): Aplicación estricta de JSON usando Llama 3.3 70B con restricciones additionalProperties: false para ruido de alta entropía.

🚀 Inicio Rápido (Claude Desktop)

1. Abre tu claude_desktop_config.json.

2. Agrega el servidor ETL-D (Asegúrate de usar la versión 3.3.3):

{
  "mcpServers": {
    "etld": {
      "command": "npx",
      "args": [
        "-y",
        "@pablixnieto2/etld-mcp-server@3.3.3"
      ],
      "env": {
        "ETLD_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

🔑 ¿Cómo Obtener una Clave API?

• Opción A: Compra Manual (Humano) Obtén un Paquete de Inicio ($5 / 5,000 créditos) o una Suscripción en api.etl-d.net.

• Opción B: Aprovisionamiento Sin Toque (Liderado por Agente) 🤖 Si no tienes una clave, simplemente pregunta a Claude: "No tengo una clave ETL-D, ¿puedes ayudarme a obtener una?". El agente llamará a la herramienta /provision, generará un enlace de Stripe Checkout para ti, y configurará automáticamente la clave una vez pagada. Sin toque, con humano en el bucle.

🛠️ Herramientas MCP Disponibles

1. Trabajo Pesado Financiero y B2B parse_bank_statement: Soporte para Norma 43 española (N43). Convierte archivos bancarios sin procesar en JSON limpio.

parse_trade_history: Extracción determinista de operaciones, comisiones y dividendos de exportaciones complejas de corredores.

parse_edi: Analizador EDI ANSI X12 (Optimizado para Órdenes de Compra 850).

generate_sepa_xml: Generador de XML de JSON a PAIN.008 (Débito Directo).

2. Inteligencia Documental pdf_to_spatial_markdown: Crucial para Agentes. Convierte PDFs a Markdown preservando las estructuras de tablas antes de que el LLM las lea.

extract_invoice / extract_resume: Extracción de esquemas de alta precisión para documentos B2B estándar.

3. Enriquecimiento Atómico (1 Crédito/llamada) enrich_amount: Limpia "Total: 1.240,50€" en {amount: 1240.50, currency: "EUR"}.

enrich_date: Resuelve fechas legibles por humanos ("el próximo viernes a las 5pm") con conocimiento de zona horaria.

enrich_address: Estandariza direcciones globales desordenadas en componentes estructurados.

accounting_map: Mapea conceptos a ES PGC, US GAAP o IFRS.

🏗️ Ecosistema

Motor en la Nube: Alojado en api.etl-d.net (Python/FastAPI).

SDK de Python: pip install etld.

Nodos n8n: Disponibles en la comunidad n8n como n8n-nodes-etld.

⚖️ Licencia

MIT - Creado por Pablixnieto2