de en es ja ko ru zh

Invoice Parser MCP

Name: Invoice Parser MCP
Author: knportal

by knportal

Overview Schema Related Servers Score Discussions

Python

Remote

Invoice Parser MCP

从您的 AI 智能体中将发票、收据和财务文档解析为结构化 JSON。

License: MIT Version MCP

收录于： Glama · Smithery · mcp.so

专为 Model Context Protocol 构建。由 Claude Vision 提供支持。

功能说明

从 PDF 发票、扫描收据和图像文件中提取结构化数据。无需模板，无需 OCR 配置 —— Claude Vision 读取文档并返回整洁的 JSON。

Related MCP server: kelnix-receipt-mcp-api

工具

工具	描述	价格
`parse_invoice`	完整发票解析（供应商、行项目、总计、到期日）	$0.05/次
`parse_receipt`	零售收据解析（商户、项目、税费、支付方式）	$0.05/次
`extract_line_items`	仅提取明细列表，不包含其他内容	$0.01/次
`extract_totals`	仅提取小计、税费、总计、到期日	$0.01/次
`validate_invoice`	数学验证 —— 检查行项目总和是否正确	$0.01/次
`export_to_csv`	批量解析多个文件 → 汇总 CSV（最多 20 个）	$0.10/次

工具参考

`parse_invoice`

完整发票解析。从供应商发票中提取所有结构化字段。

参数

参数	类型	必需	描述
`file_path`	string	是	发票 PDF 或图像（PNG, JPG, WEBP）的绝对路径。
`api_key`	string	否*	您的 InvoiceParser API 密钥。请在 plenitudo.ai 获取。
`payment_proof`	string	否*	x402 支付证明（Base USDC 交易哈希）。`api_key` 的替代方案。

*必须提供 api_key 或 payment_proof 其中之一。

输入示例

{
  "file_path": "/Users/me/documents/invoice_acme_jan2025.pdf",
  "api_key": "ip_free_abc123"
}

输出示例

{
  "ok": true,
  "document_type": "invoice",
  "vendor": {
    "name": "Acme Corp",
    "address": "123 Industrial Way, Austin TX 78701",
    "email": "billing@acme.com",
    "phone": "512-555-0100",
    "tax_id": "12-3456789"
  },
  "bill_to": {
    "name": "Jane Smith",
    "address": "456 Oak Ave, Boston MA 02101",
    "email": "jane@example.com"
  },
  "invoice_number": "INV-2025-0142",
  "invoice_date": "2025-01-15",
  "due_date": "2025-02-15",
  "payment_terms": "Net 30",
  "currency": "USD",
  "line_items": [
    {
      "description": "Software consulting — January",
      "quantity": 40,
      "unit_price": 175.0,
      "total": 7000.0,
      "tax_rate": 0.0
    }
  ],
  "subtotal": 7000.0,
  "discount": 0.0,
  "tax_amount": 560.0,
  "shipping": 0.0,
  "total": 7560.0,
  "amount_due": 7560.0,
  "notes": "Wire transfer preferred. See banking details on page 2.",
  "po_number": "PO-98765"
}

`parse_receipt`

解析零售或费用收据。专为销售点收据、餐厅账单和费用报销单据设计。

参数

参数	类型	必需	描述
`file_path`	string	是	收据 PDF 或图像（PNG, JPG, WEBP）的绝对路径。
`api_key`	string	否*	您的 InvoiceParser API 密钥。
`payment_proof`	string	否*	x402 支付证明（Base USDC 交易哈希）。

输入示例

{
  "file_path": "/Users/me/receipts/coffee_shop_march1.jpg",
  "api_key": "ip_free_abc123"
}

输出示例

