
Mcp Einvoicing De
io.github.cmendezs由 GitHub 帳號 cmendezs 發布v0.11.4更新於 Oct 24, 2026
German e-invoicing MCP server: ZUGFeRD 2.x, XRechnung 3.x, EN 16931, KoSIT validation, Peppol.
概覽
面向德國電子發票的本機 Python MCP 伺服器:建立、驗證、解析與轉換 ZUGFeRD 2.x 與 XRechnung 3.x 發票,並提供 Peppol 查詢與傳送。
- 可以做什麼
- 建立 ZUGFeRD 或 XRechnung 發票,輸出 CII 或 UBL XML,或 PDF/A-3 混合式 PDF,並執行德國 B2B 強制規定檢查,可為 DE 加值稅買方選擇過渡期豁免。依 EN 16931 與 KoSIT BR-DE 規則驗證發票,預設在本機驗證,啟用後可改用 KoSIT 雲端驗證。從 ZUGFeRD/XRechnung XML 或混合式 PDF 解析結構化資料,並在 ZUGFeRD 設定檔、CII 標頭及 CII/UBL 語法之間轉換。將發票匯出為 DATEV EXTF 700 記帳 CSV,並查詢德國加值稅規則,例如反向課稅與小型企業門檻。查詢 Peppol 參與者、服務端點與 Peppol 目錄,解析 SML DNS,透過 AS4 傳送發票,並核對 OpenPeppol 與 EN 16931 代碼表。
- 適用情境
- 適合需要產生或檢查符合 2025 年德國 B2B 強制規定、EN 16931 或 Peppol BIS 的德國與歐洲電子發票,也適合從 XML 或混合式 PDF 擷取發票資料交給會計處理。
- 執行需求
- 需在本機安裝 Python 套件(pip)或以 uvx 執行;不需要憑證。選用擴充:xslt2 用於本機 Schematron 驗證與報告工具,pdf 或 pymupdf 用於 PDF 工具。選用環境變數:EINVOICING_DE_KOSIT_ENABLE、EINVOICING_DE_KOSIT_VALIDATOR_URL、EINVOICING_DE_LOG_LEVEL、EINVOICING_PEPPOL_CODELIST_DIR、EINVOICING_EN16931_CODELIST_DIR。Peppol 與雲端驗證需要網路存取。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Mcp Einvoicing De,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
mcp-einvoicing-de 🇩🇪
[License] [PyPI version] [Python] [mcp-einvoicing-de MCP server]
MCP server (Model Context Protocol) in Python for German electronic invoicing in ZUGFeRD 2.x and XRechnung 3.x formats (EN 16931, FeRD, KoSIT). Enables AI agents (Claude, IDEs) to create, validate, parse, and convert e-invoices that are fully compliant with the German B2B e-invoicing mandate (effective from 2025, phased enforcement through 2027 to 2028) and the European standard EN 16931.
Introduction
This package is built on mcp-einvoicing-core, a shared base library for European e-invoicing MCP servers. It provides shared models, validation abstractions, XML utilities, and the exception hierarchy.
mcp-einvoicing-core is automatically installed as a transitive dependency, no additional step required.
For developers:
pip install -e ".[dev]"installs the base package automatically from PyPI.
Installation
Via PyPI (recommended)
Without prior installation, using uvx:
From source
Optional extras
Configuration
The server does not require external credentials. Available environment variables:
The EUSR/TSR reporting and MLS tools additionally require the [xslt2] extra for Schematron validation.
Claude Desktop integration
Add the following entry to claude_desktop_config.json. No environment variables are required:
Cursor integration
Cursor supports MCP servers via stdio. Add the configuration in:
- Global (all projects):
~/.cursor/mcp.json - Project (this repository only):
.cursor/mcp.json
Reload the Cursor window (Ctrl+Shift+P then Reload Window) to apply the changes.
Kiro integration
Kiro supports MCP servers via its dedicated configuration file. Two levels are available:
- Global (all projects):
~/.kiro/settings/mcp.json - Workspace (this repository only):
.kiro/settings/mcp.json
The file is automatically reloaded on save. You can also open the config via the command palette (Cmd+Shift+P / Ctrl+Shift+P) then MCP.
Available tools
Peppol network tools
Peppol participant lookup, service-endpoint lookup, a DNS-only diagnostic, AS4 send, Peppol Directory search, and the OpenPeppol eDEC codelist tools are provided by the shared core Peppol tool plugin (mcp_einvoicing_core.peppol.tools.register_peppol_tools), mounted in server.py with a German-specific identifier adapter: a bare USt-IdNr (e.g. 123456789 or DE123456789) is normalized to the 9930:<value> Peppol scheme (DE:VAT); an already scheme-qualified identifier (e.g. 9930:DE123456789, or 0204:<leitweg-id> for Leitweg-ID-routed B2G invoices) passes through unchanged. To send via AS4, first produce XRechnung UBL with invoice_convert (or invoice_create with target_syntax='UBL'), then pass the result to peppol_send.
peppol_send signs outbound messages with a real wsse:Security signature as of mcp-einvoicing-core v1.20.0 (previously computed and discarded — see CHANGELOG.md v0.10.0).
See the mcp-einvoicing-core README for full parameter documentation on these tools.
Peppol reporting and status tools
Added in v0.10.0 via three opt-in core plugins, mounted unconditionally in server.py. Each raises a clear error at call time (not at registration) if its extra or data directory is missing.
See the mcp-einvoicing-core README for full parameter documentation on these tools.
Usage examples
Example 1: Validate an invoice
Example 2: Query German tax rules
Example 3: Check Peppol registration
Example 4: Parse invoice data
Architecture
Vendor neutrality
This server implements the standard itself: it builds, validates, and signs the document locally. It is not a client for a commercial invoicing platform, and your signing keys and credentials never leave your own infrastructure.
A Peppol access point is optional: transmission via peppol_send is one available channel,
and any accredited access point speaks the same AS4 profile, so switching providers is a
configuration change, not a code change. This package does not implement direct submission to
a German B2G state portal (ZRE/OZG-RE).
Supported standards
Note: ZUGFeRD 2.x and XRechnung 3.x share the same CII XML syntax at the EN 16931 profile level. Conversion between both formats is therefore possible without data loss. The EXTENDED profile is specific to ZUGFeRD and has no XRechnung equivalent.
Tests
Contributing
Contributions are welcome. Please open an issue before submitting a pull request for significant changes.
Other e-invoicing MCP servers
License
This project is licensed under the Apache 2.0 License. See the LICENSE file for details. For the full version history, see CHANGELOG.md.
來源:README.md,提交 a77e33d
工具
0版本歷史
1- v0.11.4最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分