io.github.apitoagents由 GitHub 帳號 apitoagents 發布v1.0.1更新於 Oct 24, 2026
Sample shop MCP server: paginated search, idempotent orders, guarded cancellation. Four languages.
一個示範商店 MCP 伺服器，提供商品搜尋、商品詳情、下單與需確認的訂單取消，可用 npx 在本機執行或連線託管的遠端示範。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.apitoagents%2Fsample-shop-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"sample-shop": {
"type": "http",
"url": "https://demo.apitoagents.com/mcp"
}
}
}An MCP server for a small sample shop, written with the official TypeScript SDK. It shows the three kinds of tool every real integration needs: paginated reads (search_products, get_product), an idempotent write (create_order) and a guarded action that refuses to run without explicit confirmation (cancel_order).
The same server exists in Python, C# and PHP, all passing one conformance scenario: github.com/apitoagents/mcp-examples. Walkthrough: apitoagents.com/docs/build-mcp-server-typescript.
That starts the bundled Sample Shop API on 127.0.0.1:4010 and serves the MCP tools over stdio, which is what Claude Desktop, Claude Code and the MCP Inspector expect from a local server.
Claude Code:
Claude Desktop (claude_desktop_config.json):
Or from a clone: npm ci && npm run build && npm start (listens on 127.0.0.1:3001/mcp). Environment: HOST, PORT, UPSTREAM_URL, UPSTREAM_API_KEY (default demo-key), ALLOWED_HOSTS (comma-separated public hostnames accepted in the Host header).
A hosted copy runs at https://demo.apitoagents.com/mcp (in-memory data, resets regularly). Add it as a remote MCP server in Claude or ChatGPT and ask for a desk lamp.
MIT. Built by API to Agents, which designs and hosts servers like this for companies' own APIs.
來源：typescript/README.md，提交 1014f2c
Search products
Search the shop catalogue by phrase and optional category. Returns one page of up to `limit` products and a `nextCursor`; when nextCursor is not null, more results exist and you must say so rather than claiming the list is complete. Use get_product for full details of one item. This tool does not place orders.
limitquerycursorcategoryGet product details
Return the full details of one product by its id (for example p-1001). Use search_products first if you only know a name.
productId必填Create an order
Place an order for one product. Generate one random idempotencyKey per user request and reuse the same key if you retry after an error or timeout; the shop returns the original order instead of creating a duplicate. Confirm product and quantity with the user before calling. Returns the order with its id, status and total.
quantity必填productId必填idempotencyKey必填Cancel an order
Cancel an order that has not shipped. This cannot be undone. Call it first with confirm=false to get the order details, show them to the user, and only after the user explicitly agrees call again with confirm=true.
confirmorderId必填已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
npx @apitoagents/sample-shop-mcpclaude mcp add sample-shop -- npx -y @apitoagents/sample-shop-mcp{ "mcpServers": { "sample-shop": { "command": "npx", "args": ["-y", "@apitoagents/sample-shop-mcp"] } } }UPSTREAM_URL=http://127.0.0.1:4010 npx -p @apitoagents/sample-shop-mcp node node_modules/@apitoagents/sample-shop-mcp/dist/server.js