Rami Levy MCP

Rami Levy MCP服务器

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

工具

1. search_items

- 在Rami Levy的产品目录中搜索产品 - 输入： - q （string）：搜索查询 - store （字符串，可选）：存储标识符（默认值：“331”） - aggs （数字，可选）：聚合标志（默认值：1） - 返回：包含名称、价格、图像URL和ID的产品数组

1. add_to_cart

- 将一个或多个商品添加到购物车 - 输入： - store （string）：存储标识符（例如“331”） - items （array）：要添加的项目列表，每个项目包含： - id （数字）：产品标识符 - quantity （数字）：要添加的数量（最小：1） - 退货：更新购物车内容，包括价格和折扣

1. remove_from_cart

- 通过提供要保留的最新商品列表从购物车中删除商品 - 输入： - store （string）：存储标识符 - items （array）：更新购物车中的商品列表 - 退货：更新购物车内容

1. update_quantity

- 更新购物车中商品的数量 - 输入： - store （string）：存储标识符 - 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": "",
        "ECOM_TOKEN": "",
        "COOKIE": ""
      }
    }
  }
}

发展

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

1. 启动服务器：

npm start

安全考虑

⚠️ 重要：这是概念验证实施。请注意：

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

局限性

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

贡献

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

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

免责声明

这是一个非官方项目，不隶属于Rami Levy连锁店有限公司或由其背书。所有产品名称、标识和品牌均为其各自所有者的财产。