Invoiceflow Mcp

InvoiceFlow MCP

面向 Model Context Protocol 的 AI 发票自动化工具

![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6.svg ![MCP](https://img.shields.io/badge/MCP-1.29-2A9D8F.svg

InvoiceFlow 可创建专业的 PDF 发票，使用 AI 预测逾期付款风险，自动发送提醒，将收到的付款与发票匹配，并跟踪现金流——所有操作均通过 MCP 协议完成。

---

功能

• 专业的 PDF 发票，包含明细项目、税费、折扣和多币种支持（10 种货币）
• AI 风险预测（0-100），依据发票金额、客户历史记录、到期日和提醒历史记录
• 智能提醒，根据风险等级逐级升级
• 付款对账，按金额和付款人邮箱将收到的付款与发票匹配（与平台无关——支持手动输入或通过 webhook 提供的付款数据）
• 现金流报告，包含收款率、预计收入和客户明细
• 客户管理，自动跟踪付款历史记录
• 连续发票编号（INV-2026-0001、INV-2026-0002，……）
• 10 个 MCP 工具 + 4 个 MCP 资源，覆盖完整的发票处理生命周期

---

快速开始

从 MCPize Marketplace 安装

1. 在 mcpize.com 搜索 InvoiceFlow MCP
2. 点击 Install——免费工具可立即使用；支付 €12 的终身许可证即可解锁 Pro（参见 Pro License）
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"]
    }
  }
}

---

工具

invoice_demo_seed

填充逼真的演示数据集——涵盖 5 种类型的 8 位客户（按时付款、逾期付款、高价值、新客户、长期逾期）以及过去 6 个月内的 25-45 张发票——让每个工具无需任何凭据即可返回有意义的结果。可安全地多次调用；每次调用都会追加一批带有唯一 UUID 的新数据。返回数量统计以及 sample_invoice_ids。

client_manage

创建新客户。创建发票前必须先创建客户。

invoice_create

创建包含明细项目的发票。自动计算小计、税费、折扣和总额。生成连续的发票编号（INV-YYYY-NNNN）。

invoice_send

通过电子邮件发送发票 PDF（需要 SENDGRID_API_KEY）。将状态更新为 "sent"。

invoice_list

按状态、客户、金额范围、日期范围或逾期状态筛选发票。支持分页。

invoice_mark_paid

将发票标记为已付款（全额或部分付款）。自动更新客户付款历史记录。

invoice_remind

发送付款提醒。增加提醒次数。支持自定义消息。

invoice_risk

由 AI 驱动的逾期付款风险预测（0-100）。返回风险等级、因素明细、建议操作和下次提醒日期。

cashflow_report

生成现金流摘要：已开票总额、已收款金额、未结金额、逾期金额、收款率和 30 天预测。

payment_reconcile

按金额和付款人邮箱将收到的付款与发票匹配。自动标记为已付款。

---

资源

资源	说明
invoices://pending	所有未付款发票
invoices://overdue	已超过到期日的发票
invoices://stats	月度现金流摘要
clients://list	包含付款历史记录的所有客户

---

风险预测引擎

使用 4 个加权因素对发票进行 0-100 评分：

因素	权重	衡量内容
发票金额	20%	金额越高 = 风险越高
客户历史记录	35%	付款率、逾期付款次数、平均天数
到期日	30%	距到期日或超过到期日的天数
提醒	15%	已发送的提醒数

风险等级： 低（0-30）、中（31-60）、高（61-100）

---

配置

将 .env.example 复制为 .env，并设置所需变量：

cp .env.example .env

变量	必需条件	说明
SENDGRID_API_KEY	发送邮件时需要	通过 SendGrid 发送发票和提醒

SendGrid 为可选项。InvoiceFlow 完全离线也能创建发票、评估风险、报告现金流并进行对账。需要发送邮件时再添加 SendGrid。

路线图：Stripe 和 PayPal 实时同步

payment_reconcile 工具目前会将你提供的金额（来自 CSV、webhook 或手动输入）与已存储的发票进行匹配。直接集成 Stripe 和 PayPal API，并添加 webhook 监听器，计划在 v2.0 推出——进度请参阅 issues。

使用示例

创建客户和发票

> Create a client "Acme Corp" with email [email protected]

✓ 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

---

定价

套餐	价格	工具	功能
免费版	€0	invoice_demo_seed、client_manage、invoice_create、invoice_list、invoice_mark_paid、invoice_remind	PDF 发票、多币种、客户管理、手动提醒
Pro	€12 终身	+ invoice_send、invoice_risk、payment_reconcile、cashflow_report	AI 风险评估、SendGrid 邮件发送、付款对账、现金流报告

一次性支付 €12，即可获得终身许可证（3 台设备）——无需订阅。购买和激活方式见下文的 Pro 许可证。

---

开发

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 默认以 免费模式运行——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。

由 Automatia BCN 构建。