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