ETL-D MCP Server 🌊

ETL-D ist eine deterministische Daten-Middleware, die als Schutzschild für KI-Agenten dient. Sie verhindert, dass LLMs über strukturierten Daten „halluzinieren", indem sie eine strenge 3-Schichten-Parsing-Architektur über das Model Context Protocol (MCP) bereitstellt.

⚠️ Das Problem: Die „Datensteuer" & Halluzinationen

Standard-LLMs sind schlecht darin, rohe B2B-Dateien (CSV, PDF, EDI, Norma 43) zu lesen. Sie leiden unter:

1. Token-Erschöpfung: Eine CSV mit 5.000 Zeilen in den Kontext zu senden, ist Geldverschwendung.

2. Präzisionsverlust: LLMs kämpfen mit räumlicher Ausrichtung. Ein falsch platziertes Komma in einem Kontoauszug ist eine finanzielle Katastrophe.

3. Nicht-Determinismus: Man kann keine zuverlässige Pipeline aufbauen, wenn das Ausgabeformat von der „Stimmung" des LLM abhängt.

Related MCP server: document-parser

✅ Die Lösung: 3-Schichten-Wasserfall-Architektur

Die ETL-D-Engine verarbeitet jede Anfrage durch eine strenge Hierarchie:

• Schicht 1 (Heuristisch): 100% Python-native deterministische Parser. 0% Halluzinationsrisiko. ~70 ms Latenz.

• Schicht 2 (Semantisch): Spalten-zu-Schema-Abgleich mittels embedding-basiertem Routing.

• Schicht 3 (LLM-Schutzschild): Strikte JSON-Erzwingung mit Llama 3.3 70B und additionalProperties: false-Constraints für Rauschen mit hoher Entropie.

🚀 Schnellstart (Claude Desktop)

1. Öffnen Sie Ihre claude_desktop_config.json.

2. Fügen Sie den ETL-D-Server hinzu (Stellen Sie sicher, dass Sie Version 3.3.3 verwenden):

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

🔑 Wie erhalte ich einen API-Schlüssel?

• Option A: Manueller Kauf (Mensch) Holen Sie sich ein Starter-Paket (5 $ / 5.000 Credits) oder ein Abonnement unter api.etl-d.net.

• Option B: Zero-Touch-Bereitstellung (Agenten-geführt) 🤖 Wenn Sie keinen Schlüssel haben, fragen Sie einfach Claude: „Ich habe keinen ETL-D-Schlüssel, können Sie mir helfen, einen zu bekommen?". Der Agent ruft das /provision-Tool auf, generiert einen Stripe Checkout-Link für Sie und richtet den Schlüssel nach der Zahlung automatisch ein. Zero-Touch, Human-in-the-Loop.

🛠️ Verfügbare MCP-Tools

1. Finanz- und B2B-Schwerlast parse_bank_statement: Unterstützung für spanische Norma 43 (N43). Wandelt rohe Bankdateien in sauberes JSON um.

parse_trade_history: Deterministische Extraktion von Trades, Gebühren und Dividenden aus komplexen Broker-Exporten.

parse_edi: ANSI X12 EDI-Parser (optimiert für 850 Bestellungen).

generate_sepa_xml: JSON-zu-PAIN.008 (Lastschrift) XML-Generator.

2. Dokumenten-Intelligenz pdf_to_spatial_markdown: Entscheidend für Agenten. Konvertiert PDFs in Markdown unter Beibehaltung von Tabellenstrukturen, bevor das LLM sie liest.

extract_invoice / extract_resume: Hochpräzise Schema-Extraktion für Standard-B2B-Dokumente.

3. Atomare Anreicherung (1 Credit/Aufruf) enrich_amount: Bereinigt „Total: 1.240,50€" zu {amount: 1240.50, currency: "EUR"}.

enrich_date: Löst menschenlesbare Daten („nächsten Freitag um 17 Uhr") mit Zeitzonen-Bewusstsein auf.

enrich_address: Standardisiert weltweit unübersichtliche Adressen in strukturierte Komponenten.

accounting_map: Ordnet Konzepte dem spanischen PGC, US-GAAP oder IFRS zu.

🏗️ Ökosystem

Cloud-Engine: Gehostet unter api.etl-d.net (Python/FastAPI).

Python-SDK: pip install etld.

n8n-Nodes: Verfügbar in der n8n-Community als n8n-nodes-etld.

⚖️ Lizenz

MIT - Erstellt von Pablixnieto2