leclerc-drive

Serveur MCP pour faire ses courses sur Leclerc Drive depuis Claude : recherche avec labels, Nutri-Score et prix au kilo, promotions de la semaine, produits habituels, habitudes d'achat, qualité nutritionnelle d'après Open Food Facts, panier.

Projet indépendant, non affilié à E.Leclerc. Leclerc Drive n'a pas d'API publique : le serveur lit les pages du site, qui peuvent changer sans préavis.

Fonctionnement

Le serveur pilote un vrai Chrome, avec un profil dédié et un port de débogage, et exécute ses requêtes depuis l'onglet du drive où l'on est connecté. Elles portent donc les cookies et l'empreinte du navigateur. Les requêtes passent une à une, espacées d'au moins 1,2 s.

Related MCP server: Tiv Taam MCP Server

Prérequis

• Bun 1.2 ou plus récent

• Google Chrome

• Un compte Leclerc Drive

Installation

git clone https://github.com/vanhovev/leclerc-drive.git
cd leclerc-drive
bun install
claude mcp add leclerc-drive -s user -- bun run "$PWD/src/index.ts"

Tout client MCP en stdio convient, avec la commande bun run /chemin/vers/leclerc-drive/src/index.ts.

Au premier appel, une fenêtre Chrome s'ouvre : s'y connecter à Leclerc Drive et ouvrir la page de son drive. Le profil Chrome garde la session et le drive détecté est mémorisé.

Outils

Le paiement et la réservation du créneau restent sur le site.

Profil

~/.leclerc-drive/profil.md décrit le foyer, les critères de qualité et la façon de faire les courses, en Markdown libre. Le serveur l'ajoute à ses instructions : l'agent le connaît sans rien charger. Il se modifie à la main ou via remember_preference, et les changements valent pour les sessions suivantes.

# Profil de courses

## Foyer
- 2 personnes, un drive par semaine.

## Qualité
- Limiter les additifs, en particulier les émulsifiants.
- Le Nutri-Score n'est pas un critère.

Données locales

Tout reste sur la machine, dans ~/.leclerc-drive/ :

get_purchase_habits lit l'historique de l'année en cours dans l'espace client, au plus tous les deux jours, et ne télécharge que les commandes absentes de la base.

Configuration

Variables d'environnement, toutes facultatives :

Avec Claude Code : claude mcp add leclerc-drive -s user -e LECLERC_CHROME_PORT=9333 -- bun run "$PWD/src/index.ts".

Sécurité

Tant que la fenêtre Chrome du serveur est ouverte, n'importe quel programme local peut piloter la session Leclerc Drive par le port de débogage. Mieux vaut la fermer en dehors des courses : le serveur la relance au besoin.

Développement

bun test
bun run typecheck

Les tests tournent sur des pages synthétiques qui reproduisent le balisage du site : aucun compte ni navigateur n'est nécessaire.

src/quality/additives.json est généré à partir des taxonomies d'Open Food Facts (additives.json et additives_classes.json) :

bun scripts/build-additives.ts additives.json additives_classes.json

Licence

Code sous licence MIT. src/quality/additives.json est dérivé des données d'Open Food Facts, publiées sous licence ODbL.