Rami Levy

🚀 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 服務器的全面概述，包括工具、設置和開發指南。如需進一步幫助，請參考相關資源或聯繫支持團隊。