{
  "ok": true,
  "document_type": "receipt",
  "merchant": {
    "name": "Blue Bottle Coffee",
    "address": "300 Webster St, Oakland CA 94609",
    "phone": "510-555-0200",
    "website": "bluebottlecoffee.com"
  },
  "date": "2025-03-01",
  "time": "09:14",
  "receipt_number": "5541",
  "cashier": "Maria",
  "items": [
    { "name": "Latte (large)", "quantity": 1, "unit_price": 6.50, "total": 6.50, "sku": "", "category": "beverage" },
    { "name": "Croissant", "quantity": 1, "unit_price": 4.00, "total": 4.00, "sku": "", "category": "pastry" }
  ],
  "subtotal": 10.50,
  "discounts": 0.0,
  "tax": 0.84,
  "tip": 2.00,
  "total": 13.34,
  "currency": "USD",
  "payment_method": "Visa",
  "card_last_four": "4242",
  "transaction_id": "TXN-88821",
  "loyalty_points": null,
  "notes": ""
}

`extract_line_items`

轻量级提取，仅返回明细列表。当您只需要行项目时，比 parse_invoice 更快且更便宜。

参数

参数	类型	必需	描述
`file_path`	string	是	发票或收据 PDF 或图像的绝对路径。
`api_key`	string	否*	您的 InvoiceParser API 密钥。
`payment_proof`	string	否*	x402 支付证明（Base USDC 交易哈希）。

输出示例

{
  "ok": true,
  "line_items": [
    { "description": "Widget A (x10)", "quantity": 10, "unit_price": 12.00, "total": 120.00 },
    { "description": "Widget B (x5)",  "quantity": 5,  "unit_price": 24.00, "total": 120.00 }
  ],
  "item_count": 2
}

`extract_totals`

仅提取财务摘要（小计、税费、总计、到期日），不解析行项目或供应商详细信息。

参数

参数	类型	必需	描述
`file_path`	string	是	发票或收据 PDF 或图像的绝对路径。
`api_key`	string	否*	您的 InvoiceParser API 密钥。
`payment_proof`	string	否*	x402 支付证明（Base USDC 交易哈希）。

输出示例

{
  "ok": true,
  "currency": "USD",
  "subtotal": 240.00,
  "discount": 0.0,
  "tax_amount": 19.20,
  "tax_rate": 8.0,
  "shipping": 0.0,
  "tip": 0.0,
  "total": 259.20,
  "amount_due": 259.20,
  "invoice_date": "2025-01-15",
  "due_date": "2025-02-15"
}

`validate_invoice`

数学验证工具。验证行项目总计是否等于 quantity × unit_price，小计是否与行项目总和匹配，税费计算是否一致，以及最终总计是否核对无误。允许 ±$0.02 的舍入误差。

参数

参数	类型	必需	描述
`file_path`	string	是	发票 PDF 或图像的绝对路径。
`api_key`	string	否*	您的 InvoiceParser API 密钥。
`payment_proof`	string	否*	x402 支付证明（Base USDC 交易哈希）。

输出示例 — 有效发票

{
  "ok": true,
  "valid": true,
  "issues": [],
  "summary": {
    "line_items_checked": 3,
    "subtotal": 450.00,
    "tax": 36.00,
    "total": 486.00,
    "currency": "USD"
  }
}

输出示例 — 无效发票

{
  "ok": true,
  "valid": false,
  "issues": [
    {
      "field": "line_item_2_total",
      "expected": 120.00,
      "found": 100.00,
      "description": "quantity (10) × unit_price (12.00) = 120.00, but stated total is 100.00"
    }
  ],
  "summary": {
    "line_items_checked": 3,
    "subtotal": 340.00,
    "tax": 27.20,
    "total": 367.20,
    "currency": "USD"
  }
}

`export_to_csv`

批量解析最多 20 张发票或收据并导出为汇总 CSV。每一行包含：文件名、文档类型、供应商/商户、日期、编号、小计、税费、总计、货币、到期日、支付方式。

参数

