mcp-marmiton

An MCP server for Marmiton, the French recipe site. Search recipes, read their ingredients and steps, and rescale the quantities to any number of servings. No API key, no account, no configuration.

(Version française plus bas / French version below)

---

Quickstart

One-click install

Claude Code

claude mcp add marmiton -- npx -y mcp-marmiton

Claude Desktop, Cursor, and any client using the standard config format

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

Tools

Tool	What it does	Key parameters
search_recipes	Finds recipes by dish or ingredient.	query, limit
get_recipe	Reads one recipe, optionally rescaled.	id, url, servings
scale_ingredients	Rescales any ingredient list, offline.	ingredients, factor, from_servings, to_servings

Search returns a Marmiton id for every result; get_recipe takes that id. That is the intended chain: search, then read.

The server is read-only. It never posts anything to Marmiton.

Scaling is the point

Asking a language model to divide a recipe by 1.5 tends to produce "2.4 eggs" and "0.67 pinches of salt", stated with the same confidence as a correct number. This server does the arithmetic itself and, more importantly, says what it could not compute. Every ingredient comes back with a scaling flag:

Flag	Meaning	Example at factor 0.667
scaled	Multiplied and rounded to a readable value.	25 cl de lait → 17 cl de lait
rounded	Multiplied, then rounded to something countable.	3 oeufs → 2 oeufs
unscaled	Left exactly as published.	1 pincée de sel, coriandre

Two rules are enforced. Scaling a recipe down never asks for more than the original: half a sachet at factor 0.667 becomes a third of a sachet, never a whole one. And scaling never silently drops an ingredient by rounding it to zero, which is why small amounts come back as fractions.

scale_ingredients exposes the same logic without any network request, so it also works on a recipe pasted from somewhere else.

Other things worth knowing

Marmiton is French. Queries work best in French: tarte aux pommes, poulet curry coco.

One page of results. Marmiton's robots.txt disallows paginating search results, so this server does not, and there is no page parameter. Narrow the query instead.

Nutrition is not rescaled. The figures Marmiton publishes describe the recipe as written, and they are returned as such.

Structured data, not scraping. Everything is read from the schema.org JSON-LD that Marmiton publishes for machines, so there are no CSS selectors to break when the site is redesigned.

Configuration

Every variable is optional. Set them in the env block of your MCP client config.

Variable	Default	Purpose
MARMITON_USER_AGENT	mcp-marmiton v<version> (<repo url>)	User-Agent sent to Marmiton.
MARMITON_MIN_INTERVAL_MS	1000	Minimum gap between requests. Values below 500 ms are ignored.
MARMITON_TIMEOUT_MS	15000	Per-request timeout.
MARMITON_MAX_RETRIES	3	Retries on rate limiting and transient errors.
MARMITON_CACHE_TTL_MS	900000	In-memory cache lifetime (15 minutes).
MARMITON_CACHE_MAX_ENTRIES	200	In-memory cache size.
MARMITON_LOG_LEVEL	error	silent, error, info or debug. Logs go to stderr.

Troubleshooting

rate_limited errors. Marmiton is throttling this client. The server already retries with backoff and slows itself down. Wait a moment and try again, and raise MARMITON_MIN_INTERVAL_MS if it persists. This never means the recipe is missing.

parse_failure errors. Marmiton changed how it publishes its structured data and the server could not read the response. Please open an issue with the recipe you asked for. The server reports this loudly rather than pretending it found nothing.

Development

npm install
npm run build:fixtures   # regenerate the HTML test fixtures
npm test                 # unit tests, no network
npm run typecheck
npm run build
MARMITON_LIVE=1 npm run test:live   # hits the real site, excluded from CI
npm run inspector        # explore the tools in the MCP Inspector

Fixtures are generated, not captured: they reproduce Marmiton's JSON-LD shape with invented recipes, so the tests are deterministic and no Marmiton content lives in this repository.

The scraping layer (src/marmiton, src/recipe) does not import the MCP SDK and is published separately as mcp-marmiton/client, so it can be used as a plain library.

Recipes, copyright and cooking

Ingredient lists and cooking steps are facts and procedures. The descriptive prose an author writes around them is their work, and this server does not return it: you get what you need to cook, plus a link to the original page.

This server is a client. It reads the structured data Marmiton publishes for machines, on demand, one request at a time, in response to an explicit request from you or your assistant. It does not crawl the site, does not build a recipe database, and writes nothing to disk. It honours Marmiton's robots.txt, including the rule against paginating search results.

Every result carries the recipe title and its source URL. If you display or reuse anything this server returns, keep that attribution and link back to Marmiton.

Rescaled quantities are computed, and cooking is not arithmetic: baking in particular does not always scale linearly. Read them as a helpful starting point and use your judgement.

This is an unofficial project, with no affiliation to or endorsement by Marmiton.

License

MIT. See LICENSE. The license covers this source code only, not the recipes retrieved through it.

---

<a name="mcp-marmiton-français"></a>

mcp-marmiton (français)

Un serveur MCP pour Marmiton. Cherchez des recettes, lisez leurs ingrédients et leurs étapes, et adaptez les quantités au nombre de convives. Sans clé d'API, sans compte, sans configuration.

Démarrage rapide

Installation en un clic

Claude Code

claude mcp add marmiton -- npx -y mcp-marmiton

Claude Desktop, Cursor, et tout client utilisant le format standard

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

Outils

Outil	Rôle	Paramètres principaux
search_recipes	Trouve des recettes par plat ou ingrédient.	query, limit
get_recipe	Lit une recette, avec adaptation possible.	id, url, servings
scale_ingredients	Adapte n'importe quelle liste, hors ligne.	ingredients, factor, from_servings, to_servings

