🚀 Stripe 代理工具包
Stripe 代理工具包为开发者提供了便捷的方式来集成 Stripe 的支付服务。它支持多种 API 方法，涵盖客户管理、优惠券创建、产品定价等功能，同时还支持模型上下文协议（MCP）。
🚀 快速开始
本工具包提供了 Python 和 TypeScript 两个版本，以下是具体的安装与配置步骤。
📦 安装指南
Python 版本
- 安装：
pip install stripe
- 初始化项目：
import os
from stripe.AgentToolkit import Agent
# 配置 API 密钥
os.environ["STRIPE_SECRET_KEY"] = "your_stripe_secret_key"
# 初始化代理工具包
agent = Agent()
TypeScript 版本
- 安装：
npm install @stripe/agent-toolkit
- 初始化项目：
import { Agent } from '@stripe/agent-toolkit';
// 配置 API 密钥
process.env.STRIPE_SECRET_KEY = 'your_stripe_secret_key';
// 初始化代理工具包
const agent = new Agent();
✨ 主要特性
支持的 API 方法
本工具包支持丰富的 Stripe API 方法，涵盖客户、优惠券、产品、价格、支付链接、发票等多个方面的管理：
- 创建客户：
stripe.customers.create - 列出所有客户：
stripe.customers.list - 创建优惠券：
stripe.coupons.create - 列出所有优惠券：
stripe.coupons.list - 创建产品：
stripe.products.create - 列出所有产品：
stripe.products.list - 创建价格：
stripe.prices.create - 列出所有价格：
stripe.prices.list - 创建支付链接：
stripe.payment_links.create - 创建发票：
stripe.invoices.create - 创建发票项：
stripe.invoice_items.create - 完成发票：
stripe.invoices.finalize - 获取余额：
stripe.balance.retrieve - 列出所有订阅：
stripe.subscriptions.list - 更新订阅：
stripe.subscriptions.update - 取消订阅：
stripe.subscriptions.cancel - 创建退款：
stripe.refunds.create
模型上下文协议 (MCP) 支持
本工具包支持模型上下文协议（MCP），你可以通过以下方式使用：
- 运行 MCP 服务器：
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY
- 自定义服务器实现：
import { StripeAgentToolkit } from '@stripe/agent-toolkit/modelcontextprotocol';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
const server = new StripeAgentToolkit({
secretKey: process.env.STRIPE_SECRET_KEY!,
configuration: {
actions: {
paymentLinks: {
create: true,
},
products: {
create: true,
},
prices: {
create: true,
},
},
},
});
async function main() {
const transport = new StdioServerTransport();
await server.connect(transport);
console.error("Stripe MCP Server 运行于标准输入输出");
}
main().catch((error) => {
console.error("主程序发生致命错误:", error);
process.exit(1);
});
📚 详细文档
如需了解更多关于 Stripe Agent Toolkit 的信息，请参考以下资源：
- Stripe 官方文档：https://stripe.com/docs
- GitHub 仓库：