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