Rami Levy MCP 服务器

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

工具

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: Authorization 头中 "Bearer" 后面的令牌
   • ECOM_TOKEN: ecomtoken 头的完整值
   • COOKIE: cookie 头的完整值

环境变量

创建一个 .env 文件，并包含以下变量： env RAMI_LEVY_API_KEY=your_api_key_here ECOM_TOKEN=your_ecom_token_here COOKIE=your_cookie_string_here

与 Claude Desktop 一起使用

在你的 claude_desktop_config.json 中添加以下内容：

json { "mcpServers": { "rami-levy": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-rami-levy" ], "env": { "RAMI_LEVY_API_KEY": "<YOUR_API_KEY>", "ECOM_TOKEN": "<YOUR_ECOM_TOKEN>", "COOKIE": "<YOUR_COOKIE>" } } } }

开发

1. 安装依赖项： bash npm install

2. 构建项目： bash npm run build

3. 启动服务器： bash npm start

安全注意事项

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

1. 身份验证令牌提供了对您的 Rami Levy 账户的完全访问权限
2. 令牌应保持安全，切勿提交到版本控制系统
3. 令牌会定期过期，需要刷新
4. 此实现未经适当的安全审查，不适用于生产环境

限制

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

贡献

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

许可证

该项目根据 MIT 许可证许可。有关详细信息，请参阅 LICENSE 文件。

免责声明

这是一个非官方项目，与 Rami Levy Chain Stores Ltd 无关且未得到其认可。所有产品名称、徽标和品牌均为其各自所有者的财产。