使用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許可,允許自由使用、修改和嵌入到自己的產品中,包括專有和商業產品,但不得作為託管或管理商業服務提供給第三方。