关键词

StripeAI工具支付集成LLM函数调用商业自动化

项目简介

Stripe AI MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在将 Stripe 的支付、产品、客户管理等 API 功能以标准化的方式暴露给大型语言模型 (LLM) 客户端。它通过提供一套预定义的工具（例如创建客户、管理支付链接、订阅等），使 LLM 能够直接调用 Stripe 的功能，从而实现复杂的商业自动化和交互。该项目不仅提供了核心的 MCP 服务器实现，还包含了针对不同 AI 框架（如 OpenAI Agent SDK, LangChain, Vercel AI SDK）的集成，并支持通过 Cloudflare Workers 部署带有支付功能的 MCP 服务器。

主要功能点

  • Stripe API 工具集成: 将 Stripe 的核心 API 封装为 LLM 可调用的工具，包括客户管理、产品与价格、支付链接、发票、退款、订阅等。
  • Model Context Protocol (MCP) 支持: 实现了 MCP 协议，允许 LLM 客户端通过 JSON-RPC 与服务器通信，请求工具调用和上下文信息。
  • 可配置的权限控制: 支持通过配置限制 LLM 可执行的 Stripe API 操作，提高安全性。
  • 连接账户支持: 可以在上下文中指定 Stripe Connected Account ID，允许 LLM 为连接账户执行操作。
  • 付费工具功能 (Paid Tools): 创新性地支持在 MCP 服务器上定义需要付费才能调用的工具，包括一次性支付、订阅和按使用量计费模式。
  • 多种框架集成: 提供适用于 OpenAI Agent SDK、LangChain、CrewAI 和 Vercel AI SDK 的工具包，便于开发者在现有 AI 框架中集成 Stripe 功能。
  • 本地服务器运行: 提供简单的命令行工具，方便开发者在本地快速启动 MCP 服务器进行开发和测试。
  • Cloudflare Workers 部署示例: 包含在 Cloudflare Workers 上部署带 OAuth 认证和付费功能的 MCP 服务器的完整示例。

安装步骤

该仓库主要是一个 SDK 和示例集合。要运行其提供的 MCP 服务器，您可以通过 'npx' 命令行工具来启动。

  1. 安装 Node.js 和 npm: 确保您的系统已安装 Node.js (推荐 v18 或更高版本) 和 npm。
  2. 启动本地 Stripe MCP 服务器: 在您的终端中运行以下命令，启动一个本地 Stripe MCP 服务器。请将 'YOUR_STRIPE_SECRET_KEY' 替换为您的实际 Stripe Secret Key。 
    npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY --host=127.0.0.1 --port=8080

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令及其参数才能建立连接。以下是运行本地 Stripe MCP 服务器的推荐配置信息及参数说明：

{
  "server_name": "Stripe 本地 MCP 服务器",
  "command": "npx",
  "args": [
    "-y",
    "@stripe/mcp",
    "--tools=all",
    "--api-key=YOUR_STRIPE_SECRET_KEY",
    "--host=127.0.0.1",
    "--port=8080"
  ],
  "description": "此配置用于启动一个本地运行的 Stripe Model Context Protocol (MCP) 服务器。您的 MCP 客户端将使用此命令连接到服务器，并访问 Stripe 的各项 AI 工具和功能。",
  "params_description": {
    "api-key": "您的 Stripe Secret Key，这是访问 Stripe API 所必需的认证凭证。请从 Stripe Dashboard 获取，并替换掉 'YOUR_STRIPE_SECRET_KEY'。",
    "tools": "指定服务器应暴露哪些工具集。设置为 'all' 以暴露所有可用的 Stripe 工具，例如创建客户、管理支付链接等。",
    "host": "MCP 服务器将监听的 IP 地址，默认设置为本地回环地址 '127.0.0.1'。这表示服务器只接受来自本机上的连接。",
    "port": "MCP 服务器将监听的端口，默认设置为 '8080'。这是您的 MCP 客户端将连接的端口号。"
  }
}

请将 'YOUR_STRIPE_SECRET_KEY' 替换为您的实际 Stripe Secret Key。此配置允许您的 MCP 客户端连接到本地运行的 Stripe MCP 服务器。

如果您想部署到 Cloudflare Workers，请参考 'tools/typescript/examples/cloudflare' 目录下的示例代码和文档，该示例展示了如何配置 'McpServer' 及其 OAuth 提供者来提供 '/sse' 和 '/mcp' 端点。

基本使用方法

启动 MCP 服务器后，您的 MCP 客户端（如兼容 MCP 的 LLM 应用）可以配置上述连接信息来发现并调用 Stripe 的工具。例如，LLM 可以通过调用 'create_customer' 工具来创建一个新的 Stripe 客户，或通过 'create_payment_link' 工具生成一个支付链接。

对于带有付费功能的工具（如 Cloudflare Workers 示例中的 'buy_premium'、'big_add'、'generate_emoji'），当 LLM 调用这些工具时，如果用户尚未支付，MCP 服务器将返回一个包含支付链接的 'payment_required' 状态，引导用户完成支付后再执行工具。

信息

分类

商业系统

访问项目