InvoiceFlow MCP

Model Context Protocol向けのAI活用型請求書自動化ツール

InvoiceFlowは、プロフェッショナルなPDF請求書の作成、AIによる支払い遅延リスクの予測、リマインダーの自動送信、入金と請求書の照合、キャッシュフローの追跡をすべてMCPプロトコル経由で実現します。

機能

• プロフェッショナルなPDF請求書作成: 明細、税金、割引、多通貨（10通貨）対応

• AIリスク予測 (0-100): 請求金額、クライアントの履歴、期日、リマインダー履歴に基づく予測

• スマートリマインダー: リスクレベルに応じた段階的な通知

• 支払い照合: 金額と支払者メールアドレスによる入金と請求書の照合（プラットフォーム非依存 — 手動入力またはWebhook経由の支払いデータに対応）

• キャッシュフローレポート: 回収率、予測収入、クライアント別の内訳

• クライアント管理: 支払い履歴の自動追跡

• 連番請求書番号: (INV-2026-0001, INV-2026-0002, ...)

• 10個のMCPツール + 4個のMCPリソース: 請求業務のライフサイクル全体をカバー

Related MCP server: Frihet MCP Server

クイックスタート

MCPizeマーケットプレイスからインストール

1. mcpize.com で InvoiceFlow MCP を検索

2. Install をクリックし、サブスクリプションプランを選択

3. MCP対応クライアントでツールとリソースが自動的に利用可能になります

ソースからビルド

git clone https://github.com/enzoemir1/invoiceflow-mcp.git
cd invoiceflow-mcp
npm ci
npm run build

MCPクライアントの設定に追加:

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

ツール

client_manage

新規クライアントを作成します。請求書作成前に必須です。

invoice_create

明細付きの請求書を作成します。小計、税金、割引、合計を自動計算します。連番の請求書番号 (INV-YYYY-NNNN) を生成します。

invoice_send

請求書PDFをメールで送信します（SENDGRID_API_KEYが必要）。ステータスを「送信済み」に更新します。

invoice_list

ステータス、クライアント、金額範囲、日付範囲、または期限超過ステータスで請求書をフィルタリングします。ページネーションをサポートしています。

invoice_mark_paid

請求書を支払い済み（全額または一部）としてマークします。クライアントの支払い履歴を自動的に更新します。

invoice_remind

支払いリマインダーを送信します。リマインダー回数をインクリメントします。カスタムメッセージをサポートしています。

invoice_risk

AIによる支払い遅延リスク予測 (0-100)。リスクレベル、要因の内訳、推奨アクション、次回リマインダー日を返します。

cashflow_report

キャッシュフローの概要を生成します：請求総額、回収額、未払い額、期限超過額、回収率、30日間の予測。

payment_reconcile

金額と支払者メールアドレスに基づいて、入金を請求書と照合します。自動的に支払い済みとしてマークします。

リソース

リスク予測エンジン

4つの加重要因を使用して請求書を0〜100でスコアリングします：

リスクレベル: 低 (0-30), 中 (31-60), 高 (61-100)

設定

.env.example を .env にコピーし、必要な変数を設定してください：

cp .env.example .env

SendGridはオプションです。InvoiceFlowは、請求書作成、リスクスコアリング、キャッシュフローレポート、照合において完全にオフラインで動作します。送信メールが必要な場合にのみSendGridを追加してください。

ロードマップ: Stripe & PayPalライブ同期

payment_reconcile ツールは現在、提供された金額（CSV、Webhook、または手動入力）を保存済みの請求書と照合します。Webhookリスナーを備えたStripeおよびPayPal APIの直接統合はv2.0で計画されています。進捗状況は issues を参照してください。

使用例

クライアントと請求書の作成

> Create a client "Acme Corp" with email billing@acme.com

✓ Client created: Acme Corp (id: 3f2a...)

> Create an invoice for Acme Corp: 10 hours consulting at $150/hr, 20% tax

✓ Invoice INV-2026-0001 created
  Subtotal: $1,500.00 | Tax: $300.00 | Total: $1,800.00

支払いリスクの評価

> What's the risk score for invoice INV-2026-0001?

Risk Score: 42/100 (Medium)
  - Invoice Amount: 25 (moderate amount)
  - Client History: 50 (new client)
  - Due Date: 15 (due in 28 days)
  - Reminders: 10 (none sent)
Recommended: Send an early reminder with a polite tone.

キャッシュフローレポートの生成

> Show me the cash flow report

April 2026:
  Total Invoiced: $12,400.00
  Collected: $8,200.00 (66.1%)
  Outstanding: $4,200.00
  Overdue: $1,800.00
  Projected (30d): $2,400.00

対応通貨

USD, EUR, GBP, CAD, AUD, JPY, CHF, TRY, BRL, INR

料金

MCPize Marketplace で利用可能です。

開発

npm run dev        # Hot reload
npm run build      # Production build
npm test           # Run tests
npm run inspect    # MCP Inspector

テスト

テストはコアビジネスロジックをカバーしています：

• ストレージ — CRUD操作、フィルタリング、連番請求書番号

• リスクモデル — 4つの加重要因を持つAIスコアリングエンジン、リスク分類

• キャッシュフロー — レポート生成、回収率、予測、クライアント別内訳

npm test           # Run all tests
npx vitest --watch # Watch mode

Proライセンス

InvoiceFlowは Freeモード で提供されます。invoice_demo_seed、client_manage、invoice_create、invoice_list、invoice_mark_paid、invoice_remind はオープンです。以下のツールには Proライセンス が必要です：

• invoice_send — PDF生成 + SendGridメール配信

• invoice_risk — 支払い遅延リスク予測

• payment_reconcile — Stripe/PayPal/銀行振込と請求書の照合

• cashflow_report — ポートフォリオ全体のキャッシュフロー + 30日予測

Proライセンスを購入 (€12, 永続ライセンス, 3台まで): https://automatiabcn.lemonsqueezy.com/buy/2d439c05-f463-4137-8883-950e8ee1112d

または Indie MCP Stack Bundle (€69, 4サーバーすべて) を入手してください。

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

またはMCPクライアント設定にて：

{
  "mcpServers": {
    "invoiceflow-mcp": {
      "command": "npx",
      "args": ["-y", "invoiceflow-mcp-server"],
      "env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
    }
  }
}

検証はローカルで24時間キャッシュされるため、初回実行後は完全にオフラインで動作可能です。

ライセンス

MITライセンス。詳細は LICENSE を参照してください。

Built by Automatia BCN。