mcp-marmiton

mcp-marmiton

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

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

Quickstart

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

Search returns a Marmiton id for every result; get_recipe takes that id. Thatis 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. Thisserver does the arithmetic itself and, more importantly, says what it could notcompute. Every ingredient comes back with a scaling flag:

Two rules are enforced. Scaling a recipe down never asks for more than theoriginal: half a sachet at factor 0.667 becomes a third of a sachet, never a wholeone. 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 italso 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 searchresults, so this server does not, and there is no page parameter. Narrow the queryinstead.

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

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

Configuration

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

Troubleshooting

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

parse_failure errors. Marmiton changed how it publishes its structured dataand the server could not read the response. Pleaseopen an issue with the recipeyou asked for. The server reports this loudly rather than pretending it foundnothing.

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 withinvented recipes, so the tests are deterministic and no Marmiton content lives inthis repository.

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

Recipes, copyright and cooking

Ingredient lists and cooking steps are facts and procedures. The descriptive prosean 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 formachines, on demand, one request at a time, in response to an explicit requestfrom you or your assistant. It does not crawl the site, does not build a recipedatabase, and writes nothing to disk. It honours Marmiton's robots.txt, includingthe rule against paginating search results.

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

Rescaled quantities are computed, and cooking is not arithmetic: baking inparticular does not always scale linearly. Read them as a helpful starting pointand 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 therecipes retrieved through it.

mcp-marmiton (français)

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

Démarrage rapide

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

La recherche renvoie un id Marmiton pour chaque résultat, et get_recipe prendcet 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. Ceserveur fait le calcul lui-même et, surtout, signale ce qu'il n'a pas pucalculer. Chaque ingrédient porte un indicateur scaling :

Deux règles sont garanties. Réduire une recette ne demande jamais davantage quel'originale : un demi-sachet au facteur 0,667 devient un tiers de sachet, jamais unsachet 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 quipermet 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 lesrésultats de recherche, donc ce serveur ne le fait pas et n'expose aucun paramètrede page. Affinez plutôt la requête.

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

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

Configuration

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

Dépannage

Erreurs rate_limited. Marmiton limite ce client. Le serveur réessaie déjà avecbackoff et ralentit tout seul. Patientez un instant, et augmentezMARMITON_MIN_INTERVAL_MS si cela persiste. Cela ne signifie jamais que la recetteest absente.

Erreurs parse_failure. Marmiton a changé la façon dont il publie ses donnéesstructurées et le serveur n'a pas su lire la réponse. Merci d'ouvrir une issueen indiquant la recette demandée. Le serveur signale ce cas au lieu de faire commes'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-LDde 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 estpublié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 serveurne 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 pourles machines, à la demande, une requête à la fois, en réponse à une demande explicitede votre part ou de celle de votre assistant. Il ne parcourt pas le site, ne constitueaucune base de recettes et n'écrit rien sur le disque. Il respecte le robots.txt deMarmiton, 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 ouréutilisez ce que renvoie ce serveur, conservez cette attribution et le lien versMarmiton.

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 lesrecettes récupérées par son intermédiaire.