XRechnung Validator

io.github.wenboteng由 GitHub 帳號 wenboteng 發布v0.2.0更新於 Nov 4, 2026

Validate XRechnung XML and ZUGFeRD / Factur-X PDFs with the free checkxrechnung.com API.

已驗證STDIO僅桌面開發者工具商業與電商

概覽

AI 產生的概覽

透過免費的 checkxrechnung.com API 驗證 XRechnung XML 與 ZUGFeRD/Factur-X PDF 發票,並可擷取內嵌的發票 XML。

可以做什麼
  • 驗證 XRechnung XML 文件(UBL 或 CII)或 ZUGFeRD PDF,回傳 valid 以及含規則編號、嚴重程度、位置、說明、提示與規則連結的錯誤清單
  • 驗證 ZUGFeRD 或 Factur-X PDF,包含 PDF/A-3 基本檢查、設定檔辨識與 EN 16931 CII Schematron 檢查
  • 從 ZUGFeRD 或 Factur-X PDF 擷取內嵌的發票 XML 與 JSON 摘要
適用情境
適合在寄出前檢查德國電子發票檔案是否符合規範,或從混合式 PDF 取出發票 XML,不必離開助理即可完成。
執行需求
以 stdio 在本機執行,通常透過 npx 啟動 xrechnung-validator-mcp 套件(需要 Node.js)。不需帳號、API 金鑰或環境變數,但需能連線 checkxrechnung.com。免費額度:每個 IP 每個 UTC 日 50 次、每分鐘 10 次;XML 上限 5 MB,PDF 上限 10 MB。
安裝前請注意
發票檔案會上傳到第三方服務 checkxrechnung.com,等於發票內容離開本機;該服務聲明 persisted: false。這些工具是網路呼叫,並非本機唯讀檢查。額度由三個工具共用且依 IP 計算,批次使用容易觸頂。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 XRechnung Validator,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

xrechnung-validator-mcp

Stdio MCP server, package version 0.2.0. Tools:

  • validate_xrechnung uploads an XRechnung XML file (UBL or CII) or a ZUGFeRD PDF to POST https://checkxrechnung.com/v1/validate (file_path or xml).
  • validate_zugferd uploads a PDF to POST https://checkxrechnung.com/v1/zugferd/validate (file_path). PDF/A-3 check, profile, EN 16931 CII Schematron, rule_url.
  • extract_zugferd uploads a PDF to POST https://checkxrechnung.com/v1/zugferd/extract (file_path) and returns the raw XML plus a JSON summary.

The free limit is shared: 50 requests per IP per UTC day, 10 per minute. XML validation is 5 MB. The ZUGFeRD tools are 10 MB.

validate_xrechnung takes exactly one of file_path or xml. validate_zugferd and extract_zugferd take file_path only.

Validation output is valid plus errors[]. Each error has rule_id, severity, location, message, hint, and rule_url when a rule code is present. rule_url is the API value when the response includes rule_url or ruleUrl; otherwise https://checkxrechnung.com/fehler/<code> (lowercase). extract_zugferd returns ok, summary, and xml.

The service reports persisted: false. The tools call the network, so they are not a local read-only check. Batch volume: https://checkxrechnung.com/api-waitlist

Package name: xrechnung-validator-mcp. Registry name in server.json: io.github.wenboteng/xrechnung-validator (mcpName matches). Not submitted to the MCP registry yet. Build with npm run build (node dist/index.js) or, after publish, npx -y xrechnung-validator-mcp.

Claude Desktop

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

json
{  "mcpServers": {    "xrechnung-validator": {      "command": "npx",      "args": ["-y", "xrechnung-validator-mcp"]    }  }}

Cursor

~/.cursor/mcp.json or the project file .cursor/mcp.json:

json
{  "mcpServers": {    "xrechnung-validator": {      "command": "npx",      "args": ["-y", "xrechnung-validator-mcp"]    }  }}

From a checkout, before the npm publish:

json
{  "mcpServers": {    "xrechnung-validator": {      "command": "node",      "args": ["mcp/dist/index.js"]    }  }}

VS Code

.vscode/mcp.json:

json
{  "servers": {    "xrechnung-validator": {      "type": "stdio",      "command": "npx",      "args": ["-y", "xrechnung-validator-mcp"]    }  }}

Docs: https://checkxrechnung.com/en/docs · Rules: https://checkxrechnung.com/fehler/ · OpenAPI: https://checkxrechnung.com/openapi.json

MIT. Copyright (c) 2026 Bobook Limited.

來源:mcp/README.md,提交 e5cd738

工具

3

validate_xrechnung

Validate XRechnung

Validate one XRechnung XML document (UBL or CII) or ZUGFeRD PDF. The file is uploaded to the free keyless API POST https://checkxrechnung.com/v1/validate. Limits: 50 requests per IP per UTC day, 10 per minute, 5 MB. The service reports persisted: false. Provide exactly one of file_path or xml. Returns valid plus errors with rule_id and rule_url.

輸入參數xmlfile_path

validate_zugferd

Validate ZUGFeRD / Factur-X

Validate one ZUGFeRD or Factur-X PDF. The file is uploaded to POST https://checkxrechnung.com/v1/zugferd/validate. Checks PDF/A-3 basics (veraPDF when installed, otherwise a labelled structure check), extracts factur-x.xml, zugferd-invoice.xml or xrechnung.xml, detects the profile (MINIMUM, BASIC WL, BASIC, EN16931, EXTENDED, XRECHNUNG) and validates the XML with the EN 16931 CII Schematron. Profile XRECHNUNG also runs the XRechnung CII Schematron. Same free limit as validate_xrechnung (shared counter): 50 per IP per UTC day, 10 per minute. PDF limit 10 MB. Returns valid, profile, and errors with rule_id and rule_url.

輸入參數file_path必填

extract_zugferd

Extract ZUGFeRD / Factur-X XML

Extract the embedded invoice XML and a JSON summary from a ZUGFeRD or Factur-X PDF. Uploads the file to POST https://checkxrechnung.com/v1/zugferd/extract. Same free limit as validate_xrechnung (shared counter). PDF limit 10 MB. ok means an XML attachment was found. The xml field is the raw document.

輸入參數file_path必填

版本歷史

2
  1. v0.2.0最新Oct 20, 2026
  2. v0.1.0Oct 19, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分