invapi-mcp

Name: invapi-mcp
Author: invapi-org

ローカル

github.com/invapi-org金融データ036 週間前に更新

リポジトリ

invapi-mcp について

invapi-mcpは、電子請求書を扱うワークフロー向けのInvapi E-Invoicing API用MCPサーバーです。請求書ツールを通じて、形式変換、規格検証、データ抽出をまとめて提供します。

主な機能

01JSON、UBL、CII請求書の変換
02ZUGFeRD PDFとExcelファイルの作成
03UBL、CII、XMLの検証
04PDFや画像から請求書データを抽出
05QRコードデータの抽出
061リクエストで最大100件を一括変換

活用シーン

01JSONとUBLまたはCII間で請求書を変換
02XRechnung 3.0.2に照らしてXMLを検証
03請求書スキャンから構造化データを抽出
041回のリクエストで複数の変換を処理

MCP 対応

Invapi E-Invoicing APIの変換、検証、抽出、アカウント情報の操作をMCPツールとして公開します。

設定

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

mcp.json · 共通設定

{
  "mcpServers": {
    "invapi-org-invapi": {
      "command": "npx",
      "args": [
        "-y",
        "@invapi/mcp-server"
      ],
      "env": {
        "INVAPI_API_KEY": "<INVAPI_API_KEY>"
      }
    }
  }
}

起動コマンドnpx -y @invapi/mcp-server

設定が必要な環境変数

INVAPI_API_KEYシークレットYour API key for Invapi

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

パッケージ

npm@invapi/mcp-server1.0.5stdio

ツール

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

パラメーター	型	必須	説明
invoice	object	はい
invoice.id	string	いいえ
invoice.buyer	object	はい	請求書を受け取る当事者
invoice.buyer.name	any	はい
invoice.buyer.contact	any	はい
invoice.buyer.postal_address	any	はい
invoice.buyer.vat_identifier	any	いいえ
invoice.items	array	はい	請求書の明細項目（1 件以上）
invoice.seller	object	はい	請求書を発行する当事者
invoice.seller.name	string	はい	当事者の正式名称
invoice.seller.contact	object	はい
invoice.seller.contact.email_address	string	いいえ	メールアドレス
invoice.seller.contact.telephone_number	string	いいえ	電話番号
invoice.seller.postal_address	object	はい
invoice.seller.postal_address.city	string	はい	都市名
invoice.seller.postal_address.post_code	string	はい	郵便番号
invoice.seller.postal_address.country_code	string	はい	ISO 3166-1 alpha-2 国コード。例：'DE'、'US'、'FR'
invoice.seller.postal_address.address_line_1	string	はい	住所の 1 行目
invoice.seller.postal_address.address_line_2	string	いいえ	住所の 2 行目
invoice.seller.postal_address.address_line_3	string	いいえ	住所の 3 行目
invoice.seller.postal_address.country_subdivision	string	いいえ	州／省／地域
invoice.seller.vat_identifier	string	いいえ	VAT 識別番号
invoice.totals	object	はい
invoice.totals.paid_amount	number	はい	支払済み金額
invoice.totals.sum_of_charges	number	いいえ
invoice.totals.rounding_amount	number	いいえ
invoice.totals.total_vat_amount	number	はい	VAT の合計額
invoice.totals.sum_of_allowances	number	いいえ
invoice.totals.total_amount_with_vat	number	はい	VAT 込みの全明細項目の合計額
invoice.totals.amount_due_for_payment	number	はい	支払うべき金額
invoice.totals.total_amount_without_vat	number	はい	VAT 抜きの全明細項目の合計額
invoice.totals.invoice_total_without_vat	number	いいえ
invoice.category	string	いいえ	請求書カテゴリ
invoice.invoice_date	string	はい	発行日。形式は YYYY-MM-DD
invoice.invoice_note	string	いいえ
invoice.invoice_type	enum	はい	'incoming' = ベンダー／サプライヤーから受領；'outgoing' = 顧客に送付incoming \| outgoing
invoice.invoice_number	string	はい	一意の請求書識別子。例：'INV-2025-001'
invoice.additional_data	object	いいえ
invoice.additional_data.project	string	いいえ	プロジェクト参照情報
invoice.additional_data.order_id	string	いいえ
invoice.additional_data.leitweg_id	string	いいえ	ドイツ政府向け請求書の Leitweg-ID
invoice.additional_data.customer_id	string	いいえ
invoice.additional_data.delivery_id	string	いいえ
invoice.additional_data.reverse_charge	boolean	いいえ	VAT のリバースチャージが適用される場合は True
invoice.additional_data.invoicing_period	object	いいえ
invoice.additional_data.invoicing_period.end	string	はい	期間終了日（YYYY-MM-DD）
invoice.additional_data.invoicing_period.start	string	はい	期間の開始日（YYYY-MM-DD）
invoice.additional_data.preceeding_invoice_number	string	いいえ
invoice.invoice_description	string	はい	請求書の簡単な説明
invoice.payment_information	object	はい
invoice.payment_information.payment_type	enum	いいえ	支払い方法credit_card \| credit_transfer \| cash \| online_payment_service
invoice.payment_information.payment_terms	string	いいえ
invoice.payment_information.credit_card_type	string	いいえ
invoice.payment_information.payment_due_date	string	いいえ	期限日（YYYY-MM-DD）
invoice.payment_information.payment_reference	string	いいえ
invoice.payment_information.credit_card_number	string	いいえ
invoice.payment_information.payment_payed_date	string	いいえ	支払日（YYYY-MM-DD）
invoice.payment_information.payment_instructions	string	いいえ
invoice.payment_information.payment_account_number	string	いいえ	IBAN または口座番号
invoice.delivery_information	object	いいえ
invoice.delivery_information.deliver_to	string	いいえ	配送先の名前
invoice.delivery_information.delivery_date	string	いいえ	納品日（YYYY-MM-DD）
invoice.delivery_information.delivery_method	string	いいえ
invoice.delivery_information.deliver_to_address	object	いいえ
invoice.delivery_information.deliver_to_address.city	string	はい
invoice.delivery_information.deliver_to_address.post_code	string	はい
invoice.delivery_information.deliver_to_address.country_code	string	はい
invoice.delivery_information.deliver_to_address.address_line_1	string	はい	住所の 1 行目
invoice.delivery_information.deliver_to_address.address_line_2	string	いいえ
invoice.delivery_information.deliver_to_address.address_line_3	string	いいえ
invoice.delivery_information.deliver_to_address.country_subdivision	string	いいえ
invoice.delivery_information.delivery_instructions	string	いいえ
invoice.invoice_currency_code	string	はい	ISO 4217 通貨コード（例：'EUR'、'USD'、'GBP'）
output_path	string	いいえ	UBL XML 出力を保存するファイルパス。省略した場合、XML はインラインで返されます。

