InvoiceFlow MCP

Model Context Protocol을 위한 AI 기반 송장 자동화

👁 License: MIT
👁 TypeScript
👁 MCP

InvoiceFlow는 전문적인 PDF 송장을 생성하고, AI를 사용하여 연체 위험을 예측하며, 자동으로 알림을 보내고, 들어오는 결제 내역을 송장과 대조하며, 현금 흐름을 추적합니다. 이 모든 기능은 MCP 프로토콜을 통해 이루어집니다.

주요 기능

• 전문적인 PDF 송장: 품목, 세금, 할인, 다중 통화(10개 통화) 지원

• AI 위험 예측 (0-100): 송장 금액, 고객 이력, 마감일, 알림 이력을 기반으로 예측

• 스마트 알림: 위험 수준에 따른 단계적 알림 발송

• 결제 조정: 금액 및 결제자 이메일을 기준으로 들어오는 결제 내역과 송장 매칭 (플랫폼 독립적 — 수동 입력 또는 웹훅 제공 결제 데이터와 작동)

• 현금 흐름 보고: 회수율, 예상 수입, 고객별 분석 제공

• 고객 관리: 자동 결제 이력 추적

• 순차적 송장 번호: (INV-2026-0001, INV-2026-0002, ...)

• 10개의 MCP 도구 + 4개의 MCP 리소스: 전체 송장 발행 주기 지원

Related MCP server: Invoice 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 필요). 상태를 "sent"로 업데이트합니다.

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, 웹훅 또는 수동 입력에서) 제공한 금액을 저장된 송장과 매칭합니다. 웹훅 리스너를 포함한 직접적인 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 마켓플레이스에서 이용 가능합니다.

개발

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 제작.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• cashflow_reportA
• client_manageA
• invoice_createA
• invoice_demo_seedA
• invoice_listA
• invoice_mark_paidA
• invoice_remindA
• invoice_riskA