invovate-mcp-server について
Invovate MCP Serverは、AIエージェントやMCPクライアントからInvovate APIを使って請求書を生成します。11言語のPDF、JSON、UBL 2.1に対応し、金額計算にはAPIキーが不要です。
主な機能
- 01請求書の合計額計算
- 02PDF請求書の生成
- 03UBL 2.1 XMLの生成
- 0411言語の請求書に対応
- 05通貨、テンプレート、機能の一覧
活用シーン
- 01税額と支払残高を計算
- 02顧客向けPDF請求書を作成
- 03請求書をUBL 2.1で出力
MCP 対応
請求額計算、PDF・UBL生成、機能一覧のツールをMCPクライアントに提供します。金額計算にキーは不要ですが、PDFとUBLの生成には無料のInvovate APIキーが必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y invovate-mcp-serverINVOVATE_API_KEYシークレットFree Invovate API key (starts with inv_) from https://invovate.com/auth. Required only for the PDF/UBL tools; calculate_invoice_totals works without it.INVOVATE_API_BASEOverride the API base URL (defaults to https://invovate.com).ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
4掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| to | object | はい | 請求先の顧客。 |
| to.name | any | はい | |
| to.email | any | いいえ | |
| to.tax_id | any | いいえ | |
| to.address | any | いいえ | |
| date | string | いいえ | ISO 日付(例:2026-06-01)。 |
| from | object | はい | 請求書を発行する事業者。 |
| from.name | string | はい | 当事者名(必須)。 |
| from.email | string | いいえ | |
| from.tax_id | string | いいえ | VAT / GST / 税務登録番号。 |
| from.address | string | いいえ | 複数行の住所。改行には \n を使います。 |
| items | array | はい | 明細項目(1 件以上)。 |
| notes | string | いいえ | |
| terms | string | いいえ | 支払条件(例:"Net 30")。 |
| number | string | いいえ | 請求書番号。省略すると自動生成されます。 |
| deposit | number | いいえ | |
| payment | object | いいえ | |
| payment.iban | string | いいえ | |
| payment.swift | string | いいえ | |
| payment.pay_to | string | いいえ | |
| payment.bank_name | string | いいえ | |
| payment.method_note | string | いいえ | 例:"Paid by card ending **999"。 |
| payment.account_name | string | いいえ | |
| payment.account_number | string | いいえ | |
| currency | string | いいえ | ISO 4217 コード(例:USD、EUR、GBP)。デフォルトは USD。 |
| due_date | string | いいえ | |
| language | enum | いいえ | 請求書の言語。デフォルトは en。ar/ja/hi/ru は埋め込みフォントでレンダリングされます。en | nl | de | fr | es | it | pt | ar | ja | ru | hi |
| shipping | number | いいえ | |
| template | enum | いいえ | PDF テンプレート。デフォルトは classic。classic | modern | bold | minimal | navy |
| po_number | string | いいえ | |
| global_tax | number | いいえ | 独自の tax_rate が設定されていないすべての明細項目に適用する税率(%)。 |
| amount_paid | number | いいえ | 支払い済み金額(一部入金の請求書用)。 |
| accent_color | string | いいえ | #2563eb のような 16 進数カラーコード。 |
| global_discount | number | いいえ | |
| global_discount_type | enum | いいえ | percent | amount |
詳細
Invovate MCP サーバー
Invovate MCP サーバーは、Claude、Cursor、その他の MCP クライアント向けの無料で登録不要の請求書 MCP サーバーです。Invovate invoice API を通じて、PDF、JSON、UBL 2.1 形式の請求書を生成します。
AI エージェントがInvovate invoice API を通じて、11 言語に対応した PDF、JSON、UBL 2.1 形式の請求書を生成できます (右から左に読むアラビア語、日本語、ヒンディー語、キリル文字を含みます)。Claude Desktop、 Cursor、Windsurf、および MCP 対応のあらゆるクライアントで動作します。
JSON の計算には API キーは不要です。PDF/UBL の出力には無料のキーが必要です。
ツール
| ツール | 機能 | キーが必要 |
|---|---|---|
calculate_invoice_totals | 小計、割引、税、送料、前受金、合計金額、残高を計算します。ファイルは生成されません。 | いいえ |
generate_invoice_pdf | PDF を生成します。7 日間有効なホストリンクを返すか(チャットに便利です)、save_path が指定されている場合はファイルを書き込みます。 | 必須 |
generate_invoice_ubl | UBL 2.1 XML を生成します(相互運用性/アーカイブ専用であり、規制対象の電子請求書ではありません)。 | はい |
get_invoice_capabilities | 対応言語、テンプレート、通貨、機能を一覧表示します。 | いいえ |
無料の API キーを取得する
https://invovate.com/auth で登録してください。キーは inv_ で始まります。無料プランで、
クレジットカードは不要です。(calculate_invoice_totals はキーなしで動作します。PDF、UBL、QR、ホストリンクには無料のキーが必要です。)
インストール
Claude Desktop
claude_desktop_config.json に追加します
(macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、
Windows の場合は %APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"invovate": {
"command": "npx",
"args": ["-y", "invovate-mcp-server"],
"env": { "INVOVATE_API_KEY": "inv_your_key_here" }
}
}
}
Claude Desktop を再起動します。次に、次のように依頼します:「Acme BV から Globex 宛てに、1 日 €900 のコンサルティングを 3 日分、VAT 21% で請求する請求書を英語で作成して、PDF をください。」
Cursor / Windsurf
同じブロックを MCP 設定(Cursor の場合は ~/.cursor/mcp.json、または
Windsurf の MCP 設定)に追加します。
ソースから実行する(npm 公開前)
git clone https://github.com/LightSpeedPlusOne/invovate-mcp-server.git
cd invovate-mcp-server && npm install
INVOVATE_API_KEY=inv_your_key node src/index.js
…そして、クライアントの接続先に指定します:
{
"mcpServers": {
"invovate": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/src/index.js"],
"env": { "INVOVATE_API_KEY": "inv_your_key_here" }
}
}
}
設定
| 環境変数 | デフォルト | 用途 |
|---|---|---|
INVOVATE_API_KEY | — | 無料の API キー(inv_…)。PDF/UBL の出力とホストリンクを有効にします。 |
INVOVATE_API_BASE | https://invovate.com | API のベース URL を上書きします(通常は不要です)。 |
テスト
npm test # lists tools + JSON math (no key)
INVOVATE_API_KEY=inv_xxx npm test # also exercises the PDF hosted-link path
注意事項
- 規制対象の電子請求書ではありません。 UBL エクスポートは相互運用性/アーカイブ専用です。 Peppol/Factur-X/ZUGFeRD/XRechnung/NF-e への準拠や、ネットワーク経由での送信には対応していません。
- ホストリンクには有効期限があり、7 日後に請求書は削除されます。
- エージェント向けドキュメント:https://invovate.com/invoice-api-for-ai-agents · OpenAPI:https://invovate.com/openapi.json
プロンプトの例
接続したら、AI クライアントに自然言語で依頼します:
Create an invoice for Acme Ltd for 3 hours of consulting at $120/hour. Return it as a PDF.
Generate a UBL 2.1 invoice for a SaaS subscription charged €49/month.
Make a Japanese invoice (¥) for ¥350,000 of web design with 10% consumption tax, and give me the link.
リンク
- Invoice API とドキュメント: https://invovate.com/api · https://invovate.com/invoice-api-for-ai-agents
- OpenAPI 3.1 仕様: https://invovate.com/openapi.json (ChatGPT / Claude Action としてインポート)
- MCP ランディングページ: https://invovate.com/mcp-invoice-generator · すべての連携: https://invovate.com/integrations
- npm(このパッケージ): https://www.npmjs.com/package/invovate-mcp-server
- Python SDK: https://pypi.org/project/invovate/ · JavaScript SDK: https://www.npmjs.com/package/invovate
- Glama MCP ディレクトリ: https://glama.ai/mcp/servers/LightSpeedPlusOne/invovate-mcp-server
- Postman コレクション: https://www.postman.com/lightspeedplusone-9440989/workspace/invovate-invoice-api/overview
- RapidAPI: https://rapidapi.com/LightSpeedPlusOne/api/invovate-invoice
- WordPress プラグイン: https://wordpress.org/plugins/invovate-invoice-generator/
ライセンス
MIT © Invovate
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。