Stripe Agent Toolkit

Stripe Agent Toolkit 是一个基于 Model Context Protocol (MCP) 的支付开发工具包，支持多种 AI 框架（如 OpenAI、LangChain、CrewAI）与 Stripe API 的集成。该工具包提供 Python 和 TypeScript 两种语言支持，帮助开发者快速实现支付功能，包括客户管理、产品定价、支付链接生成、订阅管理等。通过 MCP 协议，开发者可以更灵活地在模型上下文中调用 Stripe API，实现自动化支付流程。

核心功能

Stripe Agent Toolkit 提供了丰富的 Stripe API 方法支持，涵盖支付流程的多个方面，包括：

客户管理：创建和列出客户信息。
优惠券管理：创建和列出优惠券。
产品与价格管理：创建和列出产品及价格。
支付链接生成：生成支付链接，方便用户完成支付。
发票管理：创建发票、发票项，完成发票。
订阅管理：列出、更新和取消订阅。
退款管理：创建退款。
余额查询：获取账户余额。

此外，该工具包还支持 MCP 协议，允许开发者通过模型上下文协议与 Stripe API 进行交互，实现更灵活的支付集成。

安装方法

Stripe Agent Toolkit 提供了 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();

使用方法

Stripe Agent Toolkit 提供了多种使用方式，包括命令行工具和自定义服务器实现。

运行 MCP 服务器

可以通过命令行快速启动 Stripe MCP 服务器：

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

该命令会启动一个支持所有工具的 MCP 服务器，并使用指定的 Stripe API 密钥进行初始化。

自定义服务器实现

开发者也可以通过自定义代码实现 MCP 服务器，例如：

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.payment_links.create({
  line_items: [{ price: 'price_123', quantity: 1 }],
  mode: 'payment',
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
});

该操作将返回一个支付链接地址，用户可以通过该链接完成支付。

更新订阅

开发者可以使用 Stripe API 更新现有客户的订阅计划，例如：

stripe.subscriptions.update('sub_123', {
  items: [{ price: 'price_456' }],
  proration_behavior: 'create_prorations',
});

该操作将更新订阅计划，并返回更新后的订阅信息。

使用场景

Stripe Agent Toolkit 适用于多种应用场景，包括：

电商网站：用于管理客户、产品、价格和支付流程。
SaaS 平台：支持订阅管理、发票生成和退款处理。
自动化支付流程：通过 MCP 协议与 AI 框架集成，实现自动化支付操作。

注意事项

在使用 Stripe Agent Toolkit 时，需要注意以下事项：

需要有效的 Stripe API 密钥才能运行。
对于高级功能可能需要额外的开发工作。
建议在正式部署前进行充分测试。

Stripe Agent Toolkit 通过提供丰富的 API 支持和灵活的集成方式，帮助开发者高效地构建支付相关功能，适用于多种业务场景。

支付集成 Stripe API MCP协议

全部分类

详细介绍