JinDaGe - shufersal-mcp MCP Details

article

README

🚀 Shufersal MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，借助 Puppeteer 为 Shufersal 网站提供自动化购物功能。该服务器使大语言模型（LLMs）能够与 Shufersal 的在线购物平台进行交互，搜索商品、创建购物清单并将商品添加到购物车。

✨ 主要特性

商品搜索：搜索 Shufersal 的商品目录，登录用户可获得个性化搜索结果。
购物车管理：将商品添加到 Shufersal 的购物车。
浏览器自动化：与 Shufersal 网站实现无缝交互。
购物清单管理：根据网页链接（如食谱链接）创建结构化的购物清单。
控制台监控：跟踪浏览器自动化过程中的控制台日志，便于调试。

🚀 快速开始

工作流程

创建购物清单：使用 create_shopping_list_table 根据你的需求或食谱链接创建购物清单。
打开 Shufersal 网站：使用 open_shufersal 打开 Shufersal 网站（需要用户登录）。
搜索商品：使用 search_shufersal 搜索与购物清单中的商品相匹配的商品。
添加到购物车：使用 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（数组）：包含商品名称、数量、计量单位和可选品牌的食谱配料数组。

资源

该服务器提供以下访问权限：

控制台日志 (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 客户端中使用此工具。

shufersal-mcp