Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words
Beginner mode On
ColoursSystemLightDark
LanguageไทยEnglish中文日本語한국어EspañolDeutsch
☰ MenuSettings
Beginner mode On
ColoursSystemLightDark
LanguageไทยEnglish中文日本語한국어EspañolDeutsch

Leclerc Drive

by skunkobiversion 0.3.0i★ –iRuns on your computer
Registry nameio.github.skunkobi/leclerc-drive

Install

Overview

Description from the maker (original English)

MCP server for E.Leclerc Drive — search products, manage cart, and order groceries from Claude

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs on your computer
  • Transport: stdio
  • Category: Search & AI memory
  • You need to fill in: LECLERC_COOKIE

Install

Pick the AI app you use, then copy the settings.

Before you install

  • Basic checks: 1 of 1 passed
  • Runs on your computer with your user’s permissions (files, network, apps).
  • You fill in yourself: LECLERC_STORE_ID, LECLERC_HOST, LECLERC_COOKIE, LECLERC_CHROME_PROFILE

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

  • npmNode.js installed (for the npx command)

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "leclerc-drive": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-leclerc-drive"
      ],
      "env": {
        "LECLERC_STORE_ID": "your-value",
        "LECLERC_HOST": "your-value",
        "LECLERC_COOKIE": "your-value",
        "LECLERC_CHROME_PROFILE": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add leclerc-drive --env LECLERC_STORE_ID=your-value --env LECLERC_HOST=your-value --env LECLERC_COOKIE=your-value --env LECLERC_CHROME_PROFILE=your-value -- npx -y mcp-leclerc-drive

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "leclerc-drive": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-leclerc-drive"
      ],
      "env": {
        "LECLERC_STORE_ID": "your-value",
        "LECLERC_HOST": "your-value",
        "LECLERC_COOKIE": "your-value",
        "LECLERC_CHROME_PROFILE": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "leclerc-drive": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-leclerc-drive"
      ],
      "env": {
        "LECLERC_STORE_ID": "your-value",
        "LECLERC_HOST": "your-value",
        "LECLERC_COOKIE": "your-value",
        "LECLERC_CHROME_PROFILE": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

  • LECLERC_STORE_ID env
    Leclerc Drive store id, e.g. 053701 (defaults to 053701).
  • LECLERC_HOST env
    Backend host for your store, e.g. fd9-courses.leclercdrive.fr (the fdN prefix varies by region).
  • LECLERC_COOKIE secret env
    Optional raw Cookie header override for headless hosts; by default the session is read from your local Chrome profile.
  • LECLERC_CHROME_PROFILE env
    Chrome profile directory to read the session cookie from (defaults to "Default").

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account skunkobi, which owns the repo

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Search & AI memoryi

  • More stars than 0% of the other 7275 servers in this category
  • Published to the registry more recently than 21% of the other 7275 servers in this category
  • Basic checks equal to or better than 100% of the other 7275 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Leclerc Drive safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: LECLERC_COOKIE

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.3.0) reached the registry 4 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Context7, Codebase Memory, Exa

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Context7

by upstash

Feeds AI the latest docs for libraries and frameworks before it answers, so code it writes does not use outdated, removed functions.

Computer or cloud★ 64,224MITUpdated yesterday
Install

Codebase Memory

by DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Runs on your computer★ 48,148MITUpdated 21 days ago
Install

Exa

by exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Runs in the cloud★ 5,213MITUpdated last month
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

mcp-leclerc-drive

The first open-source MCP server for E.Leclerc Drive — let Claude search products, manage a cart, and prepare grocery orders natively, instead of clicking through the website.

🟢 v0.3 — working & DataDome-proof. All eight tools are validated end-to-end against the live site. Requests run inside a real Chrome driven over CDP, so they pass DataDome's bot protection (which blocks headless clients and cookie-replay). You log into Leclerc Drive once in the window that opens; the session persists. See docs/api-capture.md for the reverse-engineered API.

Why

E.Leclerc Drive has no public API. Today the only way to automate it is browser automation — slow (~3–5 s per item) and fragile (blind clicks). This project exposes the underlying operations as proper MCP tools so any MCP client (Claude Desktop, Claude Code) can drive it directly.

Tools

ToolDescription
find_stores(query)Find drives near a postal code or city → name, id, service type, distance, host.
set_store(store_id)Select & remember the active store (resolves the right host automatically).
get_store()Show the currently selected store.
search_product(query)Search the catalogue → products with price, price/kg, Nutri-Score, availability, and an id.
add_to_cart(product_id, quantity?)Add a product to the cart.
remove_from_cart(product_id)Remove a line from the cart.
update_quantity(product_id, quantity)Set a line's quantity (0 removes it).
get_cart()Read the full cart with total.

Status

  • Reverse-engineer Leclerc Drive endpoints (search / cart / store locator — see docs/api-capture.md)
  • All 8 tools validated end-to-end against the live store
  • Runtime store selection with persistence (find_stores / set_store)
  • v0.3: DataDome-proof via real-Chrome CDP driving (beats active bot-challenge that killed cookie-replay) ✅
  • Published to npm + MCP registry
  • Checkout / delivery-slot booking

Requirements

  • Node.js ≥ 22 (uses the built-in WebSocket)
  • Google Chrome installed (the server drives it via CDP)

