ETL-D MCP 서버 🌊

ETL-D는 AI 에이전트를 위한 방패 역할을 하도록 설계된 결정론적 데이터 미들웨어입니다. Model Context Protocol(MCP)을 통해 엄격한 3계층 파싱 아키텍처를 제공하여 LLM이 구조화된 데이터에 대해 "환각"을 일으키는 것을 방지합니다.

⚠️ 문제: "데이터 세금" 및 환각

표준 LLM은 원시 B2B 파일(CSV, PDF, EDI, Norma 43)을 읽는 데 매우 취약합니다. 다음과 같은 문제가 있습니다:

1. 토큰 소진: 5,000행 CSV를 컨텍스트에 보내는 것은 비용 낭비입니다.

2. 정밀도 손실: LLM은 공간 정렬에 어려움을 겪습니다. 은행 거래 내역에서 쉼표 하나가 잘못 배치되면 재정적 재앙이 됩니다.

3. 비결정성: 출력 형식이 LLM의 "기분"에 따라 달라진다면 안정적인 파이프라인을 구축할 수 없습니다.

Related MCP server: document-parser

✅ 해결책: 3계층 폭포 아키텍처

ETL-D 엔진은 모든 요청을 엄격한 계층 구조로 처리합니다:

• 계층 1 (휴리스틱): 100% Python 네이티브 결정론적 파서. 환각 위험 0%. 약 70ms 지연 시간.

• 계층 2 (의미론적): 임베딩 기반 라우팅을 사용한 열-스키마 정렬.

• 계층 3 (LLM 방패): 높은 엔트로피 노이즈에 대해 additionalProperties: false 제약 조건을 사용하는 Llama 3.3 70B를 통한 엄격한 JSON 강제.

🚀 빠른 시작 (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: 수동 구매 (인간) api.etl-d.net에서 스타터 팩($5 / 5,000 크레딧) 또는 구독을 구매하세요.

• 옵션 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: JSON을 PAIN.008 (직접 차변) XML 생성기로 변환합니다.

2. 문서 인텔리전스 pdf_to_spatial_markdown: 에이전트에게 중요합니다. LLM이 읽기 전에 테이블 구조를 보존하면서 PDF를 Markdown으로 변환합니다.

extract_invoice / extract_resume: 표준 B2B 문서에 대한 고정밀 스키마 추출.

3. 원자적 강화 (1 크레딧/호출) enrich_amount: "Total: 1.240,50€"를 {amount: 1240.50, currency: "EUR"}로 정리합니다.

enrich_date: 시간대 인식을 통해 사람이 읽을 수 있는 날짜("다음 금요일 오후 5시")를 해석합니다.

enrich_address: 전 세계의 지저분한 주소를 구조화된 구성 요소로 표준화합니다.

accounting_map: 개념을 ES PGC, US GAAP 또는 IFRS에 매핑합니다.

🏗️ 생태계

클라우드 엔진: api.etl-d.net에서 호스팅 (Python/FastAPI).

Python SDK: pip install etld.

n8n 노드: n8n 커뮤니티에서 n8n-nodes-etld로 사용 가능.

⚖️ 라이선스

MIT - Pablixnieto2 제작.