Sample Shop MCP server

Name: Sample Shop MCP server
Author: apitoagents

远程服务

apitoagents.com开发工具03 周前更新

代码仓库访问官网

关于 Sample Shop MCP server

Sample Shop MCP server 是使用官方 TypeScript SDK 构建的示例电商集成，并提供 Python、C# 和 PHP 版本。它演示分页读取、幂等下单及需确认的取消操作。

主要功能

01分页搜索和获取商品
02幂等创建订单
03需确认后才能取消订单
04提供四种语言实现

适用场景

01浏览示例商店的商品目录
02重复安全地创建示例订单
03测试需确认的订单取消流程

MCP 相关

它将商品搜索、商品获取、订单创建和受保护的取消操作作为 MCP 工具提供。支持通过 stdio 或 Streamable HTTP 运行。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://demo.apitoagents.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http apitoagents-sample-shop https://demo.apitoagents.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"apitoagents-sample-shop":{"type":"http","url":"https://demo.apitoagents.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"apitoagents-sample-shop":{"type":"http","url":"https://demo.apitoagents.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"apitoagents-sample-shop":{"type":"http","url":"https://demo.apitoagents.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"apitoagents-sample-shop":{"serverUrl":"https://demo.apitoagents.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npm@apitoagents/sample-shop-mcp1.0.1stdio

工具

参数	类型	必填	说明
limit	integer	否	每页条目数。
query	string	否	要与商品名称和描述匹配的词语。
cursor	string	否	上一页 nextCursor 中的不透明令牌。切勿自行编造。
category	enum	否	将结果限制为一个类别。lighting \| furniture \| kitchen

详细介绍

@apitoagents/sample-shop-mcp

一个小型示例商店的 MCP 服务，使用官方 TypeScript SDK 编写。它展示了每个真实集成都需要的三类工具：分页读取（search_products、get_product）、幂等写入（create_order），以及在未获得明确确认时会拒绝执行的受保护操作（cancel_order）。

同一服务也有 Python、C# 和 PHP 版本，且都通过了同一个一致性场景：github.com/apitoagents/mcp-examples。操作指南：apitoagents.com/docs/build-mcp-server-typescript。

一条命令即可试用（stdio）

npx @apitoagents/sample-shop-mcp

这会在 127.0.0.1:4010 启动内置的 Sample Shop API，并通过 stdio 提供 MCP 工具，这是 Claude Desktop、Claude Code 和 MCP Inspector 对本地服务的预期方式。

Claude Code：

claude mcp add sample-shop -- npx -y @apitoagents/sample-shop-mcp

Claude Desktop（claude_desktop_config.json）：

{ "mcpServers": { "sample-shop": { "command": "npx", "args": ["-y", "@apitoagents/sample-shop-mcp"] } } }

通过 Streamable HTTP 运行

UPSTREAM_URL=http://127.0.0.1:4010 npx -p @apitoagents/sample-shop-mcp node node_modules/@apitoagents/sample-shop-mcp/dist/server.js

也可以从克隆的仓库运行：npm ci && npm run build && npm start（监听 127.0.0.1:3001/mcp）。环境变量：HOST、PORT、UPSTREAM_URL、UPSTREAM_API_KEY（默认值为 demo-key）、ALLOWED_HOSTS（以逗号分隔、允许出现在 Host 标头中的公共主机名）。