meterpay-mcp
v1.0.1
Published
Pay-per-call AI capability market as an MCP server: multi-model chat, prompt packs, code templates, commercial licenses, compliance precheck and compute quotes. Every tool priced individually, no charge on failure.
Maintainers
Readme
Pay-Per-Call Gateway · 按次计费的 AI 能力变现中台
一个零依赖的 Python 服务,把「AI 能力」变成「每次调用都收一次钱」的可售卖商品。 同时对外提供 MCP 端点、OpenAPI(给平台插件导入)、落地页、运营后台。
核心不是"做个接口",而是三条腿的收款结构 + 一套可信台账:
| 通道 | 面向谁 | 怎么收 |
|---|---|---|
| 预充值钱包 | 扣子/钉钉/抖音/小程序等平台插件(只能传 header) | 充余额,每次调用扣一次 |
| x402 链上按次 | Claude/Cursor 等 Agent 客户端(没有你的账号) | 带 X-PAYMENT 头,验签通过才干活 |
| 订阅包次 | 已购套餐的客户 | 扣套餐余量,超额转钱包 |
| 平台订单回调 | 微信支付/支付宝/Stripe | HMAC 验签后入账 |
三条硬规矩(这决定的不是能不能跑,而是会不会亏钱)
- 失败不扣费。上游挂了、SKU 不存在、参数不对,一律 0 收入,只记失败台账。 卖空的调用比少收一笔更贵——退款和投诉成本远高于单价。
- 本地永不判定付款有效。签名真伪、余额、nonce 是否已消费,只有 facilitator 知道。 本地只校「结构完整 / 收款地址一致 / 金额够 / 没过期」,其余全部交给 facilitator。
- 先干活,成功才结算。x402 做不到"先收钱再干活"——链上交易不可逆, 业务失败就退不回去。顺序必须是 verify → 执行 → settle。
快速开始
方式一:直接用已发布的 npm 包(推荐)
npx -y meterpay-mcp已上架:https://www.npmjs.com/package/meterpay-mcp · v1.0.0
(原名 pay-per-call-mcp 被他人占用,paypercall-mcp 被 npm 判为名称过于相似而拒收,
最终用 meterpay-mcp 发布。)
方式二:本地跑服务端
cd D:/workbuddy-projects/pay-per-call-gateway
cp .env.example .env # 填上游 key、后台令牌、x402 收款地址
python app.py.env 在启动时自动加载(已被 .gitignore 忽略),已存在的环境变量优先,
所以 DEEPSEEK_API_KEY=xxx python app.py 这种临时覆盖仍然有效。
启动后:
| 入口 | 地址 | |---|---| | 落地页(引流转化) | http://127.0.0.1:8300/ | | MCP 端点 | POST http://127.0.0.1:8300/mcp | | REST 包装 | POST http://127.0.0.1:8300/x/llm.chat | | OpenAPI(平台导入) | http://127.0.0.1:8300/openapi.json | | 给 Agent 读的说明 | http://127.0.0.1:8300/llms.txt | | 运营后台 | http://127.0.0.1:8300/admin |
首次启动会在 data/ 下生成:
admin_token.txt—— 运营后台令牌gateway-bootstrap.txt—— 两个演示租户的 API Key($5 钱包 / $20 套餐)license_secret.txt—— 授权凭证签名密钥,务必备份,丢了老凭证就验不过gateway.db—— sqlite,全部账在里边,单文件即可备份/迁移
接入方式
1. MCP 客户端(Claude Desktop / Cursor / Cline)
{
"mcpServers": {
"meterpay": {
"command": "npx",
"args": ["-y", "meterpay-mcp"],
"env": {
"PPC_GATEWAY": "https://你的域名",
"PPC_API_KEY": "ppc_live_xxx"
}
}
}
}在本机调试服务端时,把上面换成直接指向本地文件:
{
"mcpServers": {
"meterpay-local": {
"command": "node",
"args": ["D:/workbuddy-projects/pay-per-call-gateway/bin/ppc-mcp.js"],
"env": {
"PPC_GATEWAY": "http://127.0.0.1:8300",
"PPC_API_KEY": "ppc_live_xxx"
}
}
}
}也可以直接用 HTTP 传输,不用 node:
{ "mcpServers": { "pay-per-call": {
"type": "http", "url": "http://127.0.0.1:8300/mcp",
"headers": { "X-API-Key": "ppc_live_xxx" } } } }2. 平台插件(扣子/钉钉/抖音/支付宝)
用 platforms/openapi-3.0.yaml(已按 OpenAPI 3.0 写,这些平台不认 3.1),
把 servers.url 改成你的域名后导入。每个 /x/<tool> 就是一个插件工具。
3. x402 按次付款(无需注册)
curl -s -X POST http://127.0.0.1:8300/mcp \
-H 'Content-Type: application/json' \
-H 'X-PAYMENT: <base64 的 x402 payload>' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"prompt.pack.get","arguments":{"sku":"PROMPT-JD-INTERVIEW"}}}'不带 X-PAYMENT 会返回 HTTP 402,响应体里有 accepts(标准 x402 要求)
和 payment_required(金额与充值入口)。
扫码充值(微信 / 支付宝收款码)
落地页 /#topup 已经把收款码接进自助充值。流程刻意做成人工核对,因为
个人/经营收款码没有支付回调,任何声称"扫码即自动到账"的实现都是假的。
用户选套餐 → 扫码付款 → 回填交易号+联系方式
→ POST /topup/claim 生成待审单(防同一交易号重复提交)
→ 后台「待核对充值」看到单子,比对微信/支付宝账单
→ 点「开通」→ 新建租户、发放等值额度、返回一次性 API Key
→ 客户拿 Key 调 MCP/REST,按次扣费| 端点 | 用途 |
|---|---|
| GET /topup | 套餐、收款码、汇率、流程说明 |
| GET /assets/pay-wechat.jpg | 微信经营收款码 |
| GET /assets/pay-alipay.jpg | 支付宝收款码 |
| POST /topup/claim | 提交付款凭证,返回 topup_id |
| GET /admin/api/topups?status=pending | 待核对列表(需后台令牌) |
| POST /admin/api/topups/approve | 确认到账并开通,{"topup_id":"..."} |
| POST /admin/api/topups/reject | 驳回,{"topup_id":"...","reason":"..."} |
套餐与汇率都在 config/gateway.json 的 topup 段:当前 1 USD 额度 = ¥7.5,
¥15→$2、¥75→$10、¥375→$50、¥1500→$200。改完重启即生效。
收款码图片不入库:web/assets/pay-*.jpg 已在 .gitignore 里。收款码含实名与收款
信息,公开到 GitHub 有被他人冒用(跑分、冒充收款)的风险,所以只放本机 web/assets/,
部署时单独上传。缺失时页面会显示占位提示,不会白屏。
四道防错(已自测):
- 同一交易号 + 同一渠道,第二次提交直接 409,防止一笔钱报两次。
- 已开通的单再点开通 → 409
already_approved,防止双倍给额度。 - 已驳回的单不能开通 → 409
already_rejected。 - 不存在的单号 → 404,不能凭空发额度。
合规提醒(重要):微信那张带「经营」标识,属于经营收款码,可用于经营收款; 支付宝那张是个人收款码,按央行规定不得用于经营性收款,长期使用有被限制风险。 建议支付宝换「商家收款码」或签当面付。见
docs/上架与收费清单.md的 「收款码合规」一节。个人收款码单笔建议 ≤ ¥200。
工具清单(= 收款线)
| 工具 | 收入线 | USD/次 |
|---|---|---|
| llm.chat | AI 接口按调用计费 | 0.0015 |
| agent.consume | 智能体订阅包次 | 0.004 |
| mcp.skill.invoke | MCP 技能代理 | 0.004 |
| prompt.pack.get | 提示词包 | 0.02 起 |
| code.template.get | 源码模板 | 0.09 起 |
| asset.license.issue | 商用素材授权 | 0.03 |
| plugin.license.activate | 插件授权 | 0.05 |
| compute.quote | 算力分销 | 0.002 |
| kb.answer | 知识付费/社群 | 0.01 |
| content.brief | 内容商单 | 0.005 |
| custom.quote | 定制外包(收线索) | 免费 |
| policy.check | 合规预检 | 免费 |
| asset.catalog pricing.list usage.report | 货架/查价/对账 | 免费 |
免费工具不是慈善:Agent 能自己查价、自己核对账单,你的客服工单会少一大半。
上新品 / 调价
- 调价:后台「调价」输入 USD 单价保存,立即生效(
pricing.json热重载,不重启)。 - 上新品(交付类):往
inventory/prompts/或inventory/templates/丢一个 JSON (结构见现有文件),然后POST /admin/api/reload,asset.catalog立刻能看到。 - 上新品(能力类):在
config/pricing.json加一条 → 在tools.py加一个h_xxx方法 → 在TOOL_SCHEMAS加 schema。三处,其余全自动(MCP 列表、OpenAPI、价目表、计费)。
自测
python scripts/smoke_test.py会起一个假 facilitator 和独立实例(独立 db、独立价目表副本),把 48 项全跑一遍:免费工具不计费、无凭证 402、钱包扣费、失败不扣费、x402 结算拿 txHash、 nonce 重放被拒、收款地址不符被拒、金额不足被拒、乱码付款头不放行、 REST 包装、后台越权、台账毛利、调价生效。
不依赖网络,也不污染正式数据。
上生产前必改
config/gateway.json→public_base_url改成真实域名(x402 的 resource 要用它)x402.pay_to改成你的钱包地址 —— 不填就自动关闭 x402(现在的默认值是零地址)- 测试网
base-sepolia→ 主网base时,network和asset必须一起改 - 每个平台一个租户(
channel分清 coze/dingtalk/wechat...),否则对账时分不清钱从哪来 data/license_secret.txt备份好;对外卖授权建议改非对称签名,把公钥给买方- 上游模型的 key 用环境变量注入(
DEEPSEEK_API_KEY等),不要写进配置文件
上架策略
见 docs/上架与收费清单.md:哪些平台真能收到钱、哪些只是引流位、
你那 50 多个平台里哪 16 个其实是成本项而不是渠道,以及 30 天上架顺序。
一句话结论:先把 A 类(自有结算)+ C 类(x402)跑起来, B 类(平台内结算)排队等资质,D 类(开放平台)只做曝光。
目录
app.py HTTP 服务 + MCP 协议 + 路由 + 后台 API
billing.py 计费内核:租户/钱包/套餐/台账/汇总/签名
payments.py x402 verify+settle、webhook 验签
tools.py 15 个工具实现(每条收款线一个 handler)
config/pricing.json 价目表(热重载)
config/providers.json 上游模型路由与成本表(压毛利的地方)
config/gateway.json 服务配置
inventory/ 可售库存(提示词包/源码模板/知识库)
web/ 落地页 + 运营后台
bin/ppc-mcp.js npm 插件的 stdio 桥
platforms/ 平台导入用 OpenAPI 3.0
scripts/smoke_test.py 48 项端到端自测(计费/x402/鉴权/调价)
scripts/topup_test.py 25 项扫码充值自测(提交/防重/审核/发key/扣费)