mcp-server-erechnung

德国电子发票 MCP 服务（mcp-server-erechnung）

用于德国 B2B 和 B2G 电子发票合规的官方 Model Context Protocol（MCP） 服务（EN 16931 / Wachstumschancengesetz 2025–2027、KoSIT XRechnung 3.0.2、DATEV ZUGFeRD 2.5 / Factur-X PDF/A-3b、SEPA GiroCode QR 和 Smart Hybrid Parsing）。

将 Claude Desktop、Claude Code、Cursor、Windsurf、Cline 或 n8n AI Agents 接入确定性的德国电子发票生成、KoSIT/veraPDF 官方验证和带防护的 Empfangspflicht 解析——税务或金额字段中绝无静默的 LLM 幻觉。

---

为什么使用此 MCP 服务？

• 100% 确定性的财务计算（BigDecimal + ISO 13616 MOD-97）： 您的 AI Agent 永远不会生成原始 XML，也不会计算最终发票金额。每项 qty * unitPriceNet、VAT 分类金额和 grossTotal 都使用精确十进制算术进行确定性计算，并通过 Modulo-97 验证每个 Seller IBAN。
• 符合 DATEV 和 KoSIT XRechnung 3.0 标准（BR-DE-* + veraPDF）： 强制执行德国业务规则（SellerContact、Leitweg-ID / BT-10、SEPA BG-16），嵌入 TrueType 字体和 sRGB ICC 配置文件（ISO 19005-3 PDF/A-3b），并添加可扫描的德国**GiroCode（EPC SEPA QR）**付款码。
• 智能开发者体验： 自动将常见单位（"Stk"、"Std"、"Tage"、"pauschal"、"kg"、"kWh"）映射到 UN/ECE Rec 20 代码（C62、HUR、DAY、LS、KGM、KWH），并自动推断 0% VAT 类别（AE § 13b Reverse Charge、K § 6a Intra-EU、E § 19 UStG、G Export），同时提供必需的 BT-120 德语免税说明。
• 100% 无状态且符合 GDPR / DSGVO 要求： 不保存发票，也不记录 PII。

---

可用的 MCP 工具

工具名称	描述
generate_erechnung	根据结构化 JSON 确定性地生成 ZUGFeRD 2.5 PDF/A-3b（包含 DIN 5008 视觉排版、GiroCode QR 和 factur-x.xml）或纯 XRechnung 3.0.2 XML（<300ms）。
validate_erechnung	根据官方 EN 16931 XSD、KoSIT XR_30 Schematron 和 veraPDF 验证任意 ZUGFeRD PDF 或 XRechnung XML（rule_id、field、human_hint）。
parse_erechnung	智能混合式 Empfangspflicht 解析器：首先通过确定性的 NATIVE_XML 快速路径在 ~20ms 内完成解析，同时支持经过数学校验的旧版 PDF 提取（math_verified、iban_valid、discrepancy）。
embed_zugferd_pdf	将现有视觉 PDF（Base64）和 JSON 升级为真正的 PDF/A-3b ZUGFeRD 2.5 混合文档。
magic_convert_pdf	在严格的 BigDecimal 和 MOD-97 防护措施下，将扁平旧版 PDF（Base64，最多 5 页）转换为 ZUGFeRD 2.5 PDF/A-3b。

---

快速开始

1. 获取 API Key（提供免费套餐）

在 RapidAPI Hub 上订阅 German E-Rechnung ZUGFeRD & XRechnung API： https://rapidapi.com/flamegoalhunter/api/german-e-rechnung-zugferd-and-xrechnung

2. 选项 A — 本地 npx（stdio），用于 Claude Desktop / Cursor / Windsurf

添加到您的 claude_desktop_config.json 或 .cursor/mcp.json：

{
  "mcpServers": {
    "german-erechnung": {
      "command": "npx",
      "args": ["-y", "mcp-server-erechnung"],
      "env": {
        "ERECHNUNG_RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY"
      }
    }
  }
}

3. 选项 B — 免安装远程 Streamable HTTP MCP

无需 npx，即可将任意 Streamable HTTP MCP 客户端直接接入：

• URL： https://german-e-rechnung-zugferd-and-xrechnung.p.rapidapi.com/api/v1/mcp
• Headers：
  • X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
  • X-RapidAPI-Host: german-e-rechnung-zugferd-and-xrechnung.p.rapidapi.com

---

许可证

MIT © FGH Studio