mcp-marmiton 1.3.1 → 1.6.0

package/README.md

@@ -4,6 +4,7 @@
 [![CI](https://github.com/smeet666/mcp-marmiton/actions/workflows/ci.yml/badge.svg)](https://github.com/smeet666/mcp-marmiton/actions/workflows/ci.yml)
 [![license](https://img.shields.io/npm/l/mcp-marmiton.svg)](./LICENSE)
 [![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-6E56CF)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.smeet666/mcp-marmiton)
+[![Glama](https://glama.ai/mcp/servers/smeet666/mcp-marmiton/badges/score.svg)](https://glama.ai/mcp/servers/smeet666/mcp-marmiton)
 
 An [MCP](https://modelcontextprotocol.io) server for [Marmiton](https://www.marmiton.org),
 the French recipe site. Search recipes, read their ingredients and steps, and
@@ -68,27 +69,74 @@ Asking a language model to divide a recipe by 1.5 tends to produce "2.4 eggs" an
 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`    |
+| Flag       | Meaning                                            | Example                                  |
+| ---------- | -------------------------------------------------- | ---------------------------------------- |
+| `scaled`   | The value is the product itself.                   | `3 oeufs` ×2 → `6 oeufs`                 |
+| `rounded`  | The value had to be moved to stay usable.          | `25 cl de lait` ×0.667 → `17 cl de lait` |
+| `unscaled` | Carries no quantity, so left exactly as published. | `sel`, `coriandre`                       |
+
+A count reaches an exact product as readily as a mass does: one pinch multiplied
+by six is six pinches, and that line is `scaled`. `rounded` is for a value that
+landed somewhere the arithmetic did not put it, a half egg taken to a whole one
+or 133.4 g written as 135 g.
 
 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.
+original: half a sachet at factor 0.667 stays half 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.
+
+**A counted thing is divided by what it holds, not by what holds it.** A boîte de
+tomates is poured and the rest kept, a sachet de sucre vanillé is split by eye, a
+feuille de gélatine is cut with scissors, a branche de thym is broken in two: all
+of those land on a half. Half an oeuf would have to be
+beaten and weighed, which is not an amount a recipe asks for, so a count of oeufs,
+jaunes or blancs d'oeufs lands on a whole number. A few things are decided by what
+they are: a clou de girofle and a zeste are counted whole, a pot and a bouteille
+hold enough for a quarter to be a portion, a gousse and a tranche are cut off
+something larger and take a corner off in the same gesture, a blanc de poulet is
+meat and halves, and a douzaine states a number of things rather than a measure
+of them, so `2 douzaines d'escargots` at three quarters comes back as
+`18 escargots`.
+
+**A thing counted on its own is divided by the size of one against what a recipe
+puts in.** Une crevette, une moule, une noisette, un grain de poivre, une baie de
+genièvre, un anis étoilé is already a portion: a recipe counts twelve of them
+and a smaller recipe puts one fewer in the pan, so they land on a whole number.
+Un gigot, une baguette, un camembert, un ananas, un oignon, une pastèque, une
+pintade, un poulet, un poireau sits at
+the other end of that comparison, asked for by the one or the two and shared out
+with a knife, so they go as far as the quarter. A cut carved off one of them
+stops at the half, une cuisse and une aile being the portion the knife already
+produced. Un jus stops at the half: half
+the jus of a citron is taken by squeezing half the fruit, and a quarter of one
+has to be poured out and measured back.
+
+Approximate measures are quantities too. A pinch, a handful, a bouchon or a
+ramequin has the size the cook gives it, and the recipe's proportion lives in how
+many are asked for, so the count is multiplied in whole units: `une pincée de
+bicarbonate de soude` from 6 servings to 25 comes back as `4 pincées de
+bicarbonate de soude`, carrying a note. Nothing is ever
+converted into grams or spoons, where published equivalences span a fourfold
+range; an order of magnitude belongs in a note, never in the quantity.
 
 Ranges are read as one quantity: "2 à 3 gousses" doubled reads "4 à 6 gousses",
 and `amount` reports the upper bound, since that is what a cook buys.
 
-Each ingredient also carries `adjusted`, which says whether rounding actually
-moved the number. A line can be `rounded` and still land exactly, as three eggs
-doubled land on six, so read `adjusted` rather than the flag when what you want
-to know is whether a quantity was touched.
-
-Below a quarter there is nothing a kitchen can measure, so the amount is clamped
-up and **the line stops holding its share of the recipe**. Half a sachet of
+A line that writes an article where a digit would go is read as one of the
+measure that follows it: `un bouchon de rhum` scaled sixfold is
+`6 bouchons de rhum`, and the note says which word the figure came from. A noun
+sitting between the amount and the `de` that introduces what is measured names a
+container or a gesture, which is how a measure the vocabulary has never met is
+still read. An article before a bare countable thing, as in `un oignon`, leaves
+the line as published.
+
+Each ingredient also carries `adjusted`, which says whether rounding moved the
+number away from the exact product.
+
+A shrinking line keeps the smallest share still worth measuring: a knife takes an
+oignon to a quarter, a boîte or a sachet goes to a half, an oeuf stops at one.
+Under that floor the amount is clamped up and **the line stops holding its share
+of the recipe**. Half a sachet of
 baking powder against three pots of flour comes out four times too strong that
 way, so the ingredient and the response both say it happened rather than leaving
 you to find out in the oven.
@@ -261,28 +309,64 @@ et « 0,67 pincée de sel », énoncés avec le même aplomb qu'un chiffre juste
 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`    |
+| Indicateur | Sens                                                 | Exemple                                  |
+| ---------- | ---------------------------------------------------- | ---------------------------------------- |
+| `scaled`   | La valeur est le produit exact.                      | `3 oeufs` ×2 → `6 oeufs`                 |
+| `rounded`  | La valeur a dû être déplacée pour rester utilisable. | `25 cl de lait` ×0,667 → `17 cl de lait` |
+| `unscaled` | Ne porte aucune quantité, laissé tel que publié.     | `sel`, `coriandre`                       |
+
+Un décompte tombe juste aussi bien qu'une masse : une pincée multipliée par six
+fait six pincées, et cette ligne est `scaled`. `rounded` désigne une valeur posée
+ailleurs que là où le calcul la mettait, un demi-œuf ramené à un œuf entier ou
+133,4 g écrits 135 g.
 
 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
+l'originale : un demi-sachet au facteur 0,667 reste un demi-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.
 
+**Un dénombrable se divise selon son contenu, pas selon son emballage.** Une boîte
+de tomates se verse et le reste se garde, un sachet de sucre vanillé se partage à
+l'œil, une feuille de gélatine se coupe aux ciseaux, une branche de thym se casse
+en deux : tous tombent sur une demie. Un demi-œuf, lui,
+demanderait de le battre et de le peser, ce qu'aucune recette ne demande : un
+nombre d'œufs, de jaunes ou de blancs d'œufs tombe sur un entier. Quelques cas se
+décident sur la nature de la chose : un clou de girofle et un zeste se comptent
+entiers, un pot et une bouteille en contiennent assez pour qu'un quart soit une
+portion, une gousse et une tranche sont déjà taillées dans plus grand et la
+planche leur reprend un coin du même geste, un blanc de poulet est une viande et
+se coupe en deux, et une douzaine
+énonce un nombre de choses plutôt qu'une mesure, si bien que
+« 2 douzaines d'escargots » réduites d'un quart reviennent en « 18 escargots ».
+
+Les mesures approximatives sont des quantités elles aussi. Une pincée, une
+poignée, un bouchon ou un ramequin ont la taille que le cuisinier leur donne,
+et la proportion de la recette tient au nombre demandé : ce nombre est donc
+multiplié, en unités entières. « une pincée de bicarbonate de soude » de 6 à 25
+parts revient en « 4 pincées de bicarbonate de soude », accompagnée d'une
+note. Aucune conversion en grammes ni en cuillères : les
+équivalences publiées varient du simple au quadruple, et un ordre de grandeur a
+sa place dans une note, jamais dans la quantité.
+
 Les fourchettes sont lues comme une seule quantité : « 2 à 3 gousses » doublé
 donne « 4 à 6 gousses », et `amount` renvoie la borne haute, celle que l'on
 achète.
 
-Chaque ingrédient porte aussi `adjusted`, qui dit si l'arrondi a réellement
-déplacé le nombre. Une ligne peut être `rounded` et tomber juste, comme trois
-œufs doublés qui font six, donc lisez `adjusted` plutôt que l'indicateur quand
-la question est de savoir si une quantité a été touchée.
-
-Sous un quart, il n'y a plus rien qu'une cuisine puisse mesurer : la quantité est
-alors remontée et **la ligne cesse de tenir sa part de la recette**. Un demi-sachet
+Une ligne qui écrit un article là où irait un chiffre est lue comme une unité de
+la mesure qui suit : « un bouchon de rhum » multiplié par six donne « 6 bouchons
+de rhum », et la note indique de quel mot vient le chiffre. Un nom placé entre la
+quantité et le « de » qui introduit ce qui est mesuré désigne un contenant ou un
+geste, ce qui permet de lire une mesure absente du vocabulaire. Un article devant
+une chose dénombrable seule, comme « un oignon », laisse la ligne telle que
+publiée.
+
+Chaque ingrédient porte aussi `adjusted`, qui dit si l'arrondi a déplacé le
+nombre par rapport au produit exact.
+
+Une ligne qui rétrécit garde la plus petite part qui vaille encore la peine : le
+couteau mène un oignon au quart, une boîte ou un sachet s'arrêtent à la demie, un
+œuf s'arrête à l'unité. Sous ce plancher, la quantité est remontée et **la ligne
+cesse de tenir sa part de la recette**. Un demi-sachet
 de levure face à trois pots de farine ressort ainsi quatre fois trop dosé, donc
 l'ingrédient et la réponse le disent, plutôt que de vous le laisser découvrir au
 four.