Install (development)

git clone https://github.com/skunkobi/mcp-leclerc-drive.git

cd mcp-leclerc-drive npm install npm run build

How auth works (real Chrome via CDP)

Leclerc Drive is protected by DataDome, which blocks non-browser traffic (headless clients, cookie-replay) with HTTP 403 once it escalates to active challenge mode. The only thing that reliably passes is a real browser that executes the challenge. So that's what the server uses:

  1. On first request it launches your installed Google Chrome with a dedicated, persistent profile (~/.mcp-leclerc-drive/chrome) and a debug port — no automation flags, so navigator.webdriver stays false.
  2. A Chrome window opens. Log into Leclerc Drive once in it. The persistent profile keeps you logged in across restarts.
  3. Every request runs *inside* that page via CDP, so it carries the browser's cookies, TLS fingerprint, and solved DataDome challenge — and passes.

No cookies are read or stored; there's no Keychain prompt. The server must run on the same machine as Chrome, and a window does open (headless is detectable by DataDome — don't enable it unless you know the risk).

Env varDefaultDescription
LECLERC_STORE_ID053701Default store id (overridden at runtime by set_store).
LECLERC_HOSTfd9-courses.leclercdrive.frDefault backend host (the fdN prefix varies by store).
LECLERC_CHROME_PATHautoPath to the Chrome binary, if not in the default location.
LECLERC_CHROME_PROFILE_DIR~/.mcp-leclerc-drive/chromePersistent Chrome profile dir.
LECLERC_CHROME_PORT9222CDP remote-debugging port.
LECLERC_HEADLESSfalseRun Chrome headless (⚠️ DataDome-detectable — not recommended).
LECLERC_MIN_INTERVAL_MS1000Minimum delay between two requests (hygiene).
LECLERC_JITTER_MS400Extra random jitter added between requests.
LECLERC_MAX_RETRIES3Retries on a transient 403/429 before giving up.
LECLERC_BACKOFF_BASE_MS1500Base retry backoff (doubles each attempt).

The server still serializes and spaces out requests (single queue, ~1 s + jitter, retry with backoff) to stay polite — good hygiene even though the browser now handles DataDome.

Choosing your store (no env needed)

The easiest way: just ask, in the conversation. No env vars required.

> "trouve mon drive vers 44000"     → find_stores lists nearby drives

"prends Rezé Atout Sud" → set_store remembers it (correct host resolved)

"cherche du lait" → runs on that store

set_store persists your choice to ~/.mcp-leclerc-drive/config.json, so it sticks across sessions, and it resolves the correct backend host for you (the fdN prefix genuinely varies per store — fd8, fd9, fd14…).

⚠️ One drive at a time. Leclerc binds your session to a single drive. The

store you set_store to must be the one your Chrome session is logged into —

which is the normal case (your own drive). Switching to an arbitrary other

drive your browser isn't on will return a "session expired" error.

You can still hard-set the store via LECLERC_STORE_ID / LECLERC_HOST env vars if you prefer (e.g. for headless deploys). To find them manually: your Drive URL looks like https://fd9-courses.leclercdrive.fr/magasin-053701-053701-Your-Town/ — the 6-digit number is the store id, the fdN-courses.leclercdrive.fr part is the host.

Claude Desktop / Claude Code (mcp config)

Install straight from npm — no clone needed:

# Claude Code

claude mcp add leclerc-drive -- npx -y mcp-leclerc-drive

Or in a Claude Desktop config:

{

"mcpServers": { "leclerc-drive": { "command": "npx", "args": ["-y", "mcp-leclerc-drive"] } } }

No env needed — pick your store in-conversation with find_stores / set_store. On first use a Chrome window opens: log into Leclerc Drive once and you're set.

Development

npm run dev        # tsc --watch

npm run typecheck # type-check without emitting npm run inspect # run under the MCP Inspector

Architecture

src/

index.ts # MCP server: registers the 8 tools over stdio config.ts # env-based config (store, host, Chrome/CDP, throttle) types.ts # Product / CartItem / Cart store.ts # active store selection + persistence (~/.mcp-leclerc-drive) browser.ts # ChromeSession: drives real Chrome via CDP → beats DataDome leclerc/ client.ts # Leclerc Drive backend client (search + cart) locator.ts # store finder: postal code / city → nearby drives throttle.ts # request serialization + spacing + retry (hygiene) docs/ api-capture.md # the reverse-engineered Leclerc Drive API

Contributing

This is a community tool — contributions are very welcome, whether it's a bug fix, support for your store, or a whole new capability (checkout, delivery slots, saved lists…).

See [CONTRIBUTING.md](CONTRIBUTING.md) for dev setup, how to smoke-test against your own account (npm run smoke), and — most useful for this project — a short guide on how to reverse-engineer a new Leclerc Drive endpoint and wire it in. Good first issues are listed in the status checklist above.

Feedback & contact

Feedback, bug reports, and ideas are very welcome.

  • Issues / PRs: open an issue on the repo.
  • Email: alexandreyagoubi@gmail.com

Disclaimer

Unofficial. Not affiliated with or endorsed by E.Leclerc. Use with your own account, at your own risk, in line with the site's terms of service. Intended for personal automation of your own grocery shopping.

License

MIT

Ask PopNx