Samvox1/nl-supermarkt-mcp

NL Supermarkt MCP Server

MCP (Model Context Protocol) server voor Nederlandse supermarkt én drogisterij prijsvergelijking, boodschappenplanning en budget tracking.

Features

Basis Functionaliteiten

• Producten zoeken - Zoek producten bij 12+ Nederlandse supermarkten én drogisterijen
• Prijsvergelijking - Vergelijk prijzen tussen supermarkten en drogisten
• Boodschappenlijst optimalisatie - Vind goedkoopste combinatie
• Folder aanbiedingen - Bekijk actuele aanbiedingen met promo types (1+1, 2e halve prijs, etc.)
• Drogisterij aanbiedingen - Bekijk aanbiedingen van Kruidvat, Etos, Trekpleister, etc.
• Recepten zoeken - Zoek recepten met dieetfilters (vegetarisch, vegan, glutenvrij)
• Weekmenu planning - Plan maaltijden met automatische boodschappenlijst

Nieuwe Features (v2.0)

1. Prijshistorie & Alerts

• prijshistorie - Bekijk prijsverloop, laagste prijs ooit, trends
• prijs_alert - Stel alerts in voor producten onder bepaalde prijs
• check_alerts - Check welke alerts nu een goede deal zijn

2. Slimme Boodschappenlijst

• bewaar_boodschappenlijst - Sla lijsten op voor hergebruik
• laad_boodschappenlijst - Laad lijst met actuele prijzen & aanbiedingen
• lijst_boodschappenlijsten - Overzicht opgeslagen lijsten
• wacht_met_kopen - Advies: nu kopen of wachten op aanbieding?

3. Winkel Routeplanner

• vind_winkels - Vind dichtstbijzijnde supermarkten
• plan_winkelroute - Optimale route langs meerdere winkels

4. Budget Tracking

• set_budget - Stel weekbudget in
• budget_check - Check of boodschappen binnen budget passen
• bespaar_tips - Persoonlijke bespaartips

5. Drogisterij Support

• lijst_drogisten - Toon alle drogisterijen met aanbiedingen
• bekijk_aanbiedingen - Bekijk aanbiedingen per categorie (haarverzorging, make-up, parfum, etc.)

Quick Start

# 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 Desktop Configuratie

Voeg toe aan ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Beschikbare Supermarkten

Beschikbare Drogisterijen

Drogisterij Categorieën

• haarverzorging - shampoo, conditioner, haarverf
• mondverzorging - tandpasta, tandenborstel, mondwater
• lichaamsverzorging - deodorant, douchegel, scheermesjes
• huidverzorging - dagcrème, bodylotion, zonnebrand
• make-up - mascara, lippenstift, foundation
• parfum - parfum, eau de toilette
• gezondheid - vitamines, paracetamol, pleisters
• oogzorg - lenzen, lenzenvloeistof
• hygiene - maandverband, tampons

Voorbeeldgebruik

Weekplanning met budget

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

Drogisterij aanbiedingen

Toon aanbiedingen voor shampoo bij Kruidvat en Etos.

Prijsalert instellen

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

Budget check

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

Data Bronnen

• Prijzen: Checkjebon.nl (dagelijks 07:00)
• Aanbiedingen: Folderz.nl (2x per dag - supermarkten én drogisten)
• Recepten: TheMealDB + eigen NL recepten

Automatische Sync (Cronjobs)

Environment Variables

Development

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

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

License

MIT