Kelnix Receipt Mcp Api

🧾 Kelnix Receipt MCP API

通过一次 API 调用，将任意收据转换为适用于会计处理的结构化 JSON。AI 视觉可提取所有信息——商家、日期、商品明细、税费、总额——并推荐总账科目，实现即时记账。

专为自动处理费用管理、应付账款和记账的 AI Agent 打造。没有控制面板，无需登录——只有一个支持 MCP 的 API。

🎁 注册即可获得 50 个免费额度，无需信用卡。

🌐 在线服务： receipt-mcp-api.kelnix.org — 交互式文档

📧 联系： [email protected] | 🔗 kelnix.org

---

⚡ 快速开始

1️⃣ 注册（即时完成，无需审核）

curl -X POST https://receipt-mcp-api.kelnix.org/register_agent \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-expense-bot"}'

✅ 返回你的 API 密钥和 50 个免费额度。

2️⃣ 处理收据（1 个额度）

curl -X POST https://receipt-mcp-api.kelnix.org/tools/upload_and_process \
  -H "X-API-Key: rct_your-key-here" \
  -F "[email protected]" \
  -F "mime_type=image/jpeg"

✅ 返回结构化 JSON：供应商、日期、商品明细、总额、税费、货币和置信度评分。

3️⃣ 需要时购买更多额度

# 💳 With card (Stripe)
curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000}'

# 🪙 With crypto (300+ coins)
curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits_crypto \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000, "preferred_coin": "eth"}'

---

💰 定价

额度包

额度	价格	每个额度价格
100	$5	$0.050
500	$20	$0.040
1,000	$40	$0.040
5,000	$150	$0.030
10,000	$300	$0.030

📅 订阅

计划	额度/月	价格
🆓 免费	50（注册赠送）	$0
⭐ 基础版	200/月	$15/月
🚀 专业版	2,000/月	$99/月

🔧 工具费用

工具	费用
receipts.process	1 个额度
receipts.upload_and_process	1 个额度
accounting.suggest_gl_account	1 个额度
receipts.upload	🆓 免费
receipts.get_markdown	🆓 免费
credits.check_balance	🆓 免费
receipts.list	🆓 免费

也可通过 GET /pricing 查看完整定价（无需身份验证）。

---

📖 API 参考

🔧 工具

方法	端点	费用	说明
POST	/tools/upload_receipt	免费	上传收据图片/PDF
POST	/tools/process_receipt	1 个额度	提取结构化数据
POST	/tools/upload_and_process	1 个额度	一次调用完成上传和处理（幂等）
POST	/tools/get_receipt_markdown	免费	获取已处理收据的 Markdown 格式
POST	/tools/suggest_gl_account	1 个额度	AI 推荐总账科目代码
POST	/tools/check_balance	免费	查看额度和计划
POST	/tools/list_receipts	免费	按筛选条件列出收据
POST	/tools/process_receipt_async	1 个额度	将处理任务加入异步队列（需要 Redis）

💳 计费

方法	端点	说明
POST	/billing/buy_credits	购买额度包（Stripe Checkout）
POST	/billing/subscribe	订阅月度计划
POST	/billing/buy_credits_crypto	使用 300 多种加密货币购买额度
POST	/billing/check_payment_status	查看加密货币支付状态
GET	/billing/balance	查看完整余额和交易记录

📡 发现与信息

方法	端点	说明
GET	/mcp	包含架构、示例和约束的工具目录
GET	/.well-known/mcp.json	MCP 服务发现元数据
GET	/pricing	公开定价（无需身份验证）
GET	/legal/terms	服务条款
GET	/legal/privacy	隐私政策
GET	/integrations	LangGraph、CrewAI、AutoGen 的代码片段
GET	/docs	交互式 Swagger 文档
GET	/health	健康检查

🔐 身份验证

所有工具和计费端点都需要 X-API-Key 标头。通过 POST /register_agent 获取密钥。

当额度用尽时，付费端点会返回 402，并附上购买更多额度的链接：

{
  "error": "Insufficient credits: 0 available, 1 required.",
  "buy_credits_url": "/billing/buy_credits",
  "buy_credits_crypto_url": "/billing/buy_credits_crypto",
  "pricing_url": "/pricing",
  "cheapest_option": "100 credits for $5.00"
}

---

🔌 MCP 协议

可与 Claude Desktop、Cursor 以及任何兼容 MCP 的客户端配合使用：

{
  "mcpServers": {
    "kelnix-receipt": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
    }
  }
}

也可通过 /.well-known/mcp.json 发现，并已列入 Smithery.ai。

---

🧩 框架集成

GET /integrations 会返回可直接使用的代码，适用于：

框架	集成方式
🦜 LangGraph	工具节点集成
🚢 CrewAI	BaseTool 子类
🤖 AutoGen	已注册函数
🐍 原始 Python	使用 httpx 实现的完整流程

完整实现请参阅 examples/ 目录。

---

🪙 加密货币支付

可使用 BTC、ETH、SOL、USDC、USDT、DOGE 及另外 280 多种加密货币付款。额度以美元计价，加密货币金额按当前汇率锁定约 20 分钟。

curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits_crypto \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000, "preferred_coin": "btc"}'

返回付款地址和确切金额。确认后会自动发放额度。

---

🛠️ 自托管

git clone https://github.com/kelnixsolutions/Kelnix-Receipt-MCP-API.git
cd Receipt-Accounting-Entry-MCP-Server
pip install -r requirements.txt
export ANTHROPIC_API_KEY=sk-ant-...
uvicorn app:app --host 0.0.0.0 --port 8000

需要 Python 3.11+。使用 nginx、SSL 和 systemd 进行生产环境部署，请参阅 deploy/setup.sh。

变量	必需	说明
ANTHROPIC_API_KEY	✅ 是	用于 Claude 视觉功能的 Anthropic API 密钥
STRIPE_SECRET_KEY	❌ 否	用于计费的 Stripe 密钥
STRIPE_WEBHOOK_SECRET	❌ 否	Stripe webhook 签名密钥
NOWPAYMENTS_API_KEY	❌ 否	用于加密货币支付的 NOWPayments API 密钥
REDIS_URL	❌ 否	用于异步处理的 Redis URL

---

📜 许可证

MIT

---

由 Kelnix 倾心打造 ❤️
_{助力新一代 AI 支出 Agent}