payport

payport

payport 为 Agent 提供了一个可用的入口来操作 Stripe 账户：打开客户记录，在目录中添加产品和价格，为买家提供托管支付链接，起草发票并完成定稿，查看余额，退款，发放优惠券，处理争议，以及管理订阅。每项操作都会调用一次 Stripe REST API，API 返回的 JSON 会原样传回。它可以通过命令行运行，也可以作为供 Agent 使用的 MCP 服务运行。

需要 Stripe 密钥。将密钥放入 STRIPE_SECRET_KEY 环境变量；密钥会作为 Bearer 令牌发送给 API，绝不会出现在输出中。缺少此变量时，每项操作都会失败，并报错指出该变量。

安装

npx @reneturcios/payport list-customers --limit 5

也可以运行容器镜像：

docker run -i -e STRIPE_SECRET_KEY ghcr.io/cloudcorprecords/payport

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

export STRIPE_SECRET_KEY="your secret key"

payport create-customer --name "Ada Lovelace" --email [email protected]
payport list-customers --email [email protected] --limit 5
payport create-product --name "Trail Guide" --description "A field guide"
payport list-products --limit 10
payport retrieve-balance

payport --version

退出代码：成功时为 0，API 调用失败时为 1（包括缺少 STRIPE_SECRET_KEY 的情况），用法错误时为 2。

MCP 服务

同一个二进制文件提供两种用途。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/payport mcp

MCP 客户端配置：

{
  "mcpServers": {
    "payport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/payport", "mcp"],
      "env": { "STRIPE_SECRET_KEY": "your secret key" }
    }
  }
}

工具

工具	输入	功能
create_customer	name（字符串，必填），email（字符串，可选）	创建客户。
list_customers	email（字符串，可选），limit（整数，可选）	列出客户，可按完全匹配的邮箱筛选。
create_product	name（字符串，必填），description（字符串，可选）	创建目录产品。
list_products	limit（整数，可选）	列出产品。
create_price	product、currency、unit_amount（均必填）	为产品创建价格；unit_amount 以货币最小单位计。
list_prices	product（可选），limit（可选）	列出价格，可指定单个产品。
create_payment_link	price、quantity（必填），redirect_url（可选）	创建托管支付链接。
list_payment_intents	customer（可选），limit（可选）	列出支付意向。
create_invoice	customer（必填），days_until_due（可选）	创建通过电子邮件发送的草稿发票（send_invoice）。
create_invoice_item	customer、price、invoice（均必填）	向草稿发票添加带价格的行项目。
list_invoices	customer（可选），limit（可选）	列出发票。
finalize_invoice	invoice（必填）	完成草稿发票。
retrieve_balance	—	获取账户余额。
create_refund	payment_intent（必填），amount（可选）	全额或部分退还支付意向。
create_coupon	duration（必填），percent_off、amount_off、currency、name、duration_in_months（可选）	创建优惠券。
list_coupons	limit（可选）	列出优惠券。
list_disputes	charge、payment_intent、limit（均可选）	列出争议。
update_dispute	dispute（必填），evidence（对象，可选），submit（布尔值，可选）	为争议添加证据，并可选择提交。
list_subscriptions	customer、status、limit（均可选）	列出订阅。
cancel_subscription	subscription（必填）	取消订阅。
update_subscription	subscription（必填），price、cancel_at_period_end（可选）	更新订阅。

这是 Stripe Agent 工具包 22 工具 MCP 集合中有文档说明的核心子集：未实现 search_stripe_documentation（托管文档搜索，并非 Stripe API 操作）。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

许可证

MIT — 参见 LICENSE。