NL Supermarkt MCP Server

NL 超市 MCP 服务器

MCP（模型上下文协议）服务器，用于荷兰超市和药店的价格比较，购物计划和预算跟踪。

特性

基本功能

• 搜索产品 - 搜索 12+ 荷兰超市和药店的产品
• 价格比较 超市和药店之间的价格比较
• 邮件列表优化 找到最便宜的组合
• 文件夹优惠 - 查看当前优惠与促销类型 （1+1， 二期价格， 等等）
• 药店优惠 - 查看草药桶，Etos，吸引力等的优惠。
• 搜索食谱 - 使用饮食过滤器搜索食谱（素食主义者，素食主义者，无gluten）
• 周菜单规划 - 计划用餐与自动购物清单

新功能（v2.0）

1.历史和警报

• prijshistorie - 查看价格历史，有史以来最低的价格，趋势
• prijs_alert - 设置低于特定价格的产品的警报
• check_alerts - 检查哪些警报现在是一个很好的交易

2. 智能邮件列表

• bewaar_boodschappenlijst - 保存列表以供重复使用
• laad_boodschappenlijst - 下载当前价格和优惠列表
• lijst_boodschappenlijsten - 存储列表概览
• wacht_met_kopen 建议：现在购买还是等待报价？

3.温克尔路线规划器

• vind_winkels 查找最近的超市
• plan_winkelroute - 多个商店的最佳路线

4.预算跟踪

• set_budget -Stel周预算
• budget_check 检查消息是否符合预算
• bespaar_tips 个人储蓄提示

5.德罗巴支持

• lijst_drogisten - 显示所有提供优惠的药店
• bekijk_aanbiedingen - 按类别查看优惠（头发护理，化妆，香水等）

快速开始

# Clone repository
git clone https://github.com/Samvox1/nl-supermarkt-mcp.git
cd nl-supermarkt-mcp

# Start met Docker Compose
docker compose up -d

# Eerste data sync (duurt ~5 minuten)
docker compose run --rm scheduler python3 sync_folderz.py

Claude 桌面配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  mcpServers: {
    nl-supermarkt: {
      command: npx,
      args: [-y, mcp-remote, http://localhost:8000/sse, --allow-http]
    }
  }
}

可用的超市

可用药店

药房 类别

• 头发护理 -洗发水、护发素、香波
• 蒙德维尔佐格 - 牙膏，牙刷，口水
• 身体护理 - 除臭剂，淋浴凝胶，剃须刀
• 皮肤护理 -dagcrème，润肤露，zonnebrand
• 化妆 -睫毛膏、唇彩、粉底
• 香水 -香水、香水
• 健康 -维生素、扑热息痛、pleisters
• oogzorg 镜头，镜头液体
• 卫生 -maandverband，卫生棉条

示例使用

周计划与预算

Plan boodschappen voor 4 dagen, 2 personen bij AH en Jumbo.
Budget max 80 euro, voorkeur voor pasta gerechten.

药店优惠

Toon aanbiedingen voor shampoo bij Kruidvat en Etos.

设置价格警报

Stel een alert in voor Douwe Egberts koffie onder 6 euro.

预算检查

Check of melk, brood, kaas, eieren en boter binnen 15 euro budget past.

数据来源

• 价格: Checkjebon.nl （每日07:00）
• 优惠: Folderz.nl （每天2次-超市一名滑稽演员）
• 食谱: TheMealDB + 自己的食谱

自动同步（Cronjobs）

环境变量

发展

# Lokaal draaien (zonder Docker)
pip install -r requirements.txt
python src/server_sse.py

# Logs bekijken
docker logs supermarkt-mcp
docker logs supermarkt-scheduler

许可证

麻省理工学院