La recherche renvoie un id Marmiton pour chaque résultat, et get_recipe prend cet id. C'est l'enchaînement prévu : chercher, puis lire.

Le serveur est en lecture seule. Il ne publie jamais rien sur Marmiton.

L'adaptation des quantités est le cœur du sujet

Demander à un modèle de diviser une recette par 1,5 produit volontiers « 2,4 œufs » et « 0,67 pincée de sel », énoncés avec le même aplomb qu'un chiffre juste. Ce serveur fait le calcul lui-même et, surtout, signale ce qu'il n'a pas pu calculer. Chaque ingrédient porte un indicateur scaling :

Indicateur	Sens	Exemple au facteur 0,667
scaled	Multiplié et arrondi à une valeur lisible.	25 cl de lait → 17 cl de lait
rounded	Multiplié, puis arrondi à une valeur dénombrable.	3 oeufs → 2 oeufs
unscaled	Laissé exactement tel que publié.	1 pincée de sel, coriandre

Deux règles sont garanties. Réduire une recette ne demande jamais davantage que l'originale : un demi-sachet au facteur 0,667 devient un tiers de sachet, jamais un sachet entier. Et l'adaptation ne supprime jamais un ingrédient en l'arrondissant à zéro, d'où les fractions pour les petites quantités.

scale_ingredients expose la même logique sans aucune requête réseau, ce qui permet aussi d'adapter une recette venue d'ailleurs.

Autres points utiles

Marmiton est un site français. Les requêtes fonctionnent mieux en français : tarte aux pommes, poulet curry coco.

Une seule page de résultats. Le robots.txt de Marmiton interdit de paginer les résultats de recherche, donc ce serveur ne le fait pas et n'expose aucun paramètre de page. Affinez plutôt la requête.

La nutrition n'est pas recalculée. Les valeurs publiées par Marmiton décrivent la recette telle quelle, et sont restituées comme telles.

Données structurées, pas de scraping. Tout est lu dans le JSON-LD schema.org que Marmiton publie à destination des machines, donc aucun sélecteur CSS ne peut casser lors d'une refonte du site.

Configuration

Toutes les variables sont optionnelles, à déclarer dans le bloc env de votre client.

Variable	Défaut	Rôle
MARMITON_USER_AGENT	mcp-marmiton v<version> (<url du dépôt>)	User-Agent envoyé à Marmiton.
MARMITON_MIN_INTERVAL_MS	1000	Écart minimal entre requêtes. Sous 500 ms, la valeur est ignorée.
MARMITON_TIMEOUT_MS	15000	Délai d'attente par requête.
MARMITON_MAX_RETRIES	3	Tentatives en cas de limitation ou d'erreur passagère.
MARMITON_CACHE_TTL_MS	900000	Durée de vie du cache mémoire (15 minutes).
MARMITON_CACHE_MAX_ENTRIES	200	Taille du cache mémoire.
MARMITON_LOG_LEVEL	error	silent, error, info ou debug. Logs sur stderr.

Dépannage

Erreurs rate_limited. Marmiton limite ce client. Le serveur réessaie déjà avec backoff et ralentit tout seul. Patientez un instant, et augmentez MARMITON_MIN_INTERVAL_MS si cela persiste. Cela ne signifie jamais que la recette est absente.

Erreurs parse_failure. Marmiton a changé la façon dont il publie ses données structurées et le serveur n'a pas su lire la réponse. Merci d'ouvrir une issue en indiquant la recette demandée. Le serveur signale ce cas au lieu de faire comme s'il n'avait rien trouvé.

Développement

npm install
npm run build:fixtures   # régénère les fixtures HTML de test
npm test                 # tests unitaires, sans réseau
npm run typecheck
npm run build
MARMITON_LIVE=1 npm run test:live   # touche le vrai site, exclu de la CI
npm run inspector        # explorer les outils dans le MCP Inspector

Les fixtures sont générées, pas capturées : elles reproduisent la forme du JSON-LD de Marmiton avec des recettes inventées, ce qui rend les tests déterministes et évite de stocker du contenu Marmiton dans ce dépôt.

La couche d'accès (src/marmiton, src/recipe) n'importe pas le SDK MCP et est publiée séparément sous mcp-marmiton/client, utilisable comme simple bibliothèque.

Recettes, droits d'auteur et cuisine

Les listes d'ingrédients et les étapes de préparation sont des faits et des procédés. La prose descriptive qu'un auteur rédige autour relève de sa création, et ce serveur ne la renvoie pas : vous obtenez de quoi cuisiner, plus un lien vers la page d'origine.

Ce serveur est un client. Il lit les données structurées que Marmiton publie pour les machines, à la demande, une requête à la fois, en réponse à une demande explicite de votre part ou de celle de votre assistant. Il ne parcourt pas le site, ne constitue aucune base de recettes et n'écrit rien sur le disque. Il respecte le robots.txt de Marmiton, y compris l'interdiction de paginer les résultats de recherche.

Chaque résultat porte le titre de la recette et son URL source. Si vous affichez ou réutilisez ce que renvoie ce serveur, conservez cette attribution et le lien vers Marmiton.

Les quantités adaptées sont calculées, et la cuisine n'est pas de l'arithmétique : la pâtisserie en particulier ne se met pas toujours à l'échelle linéairement. Prenez-les comme un point de départ commode et gardez votre jugement.

Projet non officiel, sans affiliation à Marmiton ni approbation de sa part.

Licence

MIT, voir LICENSE. La licence couvre uniquement le code source, pas les recettes récupérées par son intermédiaire.