{ "markdown": "# mcp-marmiton\n\n[![npm](https://img.shields.io/npm/v/mcp-marmiton.svg)](https://www.npmjs.com/package/mcp-marmiton)\n[![CI](https://github.com/smeet666/mcp-marmiton/actions/workflows/ci.yml/badge.svg)](https://github.com/smeet666/mcp-marmiton/actions/workflows/ci.yml)\n[![license](https://img.shields.io/npm/l/mcp-marmiton.svg)](./LICENSE)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-6E56CF)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.smeet666/mcp-marmiton)\n[![Glama](https://glama.ai/mcp/servers/smeet666/mcp-marmiton/badges/score.svg)](https://glama.ai/mcp/servers/smeet666/mcp-marmiton)\n[![M8ven](https://m8ven.ai/badge/mcp/smeet666-mcp-marmiton-1f9qvs?variant=verified)](https://m8ven.ai/mcp/smeet666-mcp-marmiton-1f9qvs)\n[![LobeHub](https://lobehub.com/badge/mcp/smeet666-mcp-marmiton)](https://lobehub.com/mcp/smeet666-mcp-marmiton)\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=marmiton&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1tYXJtaXRvbiJdfQ%3D%3D)\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=marmiton&config=%7B%22name%22%3A%22marmiton%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-marmiton%22%5D%7D)\n\n\n\n[Marmiton](https://www.marmiton.org) is the largest French cooking site, where\nhome cooks have been publishing their recipes since 1999. Each one gives its\ningredients with their quantities, the steps to follow, the preparation and\ncooking times, the number of servings it is written for, and the ratings the\npeople who made it left behind.\n\nThis server connects a chat client to that site. You can search its recipes by\ndish or by ingredient, read one in full with its ingredients and its steps, and\n**rescale the quantities to the number of people at your table**, with each line\nsaying whether the figure is exact or was moved to stay usable in a kitchen. It\nneeds no API key and no account.\n\n_[Version française](#mcp-marmiton-français)_\n\n---\n\n## Install\n\n**One-click install**\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=marmiton&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1tYXJtaXRvbiJdfQ%3D%3D)\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=marmiton&config=%7B%22name%22%3A%22marmiton%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-marmiton%22%5D%7D)\n\n**Claude Code**\n\n```bash\nclaude mcp add marmiton -- npx -y mcp-marmiton\n```\n\n**Claude Desktop, Cursor, and any client using the standard config format**\n\n```json\n{\n \"mcpServers\": {\n \"marmiton\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-marmiton\"]\n }\n }\n}\n```\n\nNode 24 or later is required, and no environment variable has to be set.\n\n### With Docker\n\n```json\n{\n \"mcpServers\": {\n \"marmiton\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"ghcr.io/smeet666/mcp-marmiton:2.0.1\"]\n }\n }\n}\n```\n\n`-i` keeps stdin open, which is where the protocol travels, and `-t` is left out\nbecause a TTY rewrites the stream. The container needs outbound HTTPS to\n`www.marmiton.org`, and nothing else: no volume, no port, no credential.\n\n### Bundle, without npm\n\nDownload `mcp-marmiton-2.0.1.mcpb` from\n[the latest release](https://github.com/smeet666/mcp-marmiton/releases/latest)\nand open it. A client that supports MCP bundles installs it on its own, with no\nnpm and no configuration file to edit. The bundle carries its dependencies, so\nnothing is fetched at install time.\n\n## What you can ask\n\n- « Trouve-moi une recette de tarte aux pommes. »\n- \"Read me that recipe for six people instead of four.\"\n- \"What can I make with courgettes and chèvre?\"\n- \"Here is a recipe I copied from a book, scale it by 1.5 for me.\"\n- \"How long does the second one take to cook?\"\n\nMarmiton is a French site, so its recipes are found in French: `tarte aux\npommes`, `poulet curry coco`. The ordinary path runs from a search to a reading:\n`search_recipes` names an `id`, and `get_recipe` takes that id.\n\n## Tools\n\n| Tool | What it does |\n| ------------------- | -------------------------------------------------------------- |\n| `search_recipes` | Finds recipes by dish or by ingredient. |\n| `get_recipe` | Reads one recipe, rescaled to a number of servings on request. |\n| `scale_ingredients` | Rescales any ingredient list, with no request to the site. |\n\nThe server only reads. It publishes nothing to Marmiton.\n\n### `search_recipes`\n\nSearches the recipes for a dish or an ingredient. Marmiton matches on the opening\nletters of a word, so a query brings back what the site ranked for it, and the\nanswer says when the titles carry none of the words asked for.\n\n| Argument | Type | Required | What it does |\n| -------- | ------------------------------ | -------- | ------------------------------------------- |\n| `query` | string, up to 200 characters | yes | What to search for, in French. |\n| `limit` | integer, 1 to 30, default `10` | no | Recipes to serve from this page of results. |\n\n**In return:** rows carrying `id`, which `get_recipe` takes; `title`; `url`; and\n`image_url`, which is `null` for a recipe published without a picture. Alongside\ncome `result_count` and `total_available`, the recipes on this page before\n`limit` was applied. Marmiton's robots.txt disallows paging through search\nresults, so one page is what a search reads: narrow the query to see other\nrecipes.\n\n### `get_recipe`\n\nReads one recipe in full, and rescales its quantities when a number of servings\nis given.\n\n| Argument | Type | Required | What it does |\n| ---------- | ----------------------------- | ---------- | -------------------------------------------------------- |\n| `id` | string of digits | one of two | The Marmiton recipe id, as `search_recipes` returned it. |\n| `url` | a marmiton.org URL | one of two | The address of the recipe, used when `id` is absent. |\n| `servings` | number, above 0 and up to 500 | no | Rescale the quantities to this many servings. |\n\n**In return:** `title`, `url`, `ingredients`, `steps`, `prep_minutes`,\n`cook_minutes`, `total_minutes`, `category`, `author`, `rating` and `nutrition`,\neach `null` when the page publishes none. `yield` says what the recipe was\nwritten for and what it was rescaled to: `original_count`, `original_text`,\n`requested`, `unit` for what is being counted, and `factor` for the multiplier\napplied. Every ingredient carries `original`, `text`, `amount`, `amountMax` for a\nrange, `unit`, and `scaling`, which reads `scaled`, `rounded` or `unscaled`. The\nfigures are this server's arithmetic, so say they were recomputed when you show\nthem. `nutrition` describes the recipe as published, at its own number of\nservings.\n\n### `scale_ingredients`\n\nApplies the same arithmetic to any list of ingredient lines, with no request to\nthe site, so it works on a recipe copied from a book or a family notebook.\n\n| Argument | Type | Required | What it does |\n| --------------- | ------------------------------------------ | ---------- | ------------------------------------------ |\n| `ingredients` | array of 1 to 100 strings, up to 300 chars | yes | The lines to rescale, in French. |\n| `factor` | number, above 0 and up to 100 | one of two | The multiplier to apply. |\n| `from_servings` | number, above 0 and up to 500 | one of two | How many servings the list is written for. |\n| `to_servings` | number, above 0 and up to 500 | one of two | How many servings are wanted. |\n\nPass `factor`, or the `from_servings` and `to_servings` pair.\n\n**In return:** the `factor` used, the rescaled `ingredients` in the shape\n`get_recipe` returns, and `scaled_count`, `rounded_count` and `unscaled_count`,\nwhich count the lines whose value the rounding moved.\n\n## Scaling the quantities\n\nEvery ingredient comes back with a `scaling` flag saying what the rescaling could\ndo with its quantity.\n\n| Flag | Meaning | Example |\n| ---------- | ------------------------------------------------ | ---------------------------------------- |\n| `scaled` | The value is the product itself. | `3 oeufs` ×2 → `6 oeufs` |\n| `rounded` | The value was moved to stay usable. | `25 cl de lait` ×0.667 → `17 cl de lait` |\n| `unscaled` | Carries no quantity, so left exactly as written. | `sel`, `coriandre` |\n\nA quantity is stated in the unit that suits it, so a line can come back in a\ndifferent unit from the one the recipe used: 200 g multiplied by twenty reads\n`4 kg`.\n\nHow finely an ingredient can be divided depends on what it is. A baguette can be\ncut in two, in three or in four; an egg cannot be shared out. A quantity landing\nbetween the two is rounded, and the rescaled recipe then departs a little from\nthe proportions of the original. The line carries `rounded`, and its `note` says\nwhat was done.\n\n## Configuration\n\nEvery variable is optional. Set them in the `env` block of your client config.\n\n| Variable | Default | What it does |\n| ---------------------------- | -------------------- | --------------------------------------------------------------------------------------------------- |\n| `MARMITON_USER_AGENT` | the project identity | Names your application to Marmiton, with an address where a person can be reached. |\n| `MARMITON_MIN_INTERVAL_MS` | `1000` | Gap between two requests, from 500 to 60000. A figure under the floor is refused and this one used. |\n| `MARMITON_TIMEOUT_MS` | `15000` | Deadline for one request, from 1000 to 120000. |\n| `MARMITON_MAX_RETRIES` | `3` | Attempts after a transient failure, from 0 to 10. |\n| `MARMITON_CACHE_TTL_MS` | `900000` | How long a page stays in memory, from 0 to 86400000. |\n| `MARMITON_CACHE_MAX_ENTRIES` | `200` | Pages held in memory at once, from 0 to 10000. |\n| `MARMITON_LOG_LEVEL` | `error` | `silent`, `error`, `info` or `debug`, written to stderr. |\n\nA value outside its range falls back to the default, and the reason is written to\nstderr.\n\n## Errors\n\nEvery failure carries one of six codes, a message, and where it helps a hint\nnaming the next move.\n\n| Code | What happened | What to do |\n| --------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |\n| `not_found` | Marmiton answered, and holds no such recipe. | Check the id with `search_recipes`. |\n| `invalid_input` | The arguments were refused before any request went out. | Read the message, which names the argument. |\n| `rate_limited` | Marmiton asked this client to slow down. | Wait the number of seconds the hint names and call again with the same arguments. The recipe is still there. |\n| `parse_failure` | The page loaded and the expected content was absent. | Report it at [the issue tracker](https://github.com/smeet666/mcp-marmiton/issues). |\n| `network_error` | The request did not complete. | Try again shortly. |\n| `timeout` | The request passed its deadline. | Raise `MARMITON_TIMEOUT_MS`. |\n\n## As a library\n\nThe layer reading Marmiton is published on its own, with its pacing, its cache\nand its errors, and with no protocol attached.\n\n```ts\nimport { MarmitonClient } from \"mcp-marmiton/client\";\n\nconst client = new MarmitonClient();\nconst { data, cached } = await client.getRecipe({ id: \"18257\" });\nconsole.log(data.title, data.ingredients.length, cached);\n```\n\n`search` and `getRecipe` each answer `{ data, cached }`, and throw an error\ncarrying one of the six codes. The floor between two requests holds here as well.\n\n## Pacing and attribution\n\nRequests go out one at a time with a minimum gap between them, and that floor\nholds however the server is configured. The `User-Agent` always ends with the\nproject identity and an address where a person can be reached. Everything is read\nfrom the `schema.org` JSON-LD Marmiton publishes for machines, and the paths its\nrobots.txt disallows are left alone.\n\nEvery result carries the title and the address of the recipe, and `get_recipe`\ncarries the author when the page names one, along with `attribution`, the title\nand the address written as one line.\n\nThe recipes belong to Marmiton and to the cooks who wrote them. This MCP server\nis an unofficial project, with no affiliation to Marmiton.\n\n## Privacy\n\nThis server collects nothing about you and sends nothing to its author. It runs\non your machine, contacts `www.marmiton.org` and nothing else, holds its answers in memory\nwhile it runs, and writes nothing to disk.\n[PRIVACY.md](PRIVACY.md) states what a request carries and which settings change\nany of it.\n\n## Development\n\n```bash\nnpm install\nnpm run build:fixtures\nnpm test\nnpm run check\n```\n\nTests run against generated fixtures and make no network request. The live suite,\n`npm run test:live`, makes one request per route and runs nightly against the\nsite itself.\n\n## Contributing\n\nBugs, questions and ideas belong in\n[the issue tracker](https://github.com/smeet666/mcp-marmiton/issues). Pull\nrequests are welcome; opening an issue first helps agree on the shape of the\nchange. See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nMIT, see [LICENSE](LICENSE). The recipes belong to Marmiton and to their authors.\n\n---\n\n\n\n# mcp-marmiton (français)\n\n_[English version](#mcp-marmiton)_\n\n[Marmiton](https://www.marmiton.org) est le plus grand site de cuisine français,\noù des cuisiniers publient leurs recettes depuis 1999. Chacune donne ses\ningrédients avec leurs quantités, les étapes à suivre, les temps de préparation\net de cuisson, le nombre de parts pour lequel elle est écrite, et les notes\nlaissées par ceux qui l'ont faite.\n\nCe serveur relie un client de conversation à ce site. On peut y chercher des\nrecettes par plat ou par ingrédient, en lire une en entier avec ses ingrédients\net ses étapes, et **adapter les quantités au nombre de convives**, chaque ligne\ndisant si le chiffre est exact ou s'il a été déplacé pour rester utilisable en\ncuisine. Aucune clé d'API, aucun compte.\n\n## Installation\n\n**Installation en un clic**\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=marmiton&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1tYXJtaXRvbiJdfQ%3D%3D)\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=marmiton&config=%7B%22name%22%3A%22marmiton%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-marmiton%22%5D%7D)\n\n**Claude Code**\n\n```bash\nclaude mcp add marmiton -- npx -y mcp-marmiton\n```\n\n**Claude Desktop, Cursor, et tout client au format de configuration standard**\n\n```json\n{\n \"mcpServers\": {\n \"marmiton\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-marmiton\"]\n }\n }\n}\n```\n\nNode 24 ou plus récent est nécessaire, et aucune variable d'environnement n'est à\nrenseigner.\n\n### Avec Docker\n\n```json\n{\n \"mcpServers\": {\n \"marmiton\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"ghcr.io/smeet666/mcp-marmiton:2.0.1\"]\n }\n }\n}\n```\n\n`-i` garde l'entrée standard ouverte, qui est le canal du protocole, et `-t` est\nomis parce qu'un TTY réécrit le flux. Le conteneur a besoin d'un accès HTTPS\nsortant vers `www.marmiton.org`, et de rien d'autre : aucun volume, aucun port,\naucun identifiant.\n\n### Bundle, sans npm\n\nTéléchargez `mcp-marmiton-2.0.1.mcpb` depuis\n[la dernière publication](https://github.com/smeet666/mcp-marmiton/releases/latest)\net ouvrez-le. Un client qui gère les bundles MCP l'installe seul, sans npm et\nsans fichier de configuration à modifier. Le bundle emporte ses dépendances, donc\nrien n'est téléchargé à l'installation.\n\n## Ce qu'on peut demander\n\n- « Trouve-moi une recette de tarte aux pommes. »\n- « Lis-moi cette recette pour six personnes au lieu de quatre. »\n- « Qu'est-ce que je peux faire avec des courgettes et du chèvre ? »\n- « Voici une recette recopiée d'un livre, multiplie-la par 1,5. »\n- « Combien de temps de cuisson pour la deuxième ? »\n\nMarmiton est un site français, donc ses recettes se trouvent en français : `tarte\naux pommes`, `poulet curry coco`. Le chemin ordinaire va d'une recherche à une\nlecture : `search_recipes` nomme un `id`, et `get_recipe` reprend cet\nidentifiant.\n\n## Les outils\n\n| Outil | Ce qu'il fait |\n| ------------------- | ------------------------------------------------------------------ |\n| `search_recipes` | Trouve des recettes par plat ou par ingrédient. |\n| `get_recipe` | Lit une recette, adaptée à un nombre de parts sur demande. |\n| `scale_ingredients` | Adapte n'importe quelle liste d'ingrédients, sans requête au site. |\n\nLe serveur ne fait que lire. Il ne publie rien sur Marmiton.\n\n### `search_recipes`\n\nCherche des recettes par plat ou par ingrédient. Marmiton fait correspondre les\npremières lettres d'un mot, donc une requête ramène ce que le site a classé pour\nelle, et la réponse signale quand les titres ne portent aucun des mots demandés.\n\n| Argument | Type | Requis | Ce qu'il fait |\n| -------- | ------------------------------ | ------ | ------------------------------------------------- |\n| `query` | chaîne, jusqu'à 200 caractères | oui | Ce qu'on cherche, en français. |\n| `limit` | entier, 1 à 30, défaut `10` | non | Recettes à servir depuis cette page de résultats. |\n\n**En retour :** des lignes portant `id`, que `get_recipe` reprend ; `title` ;\n`url` ; et `image_url`, `null` pour une recette publiée sans photo. Viennent\naussi `result_count` et `total_available`, les recettes de cette page avant\nl'application de `limit`. Le robots.txt de Marmiton interdit de paginer les\nrésultats de recherche, donc une recherche lit une page : resserrez la requête\npour voir d'autres recettes.\n\n### `get_recipe`\n\nLit une recette en entier, et adapte ses quantités quand un nombre de parts est\ndonné.\n\n| Argument | Type | Requis | Ce qu'il fait |\n| ---------- | -------------------------------- | ------------- | -------------------------------------------------- |\n| `id` | chaîne de chiffres | l'un des deux | L'identifiant Marmiton rendu par `search_recipes`. |\n| `url` | une adresse marmiton.org | l'un des deux | L'adresse de la recette, utilisée à défaut d'`id`. |\n| `servings` | nombre, au-delà de 0 jusqu'à 500 | non | Adapte les quantités à ce nombre de parts. |\n\n**En retour :** `title`, `url`, `ingredients`, `steps`, `prep_minutes`,\n`cook_minutes`, `total_minutes`, `category`, `author`, `rating` et `nutrition`,\nchacun `null` quand la page n'en publie pas. `yield` dit pour quoi la recette est\nécrite et vers quoi elle a été adaptée : `original_count`, `original_text`,\n`requested`, `unit` pour ce qui est compté, et `factor` pour le multiplicateur\nappliqué. Chaque ingrédient porte `original`, `text`, `amount`, `amountMax` pour\nun intervalle, `unit`, et `scaling`, qui vaut `scaled`, `rounded` ou `unscaled`.\nLes chiffres sont l'arithmétique de ce serveur, donc dites qu'ils ont été\nrecalculés quand vous les montrez. `nutrition` décrit la recette telle que\npubliée, pour son propre nombre de parts.\n\n### `scale_ingredients`\n\nApplique la même arithmétique à n'importe quelle liste d'ingrédients, sans\nrequête au site, donc sur une recette recopiée d'un livre ou d'un carnet de\nfamille.\n\n| Argument | Type | Requis | Ce qu'il fait |\n| --------------- | -------------------------------------------------- | ------------- | --------------------------------------------------- |\n| `ingredients` | tableau de 1 à 100 chaînes, jusqu'à 300 caractères | oui | Les lignes à adapter, en français. |\n| `factor` | nombre, au-delà de 0 jusqu'à 100 | l'un des deux | Le multiplicateur à appliquer. |\n| `from_servings` | nombre, au-delà de 0 jusqu'à 500 | l'un des deux | Le nombre de parts pour lequel la liste est écrite. |\n| `to_servings` | nombre, au-delà de 0 jusqu'à 500 | l'un des deux | Le nombre de parts voulu. |\n\nPassez `factor`, ou le couple `from_servings` et `to_servings`.\n\n**En retour :** le `factor` employé, les `ingredients` adaptés dans la forme que\nrend `get_recipe`, et `scaled_count`, `rounded_count` et `unscaled_count`, qui\ncomptent les lignes dont l'arrondi a déplacé la valeur.\n\n## L'adaptation des quantités\n\nChaque ingrédient revient avec un drapeau `scaling` qui dit ce que l'adaptation a\npu faire de sa quantité.\n\n| Drapeau | Ce que cela veut dire | Exemple |\n| ---------- | ------------------------------------------------ | ---------------------------------------- |\n| `scaled` | La valeur est le produit lui-même. | `3 oeufs` ×2 → `6 oeufs` |\n| `rounded` | La valeur a été déplacée pour rester utilisable. | `25 cl de lait` ×0,667 → `17 cl de lait` |\n| `unscaled` | Ne porte aucune quantité, laissée telle quelle. | `sel`, `coriandre` |\n\nUne quantité est exprimée dans l'unité qui lui convient. Après adaptation, une\nligne peut donc apparaître dans une autre unité que celle de la recette : 200 g\nmultipliés par vingt donnent `4 kg`.\n\nLa finesse à laquelle un ingrédient se coupe dépend de sa nature. Une baguette se\ncoupe en deux, en trois ou en quatre ; un oeuf ne se partage pas. Une quantité\nqui tombe entre les deux est donc arrondie, et la recette adaptée s'écarte alors\nun peu des proportions de l'originale. La ligne porte `rounded`, et sa `note` dit\nce qui a été fait.\n\n## Configuration\n\nChaque variable est facultative. Elles se posent dans le bloc `env` de la\nconfiguration du client.\n\n| Variable | Défaut | Ce qu'elle fait |\n| ---------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------- |\n| `MARMITON_USER_AGENT` | l'identité du projet | Nomme votre application auprès de Marmiton, avec une adresse où joindre une personne. |\n| `MARMITON_MIN_INTERVAL_MS` | `1000` | Écart entre deux requêtes, de 500 à 60000. Une valeur sous le plancher est refusée au profit de celle-ci. |\n| `MARMITON_TIMEOUT_MS` | `15000` | Délai d'une requête, de 1000 à 120000. |\n| `MARMITON_MAX_RETRIES` | `3` | Tentatives après un échec passager, de 0 à 10. |\n| `MARMITON_CACHE_TTL_MS` | `900000` | Durée pendant laquelle une page reste en mémoire, de 0 à 86400000. |\n| `MARMITON_CACHE_MAX_ENTRIES` | `200` | Pages gardées en mémoire à la fois, de 0 à 10000. |\n| `MARMITON_LOG_LEVEL` | `error` | `silent`, `error`, `info` ou `debug`, écrit sur la sortie d'erreur. |\n\nUne valeur hors de sa plage retombe sur le défaut, et la raison est écrite sur la\nsortie d'erreur.\n\n## Erreurs\n\nChaque échec porte un des six codes, un message, et quand cela aide une\nindication du geste suivant.\n\n| Code | Ce qui s'est passé | Que faire |\n| --------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------- |\n| `not_found` | Marmiton a répondu, et n'a pas cette recette. | Vérifiez l'identifiant avec `search_recipes`. |\n| `invalid_input` | Les arguments ont été refusés avant toute requête. | Lisez le message, qui nomme l'argument. |\n| `rate_limited` | Marmiton demande à ce client de ralentir. | Attendez les secondes indiquées et rappelez avec les mêmes arguments. La recette est toujours là. |\n| `parse_failure` | La page a chargé et le contenu attendu est absent. | Signalez-le sur [le suivi d'incidents](https://github.com/smeet666/mcp-marmiton/issues). |\n| `network_error` | La requête n'a pas abouti. | Réessayez sous peu. |\n| `timeout` | La requête a dépassé son délai. | Augmentez `MARMITON_TIMEOUT_MS`. |\n\n## Comme bibliothèque\n\nLa couche qui lit Marmiton est publiée seule, avec son rythme, son cache et ses\nerreurs, sans protocole attaché.\n\n```ts\nimport { MarmitonClient } from \"mcp-marmiton/client\";\n\nconst client = new MarmitonClient();\nconst { data, cached } = await client.getRecipe({ id: \"18257\" });\nconsole.log(data.title, data.ingredients.length, cached);\n```\n\n`search` et `getRecipe` répondent chacun `{ data, cached }`, et lèvent une erreur\nportant un des six codes. Le plancher entre deux requêtes tient également ici.\n\n## Rythme et attribution\n\nLes requêtes partent une à une avec un écart minimal entre elles, et ce plancher\ntient quelle que soit la configuration. Le `User-Agent` se termine toujours par\nl'identité du projet et une adresse où joindre une personne. Tout est lu dans le\nJSON-LD `schema.org` que Marmiton publie pour les machines, et les chemins que\nson robots.txt interdit sont laissés tranquilles.\n\nChaque résultat porte le titre et l'adresse de la recette, et `get_recipe` porte\nl'auteur quand la page le nomme, ainsi qu'`attribution`, le titre et l'adresse\nécrits en une ligne.\n\nLes recettes appartiennent à Marmiton et aux cuisiniers qui les ont écrites.\nCe MCP est un projet non officiel, sans affiliation à Marmiton.\n\n## Confidentialité\n\nCe serveur ne collecte rien sur vous et n'envoie rien à son auteur. Il tourne sur\nvotre machine, ne joint que `www.marmiton.org`, garde ses réponses en mémoire le temps qu'il\ntourne, et n'écrit rien sur le disque. [PRIVACY.md](PRIVACY.md) dit ce qu'une\nrequête emporte et quels réglages changent cela.\n\n## Développement\n\n```bash\nnpm install\nnpm run build:fixtures\nnpm test\nnpm run check\n```\n\nLes tests s'exécutent sur des fixtures engendrées et n'émettent aucune requête.\nLa suite en direct, `npm run test:live`, émet une requête par route et tourne\nchaque nuit contre le site lui-même.\n\n## Contribuer\n\nLes anomalies, les questions et les idées ont leur place dans\n[le suivi d'incidents](https://github.com/smeet666/mcp-marmiton/issues). Les\npropositions de modification sont bienvenues ; ouvrir un ticket d'abord aide à\ns'accorder sur la forme du changement. Voir [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Licence\n\nMIT, voir [LICENSE](LICENSE). Les recettes appartiennent à Marmiton et à leurs\nauteurs.\n", "bytes": 29357, "sha": "71145be436ee2440fc9d0bdda7e514ff980b179682a6ddc911a3755cd5361b39", "repo_slug": "smeet666/mcp-marmiton", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_smeet666_mcp_marmiton_0c36c63f/readme" }