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