在人工智能飞速发展的今天，AI 代理（Agent）正被广泛应用于自动化各种复杂任务。然而，要让这些智能代理与现实世界的服务（如支付处理）安全高效地交互，往往需要一个可靠的桥梁。Stripe 最新推出的 Agent Toolkit 中的 MCP (Model Context Protocol) 服务器正是为此而生，它为 AI 代理提供了一种标准化的方式来集成和调用 Stripe API 功能。
什么是 Stripe MCP 服务器？
Stripe MCP 服务器是 Stripe Agent Toolkit 的一部分，它实现了一个遵循模型上下文协议（MCP）的服务端点。简单来说，它充当了 AI 代理与 Stripe API 之间的中间人。通过这个服务器，AI 代理可以利用“函数调用”（Function Calling）的能力，请求服务器执行特定的 Stripe 操作，例如创建客户、生成支付链接或查询订阅等，而无需直接处理复杂的 API 请求和认证细节。
核心功能与优势
- 简化集成：开发者不再需要为 AI 代理手写复杂的 Stripe API 调用逻辑，MCP 服务器提供了标准化的工具接口。
- 标准化协议：基于模型上下文协议（MCP），确保了与兼容该协议的 AI 代理框架的良好互操作性。
- 灵活配置：您可以配置服务器暴露哪些 Stripe API 功能作为工具供 AI 代理使用，从而精确控制代理的权限。
- 安全性：通过 API 密钥进行认证，确保了操作的安全性。
- 赋能 AI 应用：使得构建能够处理支付、订阅管理、客户服务等场景的 AI 应用变得更加容易。
如何快速上手使用 Stripe MCP 服务器？
最快捷的启动方式是使用 npx 命令。您只需要确保系统中安装了 Node.js 和 npm。
启动命令：
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY参数说明：
npx -y @stripe/mcp:-y参数会自动确认安装@stripe/mcp包（如果尚未安装）。--tools=all: 这个参数指定了 MCP 服务器将暴露所有支持的 Stripe API 功能作为工具。您也可以根据需要指定特定的工具，例如--tools=payment_links.create,products.list。--api-key=YOUR_STRIPE_SECRET_KEY: 请务必将YOUR_STRIPE_SECRET_KEY替换为您真实的 Stripe Secret Key（测试模式密钥sk_test_...或生产模式密钥sk_live_...）。
您也可以将 Stripe Secret Key 设置为环境变量 STRIPE_SECRET_KEY，这样在启动时就无需通过 --api-key 参数传递。
进阶：自定义 MCP 服务器
如果您需要更细致的控制或希望将 MCP 服务器集成到现有的 TypeScript 应用中，Stripe Agent Toolkit 也支持您自行搭建 MCP 服务器。
以下是一个简单的 TypeScript 示例：
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!, // 同样需要您的Stripe Secret Key
configuration: {
actions: { // 精细配置希望启用的Stripe操作
paymentLinks: {
create: true,
},
products: {
create: true,
list: 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);
});在这个例子中，您可以精确地在 configuration.actions 中定义哪些 Stripe 资源及其操作（如创建、列出、更新等）将被启用。
支持的 Stripe API 方法示例
Stripe MCP 服务器（作为 Agent Toolkit 的一部分）旨在支持多种常用的 Stripe API 操作，例如：
- 客户管理：创建客户、列出客户
- 产品与价格：创建产品、列出产品、创建价格、列出价格
- 支付链接：创建支付链接
- 发票管理：创建发票、创建发票项目、完成发票
- 订阅管理：列出订阅、更新订阅、取消订阅
- 退款与争议：创建退款、列出争议、更新争议
- 账户余额：查询余额
总结
Stripe MCP 服务器为 AI 代理与 Stripe 支付平台的集成开辟了一条便捷之路。无论是通过 npx 快速启动，还是自定义搭建服务器，它都能帮助开发者更高效地构建具备强大支付处理能力的智能应用。如果您正在探索 AI 在电商、SaaS 或任何需要支付交互场景中的应用，Stripe MCP 服务器无疑是一个值得尝试的强大工具。
想要了解更多详情和具体配置，请访问 Stripe Agent Toolkit GitHub 仓库。
评论 (0)