E-Invoice MCPサーバー

DACH地域（ドイツ・オーストリア・スイス）の電子請求書用MCPサーバー — XRechnungの作成、検証、データ抽出を行います。Claude、Cursor、または任意のMCPクライアントから直接利用可能です。

npm version License: MIT

これは何ですか？

E-Invoice MCPは、ドイツのXRechnung標準に準拠した電子請求書の作成および検証を行うModel Context Protocolサーバーです。2027年以降、ドイツのすべての企業は電子請求書を送受信できる必要があります。このツールを使えば、その準備が整います。

Claudeに対して「Beispiel GmbH宛てにコンサルティング10時間分の請求書を作成して」と伝えるだけで、有効なXRechnung（UBL 2.1 XML）が生成されます。

機能

XRechnung作成 — 構造化データから有効なUBL 2.1 XMLを生成（EN 16931 + XRechnung 3.0.2準拠）
電子請求書検証 — 構文、必須項目、ドイツのビジネスルール（BR-DE）のチェック
データ抽出 — UBLまたはCII XMLから構造化データを読み取り
フォーマット情報 — 必須項目、税区分、単位コード、期限のリファレンス
自動計算 — 正味金額、総額、税額を自動計算
プラグイン対応 — スタンドアロンでの実行、またはBuchPilot MCPサーバーへの統合が可能
外部サービス不要 — すべてローカルで動作し、APIキーは不要
ネイティブ依存関係なし — Node.jsが動作するすべてのシステムで実行可能

法的期限

日付	内容
2025年1月1日	すべての企業は電子請求書を受信できる必要がある
2026年12月31日	PDF請求書は受取人の同意がある場合のみ許可
2027年1月1日	売上高80万ユーロ超の企業は電子請求書を送信する必要がある
2028年1月1日	すべての企業が電子請求書を送信する必要がある

不適切な電子請求書は、仕入税額控除の喪失（+6%の利息）につながる可能性があります。

インストール

前提条件

Node.js >= 18

npm (グローバル)

npm install -g einvoice-mcp

ソースから

git clone https://github.com/makririch/einvoice-mcp.git
cd einvoice-mcp
npm install
npm run build

設定

このMCPサーバーは設定不要です。APIキーや外部サービスは必要なく、すべてローカルで動作します。

利用方法

サーバーの起動 (スタンドアロン)

# Nach npm install -g:
einvoice-mcp

# Oder von Source:
npm start

# Entwicklung mit Auto-Reload:
npm run dev

サーバーはstdio経由で動作し、MCPメッセージを待機します。

Claude Desktopでの利用

詳細な手順については、Claude Desktopセットアップガイドを参照してください。

概要 — claude_desktop_config.json に以下を追加します：

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

例（Claudeでの自然言語による指示）

サーバーを設定した後、Claudeに以下のように尋ねることができます：

「Beispiel GmbH宛てに、150ユーロのコンサルティング10時間分のXRechnungを作成して」
「このXMLファイルは有効なXRechnungですか？」
「このXMLから請求書データを抽出して」
「XRechnungに必要な必須項目は何ですか？」
「税区分にはどのようなものがあり、それぞれ何を意味しますか？」
「私の会社はいつまでに電子請求書を送信できるようになる必要がありますか？」

クイックスタート

「5分で最初のXRechnungを作成する」ステップバイステップガイドは、docs/quickstart.mdにあります。

ツールリファレンス

パラメータ、入力例、出力例を含む全4ツールの完全なリファレンスは、docs/tool-reference.mdを参照してください。

概要

ツール	説明
`create_xrechnung`	構造化データからXRechnung (UBL 2.1 XML) を作成
`validate_invoice`	電子請求書XMLを検証 (構文 + BR-DEビジネスルール)
`extract_data`	UBLまたはCII XMLから構造化データを抽出
`get_format_info`	フォーマット、必須項目、コード、期限のリファレンス

BuchPilotとの統合

E-Invoice MCPは、BuchPilot MCPサーバーのプラグインとして統合できます：

import { registerEInvoiceTools } from "einvoice-mcp";
registerEInvoiceTools(server);

組み合わせ例: BuchPilotでLexofficeの請求書を作成 -> データを抽出 -> XRechnungを生成 -> 電子請求書の完成。

対応標準

標準	バージョン	ステータス
XRechnung	3.0.2	作成 + 検証
EN 16931	—	XRechnungの基礎
UBL 2.1	—	XRechnungのXML構文
CII (Cross Industry Invoice)	—	抽出 (読み取り)
ZUGFeRD / Factur-X	2.3	抽出 (読み取り)、作成は計画中

FAQ / トラブルシューティング

「XMLを解析できませんでした」

XMLは整形式ですか？（すべてのタグが正しく閉じられていますか？）
実際にUBLまたはCII請求書ですか？（ルート要素が <Invoice> または <CrossIndustryInvoice> である必要があります）
エンコーディングはUTF-8ですか？

検証で「BR-DE-13: Buyer Referenceは必須です」というエラーが出る

買い手参照（BT-10）はXRechnungで必須です。公共機関への請求書の場合、これはLeitweg-IDになります。B2B請求書の場合は、任意の参照番号（注文番号など）を指定できます。

{
  "buyerReference": "04011000-12345-67"
}

検証で「BR-DE-21: 電話番号が推奨されます」という警告が出る

これは警告であり、エラーではありません。請求書は有効です。ただし、互換性を最大化するために、販売者の電話番号を指定することをお勧めします。

税区分にはどのようなものがありますか？

コード	名前	説明	税率
S	標準	通常の税率	19%, 7%
Z	ゼロ税率	0% (例: VAT免除の域内取引)	0%
E	免税	例: ドイツ付加価値税法第19条に基づく小規模事業者	0%
AE	リバースチャージ	受取人の納税義務 (ドイツ付加価値税法第13b条)	0%
K	域内取引	税免除の域内供給	0%

単位コードにはどのようなものがありますか？

コード	名前	説明
H87	個	個別の単位 (デフォルト)
HUR	時間	作業時間
DAY	日	労働日
MON	月	暦月
KGM	キログラム	重量
MTR	メートル	長さ
LTR	リットル	容量
MTK	平方メートル	面積
SET	セット/パッケージ	構成品
C62	単位 (汎用)	一般的な数量単位

サーバーは起動しているが、Claudeがツールを認識しない

claude_desktop_config.json が正しいか確認してください
設定変更後はClaude Desktopを再起動してください
ログを確認してください: ~/Library/Logs/Claude/mcp.log (macOS)

ライセンス

MIT — 商用利用を含め、自由に使用可能です。

著者

MaKri — GitHub

einvoice-mcp