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：授权头中“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连锁商店有限公司的认可。所有产品名称、徽标和品牌均为其各自所有者的财产。