Stripe Agent Toolkit

🚀 Stripe 代理工具包

Stripe 代理工具包为开发者提供了便捷的方式来集成 Stripe 的支付服务。它支持多种 API 方法，涵盖客户管理、优惠券创建、产品定价等功能，同时还支持模型上下文协议（MCP）。

🚀 快速开始

本工具包提供了 Python 和 TypeScript 两个版本，以下是具体的安装与配置步骤。

📦 安装指南

Python 版本

1. 安装：

pip install stripe

2. 初始化项目：

import os
from stripe.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();

✨ 主要特性

支持的 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），你可以通过以下方式使用：

1. 运行 MCP 服务器：

npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

2. 自定义服务器实现：

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 版本