etld-mcp-server

ETL-D MCP 服务 🌊

ETL-D 是一款确定性数据中间件，旨在为 AI Agent 提供保护屏障。它通过 Model Context Protocol（MCP）提供严格的三层解析架构，防止大模型在处理结构化数据时产生“幻觉”。

⚠️ 问题：“数据税”与幻觉

标准大模型不擅长读取原始 B2B 文件（CSV、PDF、EDI、Norma 43），面临以下问题：

1. Token 耗尽： 将包含 5,000 行的 CSV 发送到上下文中会浪费资金。
2. 精度损失： 大模型难以处理空间对齐问题。银行对账单中一个逗号错位，就可能酿成金融灾难。
3. 非确定性： 如果输出格式取决于大模型的“心情”，就无法构建可靠的流水线。

✅ 解决方案：三层瀑布式架构

ETL-D 引擎会按照严格的层级处理每个请求：

• 第 1 层（启发式）： 100% 使用 Python 原生确定性解析器。幻觉风险为 0%。延迟约 70 毫秒。
• 第 2 层（语义）： 使用基于嵌入的路由，实现列与架构之间的对齐。
• 第 3 层（大模型防护）： 使用 Llama 3.3 70B 严格约束 JSON，并通过 additionalProperties: false 处理高熵噪声。

---

🚀 快速开始（Claude Desktop）

1. 打开 claude_desktop_config.json。
2. 添加 ETL-D 服务（确保使用版本 3.3.3）：

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

🔑 如何获取 API 密钥？

• 选项 A： 手动购买（人工） 在 api.etl-d.net 购买入门包（$5 / 5,000 个额度）或订阅。

• 选项 B： 零接触配置（Agent 主导）🤖 如果你没有密钥，只需向 Claude 提问：“我没有 ETL-D 密钥，你能帮我获取一个吗？” Agent 会调用 /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：对 Agent 至关重要。在大模型读取 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 创建