InvoiceFlow MCP

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

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

주요 기능

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

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

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

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

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

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

• 순차적 송장 번호: (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 필요). 상태를 "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 제작.