参数	类型	必需	描述
`file_paths`	字符串数组	是	发票/收据 PDF 或图像的绝对路径列表。最多 20 个。
`output_path`	string	是	保存输出 CSV 文件的绝对路径。
`api_key`	string	否*	您的 InvoiceParser API 密钥。
`payment_proof`	string	否*	x402 支付证明（Base USDC 交易哈希）。

输入示例

{
  "file_paths": [
    "/Users/me/invoices/jan2025.pdf",
    "/Users/me/invoices/feb2025.pdf",
    "/Users/me/receipts/expense_march.jpg"
  ],
  "output_path": "/Users/me/exports/q1_summary.csv",
  "api_key": "ip_free_abc123"
}

输出示例 (JSON 响应)

{
  "ok": true,
  "output_path": "/Users/me/exports/q1_summary.csv",
  "rows_written": 3,
  "errors": []
}

CSV 列： filename, document_type, vendor_merchant, date, number, subtotal, tax, total, currency, due_date, payment_method

支持的格式

PDF（发票、扫描文档）
PNG, JPG, WEBP（收据照片、截图）

身份验证

免费层级： 每月 20 次解析（需 API 密钥，请在 plenitudo.ai 获取）

按需付费 (x402)： 无需账户。向钱包地址发送 Base 链上的 USDC，并将交易哈希作为 payment_proof 传入。

{
  "error": "Payment required",
  "x402": {
    "network": "base",
    "token": "USDC",
    "recipient": "0x9053FeDC90c1BCB4a8Cf708DdB426aB02430d6ad",
    "amount_usdc": 0.05
  }
}

使用方法 (Claude Desktop / MCP 客户端)

{
  "mcpServers": {
    "invoice-parser": {
      "url": "https://invoice-parser.plenitudo.ai/mcp?ref=readme"
    }
  }
}

架构

server.py          — MCP server (6 tools: parse_invoice, parse_receipt,
                     extract_line_items, extract_totals, validate_invoice,
                     export_to_csv)
auth.py            — API key validation + usage tracking (SQLite)
x402.py            — x402 micropayment verification (USDC on Base)
config.py          — Environment variable loading
worker.js          — Cloudflare Worker (remote proxy for MCP traffic)
data/keys.db       — API key store (created at runtime)
data/usage.db      — Monthly usage counters (created at runtime)
logs/              — Structured log files
tests/             — Unit tests (mock Vision API, no real documents needed)

请求流程

AI agent (Claude Desktop, Cursor, etc.)
    │
    │  MCP tool call (JSON-RPC over HTTP)
    ▼
Cloudflare Worker (worker.js)        ← optional remote proxy
    │
    │  Forwards to Railway deployment
    ▼
server.py (FastMCP, streamable HTTP)
    │
    ├── auth.py              validates API key / x402 proof
    ├── x402.py              verifies USDC transaction on Base
    └── Anthropic API        Claude Vision reads the document
            │
            ▼
        structured JSON → returned to agent

环境变量

变量	必需	描述
`ANTHROPIC_API_KEY`	是	用于 Claude Vision 的 Anthropic API 密钥。设置为 `maxproxy` 以进行本地代理路由。
`ANTHROPIC_BASE_URL`	否	覆盖 Anthropic 基础 URL。在本地使用 maxproxy 时设置为 `http://localhost:3456`。云部署中请留空。
`CLAUDE_MODEL`	否	Claude 模型 ID。默认为 `claude-3-5-sonnet-20241022`。
`INVOICEPARSER_DATA_DIR`	否	SQLite 数据库目录。默认为 `./data`。
`PORT`	否	HTTP 端口。默认为 `8000`。Railway 会自动设置此项。

部署 (Railway)

Fork 此仓库
连接到 Railway → 新建项目 → 从 GitHub 部署
添加环境变量：
- ANTHROPIC_API_KEY — 您的 Anthropic API 密钥
- INVOICEPARSER_DATA_DIR — /data
- STRIPE_WEBHOOK_SECRET — 从 Stripe 控制面板获取
- STRIPE_PRO_PRICE_ID — 从 Stripe 控制面板获取
在 /data 处添加持久化卷
部署

