XRechnung Validator

Name: XRechnung Validator
Author: wenboteng

本地服务

checkxrechnung.com金融数据01 周前更新

代码仓库访问官网

关于 XRechnung Validator

XRechnung Validator 是通过 checkxrechnung.com API 校验电子发票的 stdio MCP 服务，面向处理 XRechnung XML 和 ZUGFeRD PDF 的用户。它还可从 PDF 提取原始 XML 和摘要，并返回带规则信息的错误。

主要功能

01校验 XRechnung XML 和 ZUGFeRD PDF
02单独校验 ZUGFeRD PDF
03提取 PDF 中的 XML 与摘要
04返回错误位置、严重性和规则提示

适用场景

01检查 UBL 或 CII 格式的 XRechnung 文件
02验证 ZUGFeRD PDF 的 PDF/A-3 与规范
03提取 PDF 内嵌 XML 供后续处理

MCP 相关

提供三个 MCP 工具，分别用于发票校验、ZUGFeRD 校验和 XML 提取。工具通过网络调用 checkxrechnung.com API，服务标记结果为未持久化。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y xrechnung-validator-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmxrechnung-validator-mcp0.2.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
xml	string	否	作为字符串提供的 XRechnung XML（UBL 或 CII）。使用此参数或 file_path。
file_path	string	否	XRechnung XML 文件或 ZUGFeRD PDF 的路径。由此进程解析。

详细介绍

xrechnung-validator-mcp

Stdio MCP 服务，软件包版本 0.2.0。工具：

validate_xrechnung 将 XRechnung XML 文件（UBL 或 CII）或 ZUGFeRD PDF 上传至 POST https://checkxrechnung.com/v1/validate（file_path 或 xml）。
validate_zugferd 将 PDF 上传至 POST https://checkxrechnung.com/v1/zugferd/validate（file_path）。检查 PDF/A-3、配置文件、EN 16931 CII Schematron 和 rule_url。
extract_zugferd 将 PDF 上传至 POST https://checkxrechnung.com/v1/zugferd/extract（file_path），并返回原始 XML 和 JSON 摘要。

免费额度共享：每个 IP 每个 UTC 日 50 次请求，每分钟 10 次。XML 验证的文件大小上限为 5 MB。ZUGFeRD 工具的文件大小上限为 10 MB。

validate_xrechnung 必须且只能接收 file_path 或 xml 其中之一。validate_zugferd 和 extract_zugferd 只能接收 file_path。

验证输出包含 valid 和 errors[]。每个错误包含 rule_id、severity、location、message、hint，并在存在规则代码时包含 rule_url。如果响应包含 rule_url 或 ruleUrl，则使用 API 返回的值；否则使用 https://checkxrechnung.com/fehler/<code>（小写）。extract_zugferd 返回 ok、summary 和 xml。

服务报告 persisted: false。这些工具会调用网络，因此并非本地只读检查。批量请求量： https://checkxrechnung.com/api-waitlist

软件包名称：xrechnung-validator-mcp。server.json 中的注册表名称：io.github.wenboteng/xrechnung-validator（mcpName 与之匹配）。尚未提交至 MCP 注册表。使用 npm run build 构建（node dist/index.js），或在发布后运行 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）：

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

Cursor

~/.cursor/mcp.json 或项目文件 .cursor/mcp.json：

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

从检出代码到 npm 发布之前：

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

VS Code

.vscode/mcp.json：

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

文档： https://checkxrechnung.com/en/docs · 规则： https://checkxrechnung.com/fehler/ · OpenAPI： https://checkxrechnung.com/openapi.json

支持 Markdown

登录后评论