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

环境变量

创建一个包含以下变量的 .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：

{
  "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. 安装依赖项：

npm install

2. 构建项目：

npm run build

3. 启动服务器：

npm start

安全注意事项

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

1. 身份验证令牌提供对您的 Rami Levy 帐户的完全访问权限
2. 令牌应保持安全，切勿提交到版本控制
3. 令牌会定期过期，需要刷新
4. 在没有适当的安全审查的情况下，此实现不适用于生产用途

局限性

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

贡献

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

许可证

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

免责声明

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