mcp购物入门
一个对代理友好的入门存储库，展示如何连接和使用我们的MCP购物服务器。
此MCP服务器使用不同的主机名（多租户设置）动态支持多个商店，例如：
https://mcp.spiele-offensive.de
https://mcp.puzzle-offensive.de
这两个域都指向相同的MCP后端，并且商店上下文是动态解析的。
✅ 特性
✅ 连接到我们的MCP服务器的快速“克隆和运行”示例
✅ 适用于多个店铺（租户/店铺由基本URL选择）
✅ 现实的购物流程：
搜索产品
获取产品详细信息
加入购物车
结账（带有外部支付提供商的支付链接）
✅ 明确AI代理的工具使用模式
✅ 最小的、便于复制粘贴的设置
📦 存储库结构 . ├── README.md ├── .env.example ├── docs/ │ ├── 01-快速启动.md │ ├── 02-多店金融.md │ └── 04-tools.md ├── 配置/ │ └── 预设/ 游戏攻击.json │ └── puzzle-offensive.json ├── 示例/ │ └── node/ │ ├── package.json │ └── src/ │ ├── 00_connect.ts │ ├── 01_shop_info.ts │ ├── 02_search.ts │ ├── 03_product_details.ts │ ├── 04_cart_flow.ts │ └── 05_checkout_flow.ts └── 脚本/ └── smoke-test.sh
🚀 快速启动
- 克隆仓库
克隆https://github.com//mcp-shopping-quickstart.git cd mcp购物入门
- 创建.env
cp.env.example.env
编辑.env：
MCP_BASE_URL=https://mcp.spiele-offensive.de
- 运行节点示例
cd示例/节点 npm 安装 npm运行连接
🏬 多店铺设置（租户通过基本URL）
我们的MCP服务器动态支持多个商店。
要切换商店，只需更改：
MCP_BASE_URL=https://mcp.spiele-offensive.de
致：
MCP_BASE_URL=https://mcp.puzzle-offensive.de
不需要其他代码更改。
✅ 各商店的工具大多相同。 微小的差异（如果有的话）记录在工具描述和/或返回的元数据中。
✅ 示例流程 连接并列出工具 npm运行连接
获取店铺信息/功能 npm运行商店信息
搜索产品 npm运行搜索
完整的购物车工作流程 npm运行购物车流程
结账工作流 npm运行结账流程
🤖 推荐的代理使用模式
对于与我们的MCP集成的AI代理，我们建议采用以下流程：
连接
获取店铺信息/功能（可选但推荐）
搜索
解决产品选择问题
加入购物车
结账
这可以防止工具误用，避免错误的假设（例如运输规则、货币、可用性）。
🔐 认证
通常不需要身份验证。 仅在访问用户数据或订单数据时才需要它。
要查看用户或订单信息，我们使用简单的基于电子邮件的验证（电子邮件+一次性代码）。 输入一次性代码后，会发出一个身份验证密钥，允许继续访问用户的订单和帐户数据。
🧰 工具
工具可用性取决于服务器配置，但通常包括：
产品搜索
产品详情
购物车操作
结账/订单创建
请点击此处查看完整的工具文档：
docs/04-tools.md
🧪 冒烟测试
要运行简单的烟雾测试（建议在集成到代理之前）：
./scripts/smoke-test.sh
🛠 故障排除
- 连接问题
检查MCP_BASE_URL是否正确且可访问：
卷曲 - Ihttps://mcp.spiele-offensive.de
- 工具故障/意外行为
在大多数情况下：
输入模式错误
缺少必需的参数
店铺/租户有不同的规则或禁用功能
🧩 添加对更多商店的支持
要添加另一个店铺域（租户），请创建另一个预设：
配置/预设/.json
例子：
{ “商店”：“新店”， “baseUrl”：https://mcp.new-shop.example", “备注”：“可选店铺特定备注” }
📄 许可证
此存储库根据MIT许可证获得许可（或使用您首选的许可证更新此部分）。