mcp-stripe

@codespar/mcp-stripe

Stripe 的 MCP 服务——全球开发者优先支付 API 的标杆

Stripe 与 Stripe ACP

CodeSpar 目录中有两个 Stripe MCP 服务——它们是不同的产品：

Package	封装的 API	适用场景
@codespar/mcp-stripe（本软件包）	Stripe 的常规支付 API（PaymentIntents、Checkout、Billing）	你目前已经在使用 Stripe 收款——对于使用 Stripe 的拉美 SaaS 而言，这是 99% 的情况。
@codespar/mcp-stripe-acp	Stripe 的 Agentic Commerce Protocol	你正在基于 Stripe 新推出的原生 Agent 结账规范进行开发。这是一个范围窄得多、处于最前沿的产品。

如果你是使用 Stripe 作为 PSP 的典型 SaaS，就选这个软件包。

为什么将 Stripe 纳入 CodeSpar 目录？

Stripe 是开发者优先支付服务的全球标杆。几乎所有接受国际银行卡付款的拉美 SaaS 都使用 Stripe——包括 Truora、Platzi、Rappi Pay（用于部分支付流程）以及无数 Y Combinator 拉美公司。加入 Stripe 后，Agent 就能操作这些 SaaS 已在使用的支付体系，无需迁移到本地优先的支付网关。

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

Claude Code

claude mcp add stripe -- npx @codespar/mcp-stripe

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

工具（30 个）

工具	用途
create_payment_intent	创建 PaymentIntent——Stripe 用于向客户收款的现代基础对象。
confirm_payment_intent	确认使用 confirm=false 创建的 PaymentIntent。
retrieve_payment_intent	根据 ID 获取 PaymentIntent。
cancel_payment_intent	取消 PaymentIntent。
list_payment_intents	列出 PaymentIntent。
create_refund	退还一笔扣款或一个 PaymentIntent。
list_refunds	列出退款。
create_customer	创建 Stripe Customer。
retrieve_customer	根据 ID 获取 Customer。
update_customer	更新 Customer。
create_product	创建 Product——Price 所引用的目录实体。
list_products	列出 Product。
create_price	创建关联到 Product 的 Price。
list_prices	列出 Price。
create_subscription	为现有客户创建 Subscription。
update_subscription	更新 Subscription。
cancel_subscription	取消 Subscription。
list_subscriptions	列出 Subscription。
create_checkout_session	创建托管式 Checkout Session。
create_payment_link	创建长期有效的 Payment Link（可分享的 URL），用于收取某个价格或一组行项目的费用。
list_payment_links	列出 Payment Link。
create_invoice	为客户创建 Invoice 草稿。
list_invoices	列出 Invoice。
finalize_invoice	定稿 Invoice 草稿。
send_invoice	通过电子邮件向客户发送已定稿的 Invoice。
pay_invoice	尝试收取未结 Invoice 的款项。
void_invoice	作废已定稿的 Invoice。
update_dispute	提交 Dispute 证据。
list_disputes	列出 Dispute。
retrieve_balance	获取当前 Stripe 账户余额——包括可用、待处理和 connect_reserved 资金，按……分类

身份验证

Stripe 使用一个密钥。密钥前缀决定环境：

• sk_test_... → 测试模式（不会转移真实资金）
• sk_live_... → 线上模式

无需单独设置基础 URL——请求会根据密钥自动路由。设置 STRIPE_SECRET_KEY 即可。

请求正文采用 application/x-www-form-urlencoded 格式，并使用方括号表示法（customer[name]=Foo、metadata[order]=123、expand[]=latest_invoice）。此服务会为你处理嵌套对象和数组。

固定 API 版本

Stripe 会按日历周期自动升级包含破坏性变更的版本。如果你想锁定 Agent 使用的版本，请设置 STRIPE_API_VERSION（例如 2024-06-20）。服务会在每次调用时将其作为 Stripe-Version 标头传递。

环境变量

变量	必需	说明
STRIPE_SECRET_KEY	是	来自 Stripe Dashboard > Developers > API keys 的 sk_test_... 或 sk_live_...
STRIPE_API_VERSION	否	通过 Stripe-Version 标头固定 API 版本（例如 2024-06-20）

沙盒／测试

每个 Stripe 账户都内置测试模式，无需单独注册。使用 sk_test_... 密钥和任意 Stripe 测试卡（例如 4242 4242 4242 4242）。

获取凭据

1. 在 stripe.com 注册
2. 前往 Dashboard > Developers > API keys
3. 复制你的密钥（默认处于测试模式）
4. 设置 STRIPE_SECRET_KEY

路线图

v0.2（计划中）

• update_payment_intent、capture_payment_intent（单独捕获）
• retrieve_refund、list_refunds
• list_customers、search_customers
• update_subscription、retrieve_subscription
• retrieve_invoice、finalize_invoice、pay_invoice、send_invoice、void_invoice
• create_invoice_item、list_invoice_items
• create_price、create_product
• list_charges、retrieve_charge
• retrieve_dispute、close_dispute、list_disputes

v0.3（计划中）

• Stripe Connect：账户、账户链接、转账、付款
• create_setup_intent、confirm_setup_intent（保存卡片以供日后使用）
• PaymentMethod 绑定／解绑／列表
• Webhook 事件构造辅助工具

想更早获得某个工具？提交 issue 或 PR。

链接

• Stripe 网站
• Stripe API 文档
• MCP Dev LATAM
• 落地页

企业版

需要对 Agent 发起的收费、退款和订阅变更实施治理、支出上限和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、支付路由和合规模板。

许可证

MIT