AI导哈

在线杂货店API服务器

Rami Levy在线杂货店的MCP服务器，用于将电子商务平台与支持MCP的LLM集成，提供商品搜索、购物车管理等功能。

  • by shilomagen
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 shilomagen/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的产品数组

  2. add_to_cart

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

  3. remove_from_cart

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

  4. 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": "<YOUR_API_KEY>",
        "ECOM_TOKEN": "<YOUR_ECOM_TOKEN>",
        "COOKIE": "<YOUR_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连锁店有限公司或由其背书。所有产品名称、标识和品牌均为其各自所有者的财产。

相关 MCP