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 分