InvoiceFlow MCP

用于模型上下文协议 (MCP) 的 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 或手动输入）与存储的发票进行匹配。计划在 v2.0 中实现带有 Webhook 监听器的 Stripe 和 PayPal API 直接集成——请查看 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

专业版许可证

InvoiceFlow 以 免费模式 发布 — invoice_demo_seed、client_manage、invoice_create、invoice_list、invoice_mark_paid 和 invoice_remind 是开放的。以下工具需要 专业版许可证：

• invoice_send — 生成 PDF + SendGrid 邮件投递

• invoice_risk — 逾期付款风险预测

• payment_reconcile — 将 Stripe/PayPal/银行付款与发票匹配

• cashflow_report — 全组合现金流 + 30 天预测

购买专业版许可证（€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。

由 Automatia BCN 构建。