MCP 服务器

stripe

Stripe 模型上下文协议服务器允许你通过函数调用与 Stripe API 集成。该协议支持各种工具来与不同的 Stripe 服务进行交互。

AI集成系统

README

Stripe Agent Toolkit

Stripe Agent Toolkit 使流行的代理框架（包括 OpenAI 的 Agent SDK、LangChain、CrewAI、Vercel 的 AI SDK 和模型上下文协议 (MCP)）能够通过函数调用与 Stripe API 集成。该库并未涵盖整个 Stripe API。它包括对 Python 和 TypeScript 的支持，并且直接构建在 Stripe Python 和 Node SDK 之上。

下面包含基本说明，但有关更多信息，请参阅 Python 和 TypeScript 包。

Python

安装

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

pip install stripe-agent-toolkit

要求

Python 3.11+

用法

该库需要使用您帐户的密钥进行配置，该密钥可在您的 Stripe Dashboard 中找到。

from stripe_agent_toolkit.openai.toolkit import StripeAgentToolkit

stripe_agent_toolkit = StripeAgentToolkit(
    secret_key="sk_test_...",
    configuration={
        "actions": {
            "payment_links": {
                "create": True,
            },
        }
    },
)

该工具包可与 OpenAI 的 Agent SDK、LangChain 和 CrewAI 配合使用，并且可以作为工具列表传递。例如：

from agents import Agent

stripe_agent = Agent(
    name="Stripe Agent",
    instructions="You are an expert at integrating with Stripe",
    tools=stripe_agent_toolkit.get_tools()
)

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

上下文

在某些情况下，您可能希望提供在发出请求时用作默认值的值。目前，account 上下文值使您可以为您的关联账户进行 API 调用。

stripe_agent_toolkit = StripeAgentToolkit(
    secret_key="sk_test_...",
    configuration={
        "context": {
            "account": "acct_123"
        }
    }
)

TypeScript

安装

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

npm install @stripe/agent-toolkit

要求

Node 18+

用法

该库需要使用您帐户的密钥进行配置，该密钥可在您的 Stripe Dashboard 中找到。此外，configuration 使您可以指定可以使用该工具包执行的操作类型。

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

const stripeAgentToolkit = new StripeAgentToolkit({
  secretKey: process.env.STRIPE_SECRET_KEY!,
  configuration: {
    actions: {
      paymentLinks: {
        create: true,
      },
    },
  },
});

工具

该工具包可与 LangChain 和 Vercel 的 AI SDK 配合使用，并且可以作为工具列表传递。例如：

import { AgentExecutor, createStructuredChatAgent } from "langchain/agents";

const tools = stripeAgentToolkit.getTools();

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

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

上下文

在某些情况下，您可能希望提供在发出请求时用作默认值的值。目前，account 上下文值使您可以为您的关联账户进行 API 调用。

const stripeAgentToolkit = new StripeAgentToolkit({
  secretKey: process.env.STRIPE_SECRET_KEY!,
  configuration: {
    context: {
      account: "acct_123",
    },
  },
});

计量计费

对于 Vercel 的 AI SDK，您可以使用中间件来提交使用情况的计费事件。所需的只是客户 ID 和要计费的输入/输出计量表。

import { StripeAgentToolkit } from "@stripe/agent-toolkit/ai-sdk";
import { openai } from "@ai-sdk/openai";
import {
  generateText,
  experimental_wrapLanguageModel as wrapLanguageModel,
} from "ai";

const stripeAgentToolkit = new StripeAgentToolkit({
  secretKey: process.env.STRIPE_SECRET_KEY!,
  configuration: {
    actions: {
      paymentLinks: {
        create: true,
      },
    },
  },
});

const model = wrapLanguageModel({
  model: openai("gpt-4o"),
  middleware: stripeAgentToolkit.middleware({
    billing: {
      customer: "cus_123",
      meters: {
        input: "input_tokens",
        output: "output_tokens",
      },
    },
  }),
});

模型上下文协议

Stripe Agent Toolkit 还支持模型上下文协议 (MCP)。

要使用 npx 运行 Stripe MCP 服务器，请使用以下命令：

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

将 YOUR_STRIPE_SECRET_KEY 替换为您实际的 Stripe 密钥。或者，您可以在环境变量中设置 STRIPE_SECRET_KEY。

或者，您可以设置自己的 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 running on stdio");
}

main().catch((error) => {
  console.error("Fatal error in main():", error);
  process.exit(1);
});