本地运行 (可选 maxproxy 路由)

如果您在与 maxproxy 实例相同的机器上运行服务器（端口 3456），则可以通过它路由 Claude Vision 调用，而不是直接访问 Anthropic API：

ANTHROPIC_API_KEY=maxproxy
ANTHROPIC_BASE_URL=http://localhost:3456

在任何云/Railway 部署中，请保持 ANTHROPIC_BASE_URL 未设置（或为空）—— 这些环境无法访问本地代理。

贡献与安全

CONTRIBUTING.md — 开发设置和 PR 指南
SECURITY.md — 负责任的披露政策
CHANGELOG.md — 版本历史

许可证

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Document to JSON – PDF Invoice/Statement/Contract ParserOAuth
io.github.fashionmascherine-svg
Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts.
Finance AI & Machine Learning
28
Invoice & Receipt OCR Extractor to ExcelOAuth
com.ranovam
Invoice and receipt extractor: reads PDF and image invoices/receipts with AI, pulling date…
Finance AI & Machine Learning Image & Video Processing
1
parsedoc
fr.custom-digital-services
Agent-native document parsing: PDF, scans and FR/EU invoices to structured JSON or Markdown.
Research & Data
2
DatanemOAuth
com.datanem
Turn PDFs, scans and photos into a queryable database. Invoices, CVs, receipts, in bulk.
AI & Machine Learning Data Platforms Image & Video Processing
1

Related MCP Servers

aifais-mcp-server
Developer Tools Knowledge & Memory Security
AIFAIS
F
license
B
quality
Not graded
maintenance
Headless document processing for AI agents. Invoice extraction, contract analysis, and Dutch business verification. Pay-per-use via X402 on Solana. No API keys needed.
Updated 8 months ago (2026-01-08 17:03 UTC)
10
1
-
kelnix-receipt-mcp-api
Finance Image & Video Processing App Automation
kelnixsolutions
A
license
Not graded
quality
B
maintenance
Turn any receipt into structured, accounting-ready JSON or clean Markdown with one API call. AI-powered vision extracts merchant, date, line items, tax, totals, and suggests GL accounts for instant bookkeeping. 50 free credits on signup.
Updated 25 days ago (2026-08-14 07:53 UTC)
MIT
document-to-json-mcp
Data Platforms AI & Machine Learning
fashionmascherine-svg
A
license
A
quality
B
maintenance
Convert PDFs to structured JSON. Extract invoices, bank statements, contracts, and more. Pay per call via x402 USDC.
Updated 2 months ago (2026-06-25 16:25 UTC)
5
8
MIT
document-intelligence-server
Text Summarization Image & Video Processing AI & Machine Learning
KennyWayn3
A
license
Not graded
quality
B
maintenance
Enables intelligent document processing by extracting text, classifying document types, and generating structured summaries from PDFs and images using vision LLMs.
Updated 2 months ago (2026-07-11 07:32 UTC)
MIT

Appeared in Searches

发票识别

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/knportal/invoice-parser-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Invoice Parser MCP

功能说明

工具

工具参考

parse_invoice

parse_receipt

extract_line_items

extract_totals

validate_invoice

export_to_csv

支持的格式

身份验证

使用方法 (Claude Desktop / MCP 客户端)

架构

部署 (Railway)

本地运行 (可选 maxproxy 路由)

贡献与安全

许可证

Tool Schema Changelog

Maintenance

Resources

Looking for Admin?

Related MCP Connectors

Related MCP Servers

aifais-mcp-server

kelnix-receipt-mcp-api

document-to-json-mcp

document-intelligence-server

Appeared in Searches

Latest Blog Posts

MCP directory API

`parse_invoice`

`parse_receipt`

`extract_line_items`

`extract_totals`

`validate_invoice`

`export_to_csv`