XRechnung Validator

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 の概要を返します。

無料枠は共通で、UTC 1 日あたり IP ごとに 50 リクエスト、1 分あたり 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 は、レスポンスに 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

MIT。Copyright (c) 2026 Bobook Limited.