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