ETL-D MCP Server 🌊

ETL-D — это детерминированное промежуточное ПО для данных, предназначенное для защиты ИИ-агентов. Оно предотвращает «галлюцинации» LLM над структурированными данными, предоставляя строгую трёхуровневую архитектуру парсинга через Model Context Protocol (MCP).

⚠️ Проблема: «Налог на данные» и галлюцинации

Стандартные LLM плохо справляются с чтением сырых B2B-файлов (CSV, PDF, EDI, Norma 43). Они страдают от:

1. Истощения токенов: Отправка CSV с 5000 строк в контекст — это пустая трата денег.

2. Потери точности: LLM испытывают трудности с пространственным выравниванием. Неправильно поставленная запятая в банковской выписке — финансовая катастрофа.

3. Недетерминизма: Нельзя построить надёжный конвейер, если выходной формат зависит от «настроения» LLM.

Related MCP server: document-parser

✅ Решение: трёхуровневая каскадная архитектура

Движок ETL-D обрабатывает каждый запрос через строгую иерархию:

• Уровень 1 (эвристический): 100% детерминированные парсеры на Python. 0% риска галлюцинаций. Задержка ~70 мс.

• Уровень 2 (семантический): Сопоставление столбцов со схемой с помощью маршрутизации на основе эмбеддингов.

• Уровень 3 (LLM-щит): Строгое соблюдение JSON с использованием Llama 3.3 70B и ограничений additionalProperties: false для высокоэнтропийного шума.

🚀 Быстрый старт (Claude Desktop)

1. Откройте ваш claude_desktop_config.json.

2. Добавьте сервер ETL-D (убедитесь, что используете версию 3.3.3):

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

🔑 Как получить API-ключ?

• Вариант A: Ручная покупка (человек) Получите стартовый набор ($5 / 5000 кредитов) или подписку на api.etl-d.net.

• Вариант B: Автоматическое предоставление без участия человека (под руководством агента) 🤖 Если у вас нет ключа, просто спросите Claude: «У меня нет ключа ETL-D, можете помочь его получить?». Агент вызовет инструмент /provision, сгенерирует для вас ссылку на Stripe Checkout и автоматически настроит ключ после оплаты. Без участия человека, с контролем со стороны человека.

🛠️ Доступные MCP-инструменты

1. Тяжёлая работа с финансами и B2B parse_bank_statement: Поддержка испанского формата Norma 43 (N43). Преобразует сырые банковские файлы в чистый JSON.

parse_trade_history: Детерминированное извлечение сделок, комиссий и дивидендов из сложных экспортов брокеров.

parse_edi: Парсер ANSI X12 EDI (оптимизирован для заказов на покупку 850).

generate_sepa_xml: Генератор XML из JSON в формат PAIN.008 (прямое дебетование).

2. Интеллектуальная обработка документов pdf_to_spatial_markdown: Критически важно для агентов. Преобразует PDF в Markdown с сохранением структуры таблиц до того, как LLM их прочитает.

extract_invoice / extract_resume: Извлечение схемы с высокой точностью для стандартных B2B-документов.

3. Атомарное обогащение (1 кредит за вызов) enrich_amount: Очищает «Итого: 1.240,50€» в {amount: 1240.50, currency: "EUR"}.

enrich_date: Разрешает человекочитаемые даты («в следующую пятницу в 17:00») с учётом часового пояса.

enrich_address: Стандартизирует неструктурированные адреса по всему миру в структурированные компоненты.

accounting_map: Сопоставляет понятия с испанским PGC, US GAAP или IFRS.

🏗️ Экосистема

Облачный движок: размещён на api.etl-d.net (Python/FastAPI).

Python SDK: pip install etld.

Узлы n8n: доступны в сообществе n8n как n8n-nodes-etld.

⚖️ Лицензия

MIT — создано Pablixnieto2