uae-einvoice-mcp

uae-einvoice-mcp

UAE e-invoicing / PINT AE 向けの MCP サーバーです。TRN/TIN の検証、構造的なコンプライアンスチェック、51 項目の必須チェックリスト、UBL XML のひな形生成、義務化スケジュールの確認を行えます。

MCP TypeScript SDK v2（@modelcontextprotocol/server）を使用し、stdio 経由で動作します。ローカルで無料で実行でき、v0.2 では API キーは不要です。

情報提供のみを目的としたツールであり、法務または税務に関する助言ではありません。また、認定サービスプロバイダー（ASP）による XSD 検証、電子署名、FTA 登録簿のリアルタイム確認の代わりにはなりません。validate_pint_ae_xml は、公式の OpenPeppol PINT AE 1.0.4 Schematron を実行します。

開発の背景

UAE の電子インボイス（Peppol + PINT AE）では、ASP が送信を行う前に、ERP および財務チームが多数の必須項目、TIN と TRN の違い、Peppol エンドポイント ID を正しく設定する必要があります。このサーバーは、こうした確認に使える小規模でインストール可能なツールキットを AI アシスタントに提供します。

ツール

ツール	機能
lookup_business_trn	15 桁の TRN または 10 桁の TIN の形式、UAE の 1… プレフィックス、Peppol AE:TIN のチェックディジットを検証し、0235:<TIN> を返します
check_invoice_compliance	構造的なチェック（取引当事者、合計金額の計算、税額の内訳、明細行）を行い、エラー／警告／スコアを返します
check_pint_ae_fields	51 項目の必須項目マトリックス全体をチェックします：入力済み／不足／無効／該当なし、および不足項目
generate_pint_ae_xml	UBL 2.1 PINT AE の Invoice／CreditNote を生成します（strict モードは任意）
validate_pint_ae_xml	公式 PINT AE 1.0.4 Schematron（共通ルール + UAE ルール）で検証します。初回の呼び出し時にルールをダウンロードしてコンパイルします
get_einvoicing_requirements	義務化のフェーズ、対象外の取引、最近の MoF 改正、技術的な基準、次のアクションを確認します
check_einvoicing_scope	取引ごとの適用範囲を判定します：B2B/B2G/B2C、Tax Group、政府機関、航空、免税金融取引 — 必須／対象外／任意

必要条件

• Node.js 20+

インストール／実行

npm install
npm run build
npm start

開発時（TypeScript を直接実行）：

npm run dev

セルフチェック（MCP クライアントは不要）：

npm run selfcheck

MCP Inspector

npm run inspector

examples/compliant-invoice.json、examples/credit-note.json、examples/usd-invoice.json、または examples/broken-invoice.json のフィクスチャをツールに貼り付けてください。

Cursor / Claude Desktop（stdio）

公開済みパッケージ（推奨）：

{
  "mcpServers": {
    "uae-einvoice": {
      "command": "npx",
      "args": ["-y", "uae-einvoice-mcp"]
    }
  }
}

ローカルのチェックアウト：

{
  "mcpServers": {
    "uae-einvoice": {
      "command": "node",
      "args": ["/absolute/path/to/uae-einvoice-mcp/dist/index.js"]
    }
  }
}

.cursor/mcp.json.example も参照してください。

推奨するテスト手順

1. examples/compliant-invoice.json を使って check_pint_ae_fields を実行します
2. 同じペイロードで generate_pint_ae_xml を実行します（strict: true で成功するはずです）
3. 生成された XML に対して validate_pint_ae_xml を実行します（初回の呼び出し時に PINT AE 1.0.4 のルールをダウンロードします）
4. examples/credit-note.json と examples/usd-invoice.json を使って 1〜2 を繰り返します
5. examples/broken-invoice.json を使い、strict: true で generate_pint_ae_xml を実行します（拒否されるはずです）
6. transactionKind: b2b と年間売上高を指定して check_einvoicing_scope を実行します

ロードマップ

• 51 項目のチェックリスト + PINT AE XML のひな形生成
• 公式 PINT AE 1.0.4 Schematron 検証（validate_pint_ae_xml）
• 取引ごとの適用範囲ヘルパー（check_einvoicing_scope）
• クレジットノートおよび AED 以外のフィクスチャ + CI セルフチェック
• ホスト型／有料プラン向けの任意の HTTP + API キーによるトランスポート
• npm に公開（[email protected]）
• MCP レジストリに掲載（io.github.mirzaabubakr/uae-einvoice-mcp）

ライセンス

MIT