詳細

@invapi/mcp-server

Invapi の電子請求書 API 用 MCP サーバーです。請求書を UBL、CII、ZUGFeRD、Excel などの形式に変換、検証、抽出できます。

クイックスタート

npm install -g @invapi/mcp-server

API キーを設定します（invapi.org で取得できます）。

export INVAPI_API_KEY=your-api-key

使い方

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "invapi": {
      "command": "npx",
      "args": ["-y", "@invapi/mcp-server"],
      "env": {
        "INVAPI_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add -e INVAPI_API_KEY=xxx invapi -- npx @invapi/mcp-server

ツール

変換

ツール	説明
`invapi_convert_json_to_ubl`	JSON 請求書 → UBL XML
`invapi_convert_json_to_cii`	JSON 請求書 → CII XML
`invapi_convert_ubl_to_json`	UBL XML → JSON 請求書
`invapi_convert_cii_to_json`	CII XML → JSON 請求書
`invapi_convert_json_to_xlsx`	JSON 請求書 → Excel ファイル
`invapi_create_zugferd_pdf`	PDF + JSON 請求書 → ZUGFeRD PDF
`invapi_convert_zugferd_to_json`	ZUGFeRD PDF → JSON 請求書

検証

ツール	説明
`invapi_validate_ubl`	XRechnung 3.0.2（EN 16931）に照らして UBL XML を検証
`invapi_validate_cii`	XRechnung 3.0.2（EN 16931）に照らして CII XML を検証
`invapi_validate_xml`	形式を自動検出して XML を検証

抽出

ツール	説明
`invapi_extract_invoice`	PDF または画像から構造化された請求書データを抽出
`invapi_extract_qr`	画像から QR コードデータを抽出

ユーザー

ツール	説明
`invapi_get_user`	アカウント情報と残りの API クレジットを取得

一括処理

ツール	説明
`invapi_batch_convert`	1 回のリクエストで最大 100 件の変換処理を実行

開発

git clone https://github.com/invapi/invapi-mcp.git
cd invapi-mcp
npm install
npm run dev

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: invapi-org
言語: node
バージョン: 1.0.1
トランスポート: stdio
掲載日: 2026年2月22日
最終更新: 36 週間前
公式 Registry: io.github.invapi-org/invapi-mcp

問題を報告

MCP は初めてですか？

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

入門ガイドを読む

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

invapi-mcp

invapi-mcp について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@invapi/mcp-server

クイックスタート

使い方

Claude Desktop

Claude Code

ツール

変換

検証

抽出

ユーザー

一括処理

開発

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？