Stripe AI

本仓库是构建基于 Stripe 的 AI 产品和业务的一站式解决方案。

它包含一组 SDK，帮助您通过函数调用将 Stripe 与 LLM 和代理框架集成，包括：

• @stripe/agent-toolkit - 通过函数调用将 Stripe API 与流行代理框架集成——支持 Python 和 TypeScript。
• @stripe/ai-sdk - 将 Stripe 的计费基础设施与 Vercel 的 ai 和 @ai-sdk 库集成。
• @stripe/token-meter - 将 Stripe 的计费基础设施与 OpenAI、Anthropic 和 Google Gemini 的原生 SDK 集成，无需任何框架依赖。

模型上下文协议 (MCP)

Stripe 在 https://mcp.stripe.com 提供远程 MCP 服务器。这允许通过 OAuth 安全访问 MCP 客户端。文档请查看 此处。

Stripe Agent Toolkit 也以 模型上下文协议 (MCP) 格式暴露工具。或者，使用 npx 运行本地 Stripe MCP 服务器，请使用以下命令：

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

工具权限由您的受限 API 密钥 (RAK) 控制。请在 Stripe 控制台 创建具有所需权限的 RAK。

更多详情请查看 MCP。

Agent 工具包

Stripe 的 Agent 工具包使流行的代理框架（包括 OpenAI 的 Agent SDK、LangChain、CrewAI 和 Vercel 的 AI SDK）能够通过函数调用与 Stripe API 集成。该库并非涵盖整个 Stripe API，但支持 Python 和 TypeScript，并直接基于 Stripe 的 Python 和 Node SDK 构建。

以下为基本说明，更多信息请参考 Python 和 TypeScript 包。

Python

安装

除非您需要修改包，否则无需此源代码。如果您只需使用包，请运行：

pip install stripe-agent-toolkit

要求

• Python 3.11+

使用

库需要配置您的账户密钥，该密钥可在 Stripe 控制台 中找到。我们强烈建议使用 受限 API 密钥 (rk_*) 以提高安全性和权限粒度。工具的可用性由您在受限密钥上配置的权限决定。

from stripe_agent_toolkit.openai.toolkit import create_stripe_agent_toolkit

async def main():
    toolkit = await create_stripe_agent_toolkit(secret_key="rk_test_...")
    tools = toolkit.get_tools()
    # ... 使用工具 ...
    await toolkit.close()  # 使用完毕后清理

该工具包与 OpenAI 的 Agent SDK、LangChain 和 CrewAI 兼容，可以作为工具列表传递。例如：

from agents import Agent

async def main():
    toolkit = await create_stripe_agent_toolkit(secret_key="rk_test_...")

    stripe_agent = Agent(
        name="Stripe Agent",
        instructions="您是擅长与 Stripe 集成的专家",
        tools=toolkit.get_tools()
    )
    # ... 使用代理 ...
    await toolkit.close()

OpenAI 的 Agent SDK、LangChain 和 CrewAI 的示例包含在 /examples 中。

上下文

在某些情况下，您可能需要提供默认值以在请求时使用。目前，account 上下文值允许您为 连接账户 发起 API 请求。

toolkit = await create_stripe_agent_toolkit(
    secret_key="rk_test_...",
    configuration={
        "context": {
            "account": "acct_123"
        }
    }
)

TypeScript

安装

除非您需要修改包，否则无需此源代码。如果您只需使用包，请运行：

npm install @stripe/agent-toolkit

要求

• Node 18+

从 v0.8.x 升级

如果您从 v0.8.x 升级，请查看 迁移指南 了解重大变更。

使用

库需要配置您的账户密钥，该密钥可在 Stripe 控制台 中找到。我们强烈建议使用 受限 API 密钥 (rk_*) 以提高安全性和权限粒度。工具的可用性由您在受限密钥上配置的权限决定。

import { createStripeAgentToolkit } from "@stripe/agent-toolkit/langchain";

const toolkit = await createStripeAgentToolkit({
  secretKey: process.env.STRIPE_SECRET_KEY!,
  configuration: {},
});

const tools = toolkit.getTools();
// ... 使用工具 ...

await toolkit.close(); // 使用完毕后清理

工具

该工具包与 LangChain 和 Vercel 的 AI SDK 兼容，可以作为工具列表传递。例如：

import { AgentExecutor, createStructuredChatAgent } from "langchain/agents";
import { createStripeAgentToolkit } from "@stripe/agent-toolkit/langchain";

const toolkit = await createStripeAgentToolkit({
  secretKey: process.env.STRIPE_SECRET_KEY!,
  configuration: {},
});

const tools = toolkit.getTools();

const agent = await createStructuredChatAgent({
  llm,
  tools,
  prompt,
});

const agentExecutor = new AgentExecutor({
  agent,
  tools,
});

上下文

在某些情况下，您可能需要提供默认值以在请求时使用。目前，account 上下文值允许您为 连接账户 发起 API 请求。

const toolkit = await createStripeAgentToolkit({
  secretKey: process.env.STRIPE_SECRET_KEY!,
  configuration: {
    context: {
      account: "acct_123",
    },
  },
});

支持的 API 方法

请查看 Stripe MCP 文档了解支持的方法列表。

许可证

MIT

Stripe AI 快速上手指南

环境准备

• Python：3.11+
• Node.js：18+
• 依赖：Stripe SDK（Python/node）

安装步骤

# Python环境
pip install stripe-agent-toolkit

# TypeScript环境
npm install @stripe/agent-toolkit

基本使用

Python示例

from stripe_agent_toolkit.openai.toolkit import create_stripe_agent_toolkit

async def main():
    toolkit = await create_stripe_agent_toolkit(secret_key="rk_test_...")
    tools = toolkit.get_tools()
    # ... 使用工具 ...
    await toolkit.close()

TypeScript示例

import { createStripeAgentToolkit } from "@stripe/agent-toolkit/langchain";

const toolkit = await createStripeAgentToolkit({
  secretKey: process.env.STRIPE_SECRET_KEY!,
  configuration: {},
});

const tools = toolkit.getTools();
// ... 使用工具 ...
await toolkit.close();