Rami Levy

🚀 Rami Levy MCP 服务器

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

🚀 快速开始

若要使用 Rami Levy MCP 服务器，需完成以下设置步骤：

认证

此 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": [
        "rami-levy"
      ]
    }
  }
}

✨ 主要特性

工具

1. search_items

   • 功能：搜索目录中的产品
   • 输入：
     • 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

📦 安装指南

安装依赖项

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

npm install express cors

运行服务器

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

💻 使用示例

本项目提供了一系列工具和资源，以下为你展示部分工具的使用示例：

基础用法

// 搜索产品示例
const searchParams = {
  q: 'apple',
  store: '331',
  aggs: 1
};
// 调用 search_items 工具进行产品搜索
// 这里假设已经有调用 search_items 的函数，实际使用时需要根据项目实现
search_items(searchParams).then(result => {
  console.log(result);
});

// 添加商品到购物车示例
const cartItems = [
  {
    id: 123,
    quantity: 2
  }
];
const cartParams = {
  store: '331',
  items: cartItems
};
// 调用 add_to_cart 工具将商品添加到购物车
// 这里假设已经有调用 add_to_cart 的函数，实际使用时需要根据项目实现
add_to_cart(cartParams).then(result => {
  console.log(result);
});

🔧 技术细节

安全考虑

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

限制

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

🤝 贡献

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

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

📄 许可证

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

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