mcpField
E

Eleata Einvoice Mcp

ローカル
github.com/hernaninverso金融データ017 週間前に更新
リポジトリ

Eleata Einvoice Mcp について

Eleata Einvoice Mcpは、EU電子インボイスを検証し、エラーを説明するコーディングエージェント向けMCPサーバーです。ホスト型検証APIとオフラインのエラーコード資料を組み合わせ、Peppol BIS、XRechnung、Factur-X/ZUGFeRDなどに対応します。

主な機能

  1. 01対応するEU電子インボイス形式の検証
  2. 02ルールIDと修正案の提示
  3. 03現在の対応形式の一覧表示
  4. 04エラーコードのオフライン解説

活用シーン

  1. 01提出前のXRechnungインボイス検証
  2. 02FatturaPAの検証エラーの診断
  3. 03対応するインボイス形式の確認

MCP 対応

インボイス検証、形式一覧、エラーコード解説のツールを提供します。インボイス検証にはホスト型のeleata APIを使い、形式一覧とエラー解説はオフラインで利用できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "eleata-einvoice": {
      "command": "npx",
      "args": [
        "-y",
        "eleata-einvoice-mcp"
      ],
      "env": {
        "EINVOICE_API_KEY": "<EINVOICE_API_KEY>"
      }
    }
  }
}
起動コマンドnpx -y eleata-einvoice-mcp
設定が必要な環境変数
EINVOICE_API_KEYシークレットFree API key for the eleata e-invoice validation backend (https://eleata.io/signup/)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmeleata-einvoice-mcp0.1.1

ツール

3

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
formatenumいいえ形式のヒント。デフォルト：auto（サーバーが XML と PDF、およびプロファイルを判別します）。auto | peppol-bis-3 | en16931-ubl | en16931-cii | xrechnung-ubl | xrechnung-cii | factur-x | ubl | cii
is_pdfbooleanいいえ`content` が base64 エンコードされた PDF（Factur-X/ZUGFeRD）の場合は true に設定します。デフォルトは false です。
contentstringはい検証する請求書。XML 形式の場合は、生の XML テキストを指定します。Factur-X / ZUGFeRD PDF の場合は、base64 エンコードされた PDF バイト列を指定します（is_pdf=true を設定）。

詳細

eleata e-invoice MCP サーバー

AI コーディングエージェント（Claude、Cursor、Copilot など）から、EU の電子インボイスを検証し、検証のエラーコードを説明できます。ホスト型のeleata検証 API と、同梱のオフラインエラーコードリファレンスを利用します。

不備のあるインボイスを送信しないようにしましょう。エージェントに「この FatturaPA／XRechnung／Peppol ファイルは有効ですか？」と尋ねると、正式な Schematron ルールを実行し、ルール ID と修正方法を返します。却下（SdI の scarto、Chorus Pro による拒否、KSeF エラー）が発生する前に確認できます。

ツール

ツール内容API キー
validate_einvoice1 件のインボイスを検証します（Peppol BIS 3.0、EN 16931 UBL/CII、XRechnung 3.0.x、Factur-X/ZUGFeRD、UBL、CII）。有効／無効の判定と、各ルール ID、説明、修正方法を返します。必須
list_formatseleata が現在検証できる形式とロードマップを一覧表示します。不要
explain_error_codeエラーコード（例：00400、BR-DE-21）をわかりやすい英語で説明し、修正方法を示します。オフラインで動作します。不要

セットアップ

  1. https://eleata.io/signup/ で無料の API キーを取得します（月 200 回の検証、カード不要）。
  2. エージェントの MCP 設定にサーバーを追加します。
Claude Desktop / Claude Code（claude_desktop_config.json または .mcp.json）
{
  "mcpServers": {
    "eleata-einvoice": {
      "command": "npx",
      "args": ["-y", "eleata-einvoice-mcp"],
      "env": { "EINVOICE_API_KEY": "your_free_key_here" }
    }
  }
}
Cursor（~/.cursor/mcp.json）

上記と同じブロックを使用します。

プロンプトの例

  • 「この XRechnung ファイルを検証して、修正すべき箇所を教えてください」（XML を貼り付けます）
  • 「FatturaPA のエラー 00400 は何を意味しますか？また、どう修正すればよいですか？」
  • 「現在、どの電子インボイス形式を検証できますか？」

プライバシー

validate_einvoice は、渡されたインボイスをホスト型の eleata API に送信して検証します。list_formats と explain_error_code はローカル／オフラインで動作します（エラーコードリファレンスは同梱されています）。https://eleata.io/privacy/をご覧ください。

リンク

MIT ライセンスです。Schematron エンジン：Mustang / phive。Schematron ルールは CEN、OpenPeppol、KoSIT によるものです。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。