Rami Levy MCP 服务器

Rami Levy 在线杂货店 API 的 MCP 服务器。这是一个概念验证实现，演示了如何将 Rami Levy 的电商平台与支持 MCP 的 LLM 集成。

工具

1. search_items
   • 在 Rami Levy 的目录中搜索产品
   • 输入：
     • q （字符串）：搜索查询
     • store （字符串，可选）：商店标识符（默认值：“331”）
     • aggs （数字，可选）：聚合标志（默认值：1）
   • 返回：包含名称、价格、图片 URL 和 ID 的产品数组
2. add_to_cart
   • 将一个或多个商品添加到购物车
   • 输入：
     • store （字符串）：商店标识符（例如“331”）
     • items （数组）：要添加的项目列表，每个项目包含：
       • id （数字）：产品标识符
       • quantity （数字）：要添加的数量（最小值：1）
   • 退货：更新购物车内容，包括价格和折扣
3. remove_from_cart
   • 通过提供要保留的商品的更新列表，从购物车中删除商品
   • 输入：
     • store （字符串）：商店标识符
     • items （数组）：购物车中要保留的商品的更新列表
   • 返回：更新购物车内容
4. update_quantity
   • 更新购物车中商品的数量
   • 输入：
     • store （字符串）：商店标识符
     • id （数字）：产品标识符
     • newQuantity （数字）：产品的新数量（最小值：1）
   • 返回：更新购物车内容

资源

1. rami-levy://checkout
   • 获取 Rami Levy 结账页面的 URL
   • 返回：结帐页面 URL

设置

验证

此 MCP 服务器需要来自活跃 Rami Levy 会话的身份验证令牌。获取方式如下：

1. 登录Rami Levy 的网站
2. 打开浏览器的开发者工具（F12）
3. 转到“网络”选项卡
4. 提出任何请求（例如搜索产品）
5. 从请求标头中提取：
   • RAMI_LEVY_API_KEY ：授权标头中“Bearer”后的令牌
   • ECOM_TOKEN ：完整的 ecomtoken 标头值
   • COOKIE ：完整的 cookie 标头值

环境变量

使用以下变量创建.env文件：

与 Claude Desktop 一起使用

将以下内容添加到您的claude_desktop_config.json中：

发展

1. 安装依赖项：

2. 构建项目：

3. 启动服务器：

安全注意事项

⚠️重要提示：这是一个概念验证的实现。请注意：

1. 身份验证令牌可提供对您的 Rami Levy 帐户的完全访问权限
2. 令牌应保持安全，并且永远不要提交到版本控制
3. 令牌会定期过期，需要刷新
4. 未经适当的安全审查，此实现不适用于生产用途

限制

1. 会话令牌过期，需要手动刷新
2. Rami Levy API 的某些功能尚未实现（例如，用户资料、订单历史记录）
3. 过期会话的错误处理可以改进
4. 无速率限制实施

贡献

欢迎提交问题和拉取请求！请确保不要提交任何敏感信息，例如身份验证令牌。

执照

本项目遵循 MIT 许可证。详情请参阅LICENSE文件。

免责声明

这是一个非官方项目，与 Rami Levy Chain Stores Ltd. 没有任何关联或认可。所有产品名称、徽标和品牌均归其各自所有者所有。