使用MCP工具接受付款
该开源项目为MCP服务器提供即插即用的商业核心,基于Agentic Commerce Protocol(ACP),让工具能在对话中直接处理支付,包括购买资产、升级到Pro、续费许可证、购买积分等。支持独立服务器、嵌入式或仅库三种使用方式,并集成Stripe支付和模拟支付提供商。
该项目是一个为MCP(Model Context Protocol)服务器设计的即插即用商业核心,基于Agentic Commerce Protocol(ACP)构建。开发者只需指向一个简单的产品文件,其MCP工具便能在正在进行的对话中直接接受付款:例如购买资产、升级到Pro、续费许可证或购买积分。商业逻辑是一个干净的库,MCP服务器和ACP REST端点只是其上的薄层。
该项目适用于已经运营或正在构建MCP工具的公司,未来需要在工具内部收取费用。由于商业逻辑与真实品牌和产品相伴而行,因此不存在未知商店的信任问题。需要注意的是,它不是一个面向未知卖家的独立购物目的地,也不是CRM、订单数据库或客户历史存储,成功付款后订单会交给商家并遗忘;它也不是前端,有意不提供购物车UI或聊天小部件。
项目提供了三种使用方式:独立服务器(运行整个堆栈,包括npm start或Docker镜像,或Lambda处理程序);嵌入式(将商业核心导入自己的MCP服务器并注册工具);仅库(从REST API或机器人调用核心,无需MCP)。快速入门示例展示了使用Docker运行独立服务器,以及将商业核心嵌入到现有MCP服务器中的代码。AWS Lambda部署则使用DynamoDB存储和S3目录源。
产品文件仅包含目录,不混合订单或配置。价格以整数最小单位(美分)表示,以匹配Stripe并避免浮点货币错误。配置方面,非秘密设置放在config.json中,秘密仅来自环境变量。项目支持多种存储和目录驱动:目录(只读)可以是捆绑文件、远程URL或S3对象;购物车和结账会话(短期、TTL、非客户数据)可以使用SQLite(Docker/EC2)或DynamoDB(Lambda)。
支付方面,直接集成Stripe(提供Stripe托管结账URL),以及委托支付(SPT,美国,Stripe预览条款)。税收委托给Stripe Tax,默认关闭。MCP工具包括搜索和获取产品、添加到购物车、查看购物车、更新和删除购物车项以及结账。由于传输是无状态的,添加到购物车会返回一个cart_id,需要在后续调用中传递。开发使用npm install、npm run dev、npm test等脚本。项目采用Elastic License 2.0许可,允许自由使用、修改和嵌入到自己的产品中,包括专有和商业产品,但不得作为托管或管理商业服务提供给第三方。