mcp-server-erechnung

German E-Rechnung MCP Server (mcp-server-erechnung)

ドイツのB2B・B2G電子請求書コンプライアンス（EN 16931 / Wachstumschancengesetz 2025–2027、KoSIT XRechnung 3.0.2、DATEV ZUGFeRD 2.5 / Factur-X PDF/A-3b、SEPA GiroCode QR、スマートハイブリッド解析）に対応する公式の**Model Context Protocol（MCP）**サーバーです。

Claude Desktop、Claude Code、Cursor、Windsurf、Cline、またはn8n AI Agentsを接続して、ドイツの電子請求書を決定論的に生成し、公式のKoSIT/veraPDF検証を実行し、保護機能付きの受領義務解析を行えます。税額や金額の項目で、LLMによる検出されない幻覚は発生しません。

---

このMCP サーバーを選ぶ理由

• 100％決定論的な財務計算（BigDecimal + ISO 13616 MOD-97）： AI エージェントが生のXMLを生成したり、請求書の最終計算を行ったりすることはありません。すべてのqty * unitPriceNet、VAT区分、grossTotalは、正確な10進演算で決定論的に計算され、すべての販売者IBANはModulo-97で検証されます。
• 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）**決済コードを付与します。
• 開発者向けのスマートなDX： 人間向けの単位（"Stk"、"Std"、"Tage"、"pauschal"、"kg"、"kWh"）をUN/ECE Rec 20コード（C62、HUR、DAY、LS、KGM、KWH）に自動マッピングし、0% VATカテゴリー（AE § 13b リバースチャージ、K § 6a EU域内取引、E § 19 UStG、G 輸出）を自動推定します。ドイツ語の免税文言BT-120も必須です。
• 100％ステートレスでGDPR / DSGVOに準拠： 請求書の永続化やPIIのログ記録は一切ありません。

---

利用可能なMCP ツール

ツール名	説明
generate_erechnung	構造化JSONから、視覚的なDIN 5008レイアウト、GiroCode QR、factur-x.xmlを含むZUGFeRD 2.5 PDF/A-3b、または純粋なXRechnung 3.0.2 XMLを決定論的に生成します（<300ms）。
validate_erechnung	任意のZUGFeRD PDFまたはXRechnung XMLを、公式のEN 16931 XSD、KoSIT XR_30 Schematron、veraPDFに照らして検証します（rule_id、field、human_hint）。
parse_erechnung	スマートなハイブリッド受領義務パーサーです。最初に決定論的なNATIVE_XML高速パス（~20ms）を実行し、さらに計算を検証するレガシーPDF抽出（math_verified、iban_valid、discrepancy）にも対応します。
embed_zugferd_pdf	既存のビジュアルPDF（Base64）とJSONを、真正なPDF/A-3b ZUGFeRD 2.5ハイブリッド文書に変換します。
magic_convert_pdf	フラットなレガシーPDF（Base64、最大5ページ）を、厳格なBigDecimalおよびMOD-97のガードレールのもとでZUGFeRD 2.5 PDF/A-3bに変換します。

---

クイックスタート

1. APIキーを取得する（無料プランあり）

RapidAPI HubでGerman E-Rechnung ZUGFeRD & XRechnung APIを購読します： https://rapidapi.com/flamegoalhunter/api/german-e-rechnung-zugferd-and-xrechnung

2. オプションA — Claude Desktop / Cursor / Windsurf向けのローカルnpx（stdio）

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
• ヘッダー：
  • X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
  • X-RapidAPI-Host: german-e-rechnung-zugferd-and-xrechnung.p.rapidapi.com

---

ライセンス

MIT © FGH Studio