🚀 Rami Levy MCP 服务器

Rami Levy MCP 服务器是用于 Rami Levy 在线杂货店 API 的 MCP 服务器。此项目旨在演示如何将 Rami Levy 的电子商务平台与支持 MCP 的大语言模型（LLM）进行集成。

✨ 主要特性

• 提供了搜索商品、添加商品到购物车、从购物车移除商品、更新商品数量等实用工具。
• 可获取 Rami Levy 结算页面的 URL。
• 支持与 Claude Desktop 集成。

📦 安装指南

安装依赖项

使用以下命令安装所需的包：

npm install express cors

环境变量设置

创建一个 .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": [
        "rami-levy"
      ]
    }
  }
}

认证

此 MCP 服务器需要来自活动 Rami Levy 会话的身份验证令牌。要获取这些：

1. 登录到 Rami Levy 网站
2. 打开浏览器的开发者工具（F12）
3. 转到网络标签
4. 发出任何请求（例如，搜索产品）
5. 从请求头中提取：
   • RAMI_LEVY_API_KEY：授权标头中 "Bearer" 之后的令牌
   • ECOM_TOKEN：完整的 ecomtoken 标头值
   • COOKIE：完整的 cookie 标头值

运行服务器

运行 index.js 脚本以启动 MCP 服务器。

💻 使用示例

工具使用

search_items

• 功能：搜索目录中的产品
• 输入：
  • q (字符串)：搜索查询
  • store (字符串，可选)：商店标识符（默认："331"）
  • aggs (数字，可选)：聚合标志（默认：1）
• 返回：包含名称、价格、图片 URL 和 ID 的产品数组

add_to_cart

• 功能：添加一个或多个商品到购物车
• 输入：
  • store (字符串)：商店标识符（例如："331"）
  • items (数组)：要添加的商品列表，每个包含：
    • id (数字)：产品标识符
    • quantity (数字)：添加的数量（最小值：1）
• 返回：更新后的购物车内容，包括价格和折扣

remove_from_cart

• 功能：通过提供要保留的商品列表从购物车中移除商品
• 输入：
  • store (字符串)：商店标识符
  • items (数组)：购物车中要保留的商品更新列表
• 返回：更新后的购物车内容

update_quantity

• 功能：更新购物车中商品的数量
• 输入：
  • store (字符串)：商店标识符
  • id (数字)：产品标识符
  • newQuantity (数字)：产品的最新数量（最小值：1）
• 返回：更新后的购物车内容

资源使用

rami-levy://checkout

• 功能：获取 Rami Levy 结算页面的 URL
• 返回：结算页面 URL

🔧 技术细节

安全考虑

• 确保敏感信息（如 API 密钥和令牌）不暴露在客户端。
• 定期更新依赖项以防止已知的安全漏洞。

限制

• 当前版本仅支持有限的 API 功能。
• 可能存在性能瓶颈，特别是在高流量情况下。

🤝 贡献

要为项目做出贡献，请遵循以下步骤：

1. 创建功能分支。
2. 提交您的更改。
3. 开启拉取请求进行审查。

📄 许可证

[在此处添加许可证信息]

此文档提供了 Rami Levy MCP 服务器的全面概述，包括工具、设置和开发指南。如需进一步帮助，请参考相关资源或联系支持团队。