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 客户端中使用此工具。