Stripe Agent Toolkit

🚀 Stripe 代理工具包

Stripe 代理工具包为开发者提供了便捷的方式来与 Stripe 的支付系统进行交互。它支持多种 API 方法，涵盖客户管理、优惠券创建、产品定价等功能，并且还提供了模型上下文协议 (MCP) 的支持，方便开发者进行定制化开发。

🚀 快速开始

本工具包支持 Python 和 TypeScript 两种语言版本，下面为你详细介绍安装与初始化步骤。

📦 安装指南

Python 版本

1. 安装：

   pip install stripe
   

2. 初始化项目：

   import os
   fromstripe.AgentToolkit import Agent
   
   # 配置 API 密钥
   os.environ["STRIPE_SECRET_KEY"] = "your_stripe_secret_key"
   
   # 初始化代理工具包
   agent = Agent()
   

TypeScript 版本

1. 安装：

   npm install @stripe/agent-toolkit
   

2. 初始化项目：

   import { Agent } from '@stripe/agent-toolkit';
   
   // 配置 API 密钥
   process.env.STRIPE_SECRET_KEY = 'your_stripe_secret_key';
   
   // 初始化代理工具包
   const agent = new Agent();
   

✨ 主要特性

本工具包支持丰富的 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 仓库：
  • Python 版本
  • TypeScript 版本