Shufersal MCP

🚀 Shufersal MCP 服務器

Shufersal MCP 服務器是一個基於 Puppeteer 實現的模型上下文協議（MCP）服務器，它能為 Shufersal 網站提供自動化購物功能。該服務器允許大語言模型（LLMs）與 Shufersal 的在線購物平臺進行交互，實現商品搜索、創建購物清單以及將商品添加到購物車等操作。

✨ 主要特性

• 商品搜索：可搜索 Shufersal 的商品目錄，已登錄用戶將獲得個性化搜索結果。
• 購物車管理：能夠將商品添加到 Shufersal 的購物車中。
• 瀏覽器自動化：與 Shufersal 網站實現無縫交互。
• 購物清單管理：可根據網頁鏈接（如食譜鏈接）創建結構化的購物清單。
• 控制檯監控：跟蹤瀏覽器自動化過程中的控制檯日誌，方便調試。

🚀 快速開始

工作流程

1. 創建購物清單：使用 create_shopping_list_table 函數，根據你的請求或食譜鏈接創建購物清單。
2. 打開 Shufersal 網站：使用 open_shufersal 函數，導航至 Shufersal 網站（需要用戶登錄）。
3. 搜索商品：使用 search_shufersal 函數，查找與購物清單中商品匹配的商品。
4. 添加到購物車：使用 add_to_shufersal_cart 函數，將搜索到的商品添加到購物車。

📚 詳細文檔

工具

• open_shufersal
  • 打開 Shufersal 網站併為購物做好準備（需要用戶登錄）。
  • 輸入參數：hasCreatedShoppingList（布爾值），表示是否事先創建了購物清單。
• search_shufersal
  • 在 Shufersal 網站上搜索商品（搜索結果將根據購買歷史排序）。
  • 輸入參數：query（字符串），商品搜索查詢詞（例如，'牛奶'、'麵包'、'西紅柿'）。
• add_to_shufersal_cart
  • 將商品添加到購物車（必須在搜索商品後使用）。
  • 輸入參數：
    • product_id（字符串），搜索結果中的商品 ID。
    • sellingMethod（字符串），搜索結果中的銷售方式。
    • qty（數字），要添加到購物車的商品數量。
    • comment（字符串，可選），商品的可選備註。

粘貼食譜鏈接的額外工具

• read_webpage_content
  • 讀取網頁內容並將其轉換為 Markdown 格式。
  • 輸入參數：url（字符串），要讀取的網頁的 URL。
• create_shopping_list_table
  • 根據食譜配料創建 Markdown 格式的購物清單表格。
  • 輸入參數：recipe（數組），包含食譜配料名稱、數量、計量單位和可選品牌的數組。

資源

服務器提供以下訪問資源：

1. 控制檯日誌 (console://logs)

• 以文本格式輸出瀏覽器控制檯信息。
• 包含瀏覽器自動化過程中的所有控制檯消息。

📦 安裝指南

配置

以下是使用 Shufersal MCP 服務器的 Claude Desktop 配置示例：

默認配置：

{
  "mcpServers": {
    "shufersal": {
      "command": "node",
      "args": ["<path/to/shufersal-mcp>/dist/index.js"],
    }
  }
}

自定義用戶數據目錄配置：

{
  "mcpServers": {
    "shufersal": {
      "command": "node",
      "args": ["<path/to/shufersal-mcp>/dist/index.js", "--user-data-dir=<path/to/custom/user/data>"],
    }
  }
}

Windows 系統配置：

{
  "mcpServers": {
    "shufersal": {
      "command": "<path/to/node>",
      "args": ["<path/to/shufersal-mcp>/dist/index.js"],
    }
  }
}

🔧 技術細節

構建

npm run build

開發模式

npm run watch

代碼檢查

npm run lint
npm run lint:fix

📄 許可證

本 MCP 服務器採用 MIT 許可證。這意味著你可以自由使用、修改和分發該軟件，但需遵守 MIT 許可證的條款和條件。

⚠️ 重要提示

本工具會自動與 Shufersal 網站進行瀏覽器交互，並將瀏覽器數據存儲在本地。請注意：

• 瀏覽器會話數據存儲在 ./puppeteer-user-data/ 目錄下（該目錄已從 Git 版本控制中排除）。
• 如果你在首次使用時登錄了 Shufersal，工具會將你的會話數據保存在用戶數據目錄中。
• 請僅在受信任的 MCP 客戶端中使用此工具。