🚀 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": ["/dist/index.js" ],
}
}
}
使用自定义用户数据目录的配置：
{
"mcpServers": {
"shufersal": {
"command": "node",
"args": ["/dist/index.js" , "--user-data-dir=" ],
}
}
}
Windows 系统的配置：
{
"mcpServers": {
"shufersal": {
"command": "" ,
"args": ["/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 客户端中使用此工具。