Enables test-mode payment processing through Stripe when a Stripe secret key is configured, as an alternative to the built-in simulated payment.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@yoga-store Buy the best M-size yoga pants with pockets under $1200."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Built by DustyNotes · YouTube @DustyNotesAI · MIT License
這是一間虛構的瑜珈服測試商店，由 DustyNotes 為 YouTube 頻道的一支影片打造： 如果網站以後不是做給人看的，那要做給誰看、怎麼做？
一個能實際操作的 agent commerce 示範專案：同一份商品目錄，一邊是人類逛的瑜珈服店，一邊是 AI agent 使用的 JSON／MCP 結帳介面。
公開網站可瀏覽、篩選、選尺寸與完成模擬訂單，使用示範收件資料，不需要信用卡。GitHub Pages 版只在瀏覽器運作；下方的本機 Node 版才包含 MCP 與四道伺服器驗證。
同一份商品資料，開了兩個門（影片裡叫「一般網站」和「AI 的介面」）：
人類門 | agent 門 | |
給誰 | 人 | AI agent（Claude Code 之類） |
長什麼樣 | 首頁、Hero、卡片、評價、動畫、表單 | JSON： |
進門要什麼 | 什麼都不用 | 四道門：身分（簽章）、授權（你簽的紙）、預算（上限）、付款（測試卡） |
同一個網址 |
|
|
商品跟評價都是編的。付款預設是模擬，設定 STRIPE_SECRET_KEY（sk_test_）才走 Stripe 測試模式。其他金鑰會被拒絕；只支援整數 TWD，送 Stripe 前轉成百分之一元的單位。
八件商品各有獨立生成的商品圖片，另有首頁情境圖；WebP 原尺寸與縮圖存放在 public/images/。
圖片依原目錄的顏色、口袋與剪裁產生，完整提示詞與修正紀錄見 docs/product-image-prompts.md。圖片為虛構商品示意。
人類店面支援名稱／顏色搜尋、現貨尺寸、價格上限、口袋篩選與排序。原本的商品資料及 agent 授權機制維持共用。
單件購物袋透過 HttpOnly cookie 保留選擇四小時；重新啟動伺服器會清除記憶體中的購物袋與 session。
測試結帳使用 4242 4242 4242 4242、到期 12/28、CVC 123。請使用虛構收件資料。重複送出已完成的訂單不會再次扣庫存。
npm test 驗證店面、身分簽章、授權與預算、付款模式及金額單位、非法數量、庫存保留與重複付款。測試使用暫存金鑰及紀錄，不動既有實驗資料，也不連 Stripe。
Related MCP server: ACP Commerce MCP Server
需要 Node.js 20 以上版本。先下載或 clone 本專案，再進入專案資料夾執行：
git clone https://github.com/dustynotesai/yoga-agent-store.git
cd yoga-agent-store
npm install
npm run keygen # 產生你跟 agent 的鑰匙，公鑰登記進店
npm run mandate -- --max 1200 --category yoga-pants # 簽一張授權書：只能買瑜珈褲、上限 1200
npm start # http://localhost:4242只想瀏覽店面，可直接 npm install、npm start。keygen 與 mandate 是 agent 介面所需的設定。
npm run keygen 預設產生 owner dustynotes、agent dustynotes-agent，存到 keys/ 與 config/agents.json；這些檔案不會提交到 Git。空白登記範例在 config/agents.example.json。已有金鑰仍可使用；重跑 keygen 會替換本機鑰匙，之後必須重簽 mandate。授權書預設 7 天後過期（--days 可以改），過期就再跑一次 npm run mandate。
另開一個視窗：
npm run agent # 看 agent 怎麼蓋章敲後門、四道門一道一道過
npm run tokens # 同一間店，HTML／markdown／JSON 各多少 token門 | agent 要帶 | 店要驗 | 你要簽 | 外面誰在推 |
1 身分 | 每個請求帶 Ed25519 簽章（ | 用 |
| Visa Trusted Agent Protocol、Cloudflare Web Bot Auth（RFC 9421） |
2 授權 | 一張你簽的 mandate：給哪個 agent、能買哪一類 | mandate 簽名、agent 對不對、類別對不對 |
| Google AP2 的 Mandate、Mastercard Verifiable Intent |
3 預算 | mandate 裡的 | 結帳金額 ≤ 上限 | 同上 | 同上 |
4 付款 | 一次性卡 token | 走 | 綁卡 | Alchemy AgentCard ＋ Mastercard Agent Pay、Stripe 的 shared payment token |
每一道都可以單獨關掉，看少了它會發生什麼：
npm run gates # 看現在的設定
npm run gates -- budget off # 關掉預算門
npm run gates -- all on # 全開被擋的時候回應會說是哪一道：{"error":"over_budget","hint":"金額 1490 超過授權上限 1200","door":"budget"}。
這是教學用的協定概念示範，未宣稱與表中服務正式整合或通過認證。預算是每筆上限，非累積支出限制。session 與庫存留在單一程序記憶體；不支援正式付款、跨程序或重啟後的付款復原。
repo 裡的 .mcp.json 已經登記了兩個 MCP：yoga-store（agent 門）跟 playwright（拿來走人類門）。
店要先開著（npm start）。在這個資料夾開 Claude Code，第一次會問要不要啟用 .mcp.json 裡的 MCP，選同意；之後它就看得到 list_products、get_product、create_checkout、complete_checkout、cancel_checkout 五個工具。
蓋章跟附授權書都在 src/client.js 裡做掉了，Claude Code 完全不用碰鑰匙。
同一個任務兩個門各走一次：
幫我買一件 M 號、有口袋、預算 1,200 以內、評價最高的瑜珈褲，寄到台北。
人類門：「用 playwright 打開 http://localhost:4242 …」
agent 門：「用 yoga-store 的工具 …」
想跑「先列三件 → 我選一件 → 看明細 → 回覆確認 → 付款」，直接用 操作指南 的提示。等待確認是 AI 的互動指示，和伺服器驗證已簽的 mandate 分開。
方法與重跑指令在 experiments/PROTOCOL.md；歷史結果、限制及 70 次逐次摘要見 experiments/RESULTS.md。換順序的例子：
npm run experiment -- --runs 10 --orders original,reversed,random每一次都是真的開一個 claude -p 走 MCP 後門，結果在 experiments/runs/ 跟 logs/orders.jsonl。
npm run build:pages
npm run preview:pages
# http://127.0.0.1:4243/yoga-agent-store/dist/ 只包含店面 HTML、瀏覽器程式、商品資料與圖片，不包含金鑰、紀錄或 Node 後端。網站從 gh-pages 分支發布；更新 main 不會自動改動網站。
維護者先用 GitHub CLI 登入對應帳號，再執行 npm run deploy:pages：它會跑測試、建置，在暫存 checkout 更新 gh-pages 並推送，不需要 Actions workflow 權限。首次發布後，在 Settings → Pages 選「Deploy from a branch」、gh-pages、/ (root)。Fork 或自訂預覽路徑可設定 BASE_PATH（預設 /yoga-agent-store/）。
本機測試需要隔離資料時，可將 YOGA_STORE_STATE_DIR 指向含 data/products.json 的另一個資料夾；設定、金鑰與紀錄會寫入該處，靜態圖片仍取自專案 public/。
data/products.json 八件商品（6 條瑜珈褲 ＋ 2 件上衣），sponsored / platform_pick 可以自己改
config/gates.json 四道門的開關、目錄順序、實驗標籤
config/agents.example.json 空白登記範例
config/agents.json 本機產生的公鑰登記（gitignored）
keys/ 私鑰跟授權書（gitignored）
logs/requests.jsonl 每一個請求：哪個門、幾 byte、幾 token
logs/orders.jsonl 每一筆訂單：哪個門、哪一輪實驗、選了哪件
src/server.js 兩個門
src/mcp.js agent 門的 MCP 版
src/auth.js 簽章（身分）
src/mandate.js 授權書（授權＋預算）
src/payment.js 付款（模擬／Stripe 測試）
src/views.js 人類門的 HTML 跟 markdowntoken 數是用 OpenAI 的 tokenizer（gpt-tokenizer）估的，Claude 的實際用量以 Claude Code 跑完的 usage 為準。
由 DustyNotes（Dustin Lin）製作，以 MIT License 開源。影片在 YouTube 頻道 @DustyNotesAI。歡迎 fork、修改與用來學習；使用或散布時請保留 LICENSE 中的版權與授權聲明。
商品圖片使用 AI 生成，提示詞保留於 docs/product-image-prompts.md。這是一個供本機學習與實驗的示範專案，不是正式收款或出貨的電商系統。
This server cannot be deployed
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
AI shopping gateway for product search, inventory, carts, and merchant-hosted checkout.
Agent Commerce MCP — agent-native A2A storefront. Discovery, Stripe checkout, affiliate program.
Agentic commerce gateway: discovery, search, checkout across Shopify/Woo/Odoo/PrestaShop.
