mcp-recipes 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,147 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the versions follow
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Changed
+
+- How finely a counted thing divides now follows the size of one of them against
+  what a recipe puts in, and two families come out of that one comparison. Each
+  family is read in both languages, because where a food falls on that
+  comparison has nothing to do with the words a page uses for it.
+- A crevette and a shrimp, a gamba, a langoustine, a moule and a mussel, a
+  noisette and a hazelnut, a grain de poivre and a peppercorn, a baie de
+  genièvre and a juniper berry, an anis étoilé and a star anise are counted
+  whole. Each one is already a portion: a recipe counts five, twelve, twenty of
+  them, and a smaller recipe puts one fewer in the pan. `12 crevettes` halved
+  gave `6 crevettes` and still does, but `5 crevettes` halved gave
+  `2 1/2 crevettes` where it now gives `3 crevettes`, and `1 hazelnut` halved
+  gave `1/2 hazelnut` where it now keeps the hazelnut.
+- Un gigot and a leg of lamb, une baguette, un camembert, un fromage and a
+  cheese, un chorizo, un ananas and a pineapple, une pêche and a peach, un
+  abricot and an apricot, un lait and a milk counted without a measure divide as
+  far as the quarter. A recipe asks for one or for two, and the share it wants
+  is decided by a knife. `1 gigot d'agneau` reduced to a quarter was clamped up
+  to `1/2 gigot` and the line was told it no longer held its share; it now comes
+  back as `1/4 gigot d'agneau`, exact.
+- Un jus, and a juice, stops at the half, where it used to follow the fruit it
+  names down to the quarter. 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, so
+  `1 jus de citron` reduced to a quarter comes back as `1/2 jus de citron`.
+- A counted thing coming down to one now takes the singular of its name.
+  `2 clous de girofle` halved read `1 clous de girofle` and `2 kiwis` read
+  `1 kiwis`, because a final -s was taken for the ending of a singular such as
+  "jus" or "couscous". Both languages now name those words one by one, so the
+  two lines read `1 clou de girofle` and `1 kiwi`, while `2 ananas` reads
+  `1 ananas` and `1 asparagus` is left as it is. "anise" and "musk" read the
+  same whatever the number, so `8 star anise` halved gives `4 star anise`, and
+  an "étoilé" following the noun agrees with it in the same pass.
+- A clou de girofle and a zeste are counted whole. `3 clous de girofle` halved
+  came back as `1 1/2 clou`, and `1 zeste de citron` halved as `1/2 zeste`.
+  Neither names an amount: a clou is a dried bud dropped into the pot and fished
+  back out, and a zeste is what comes off one fruit in one go. They now land on
+  a whole number, as an oeuf does.
+- A pot, a bouteille, a bottle, a jar and a block divide as far as the quarter.
+  All five stopped at the half, so `1 pot de crème fraîche` reduced to a quarter
+  was clamped up to `1/2 pot` and the line was told it no longer held its share.
+  Each holds enough that a quarter is still a portion someone serves, so the
+  answer is now `1/4 pot de crème fraîche`, exact. The word is read wherever it
+  stands, so `1 petit pot de crème` gets the same floor.
+- Une gousse, une tranche and a slice divide as far as the quarter. Each is
+  already cut off something larger, and the board that produced one takes a
+  corner off it in the same gesture, so `1 gousse d'ail` reduced to a quarter
+  comes back as `1/4 gousse d'ail` where it came back as a half, and
+  `4 gousses d'ail` reads `1 gousse d'ail`.
+- Une pastèque and a watermelon, une pintade and a guinea fowl, un poulet and a
+  chicken, un poireau and a leek, une banane and a banana, une mangue and a
+  mango, un rôti and a roast, un avocat, un reblochon and une bûche divide as
+  far as the quarter, joining the gigot and the ananas. `1 pastèque` and
+  `1 watermelon` reduced to a quarter were clamped up to a half and the line was
+  told it no longer held its share; each now comes back as `1/4`, exact.
+- Une cuisse, une aile, un pilon, une escalope, un magret, a thigh, a drumstick,
+  a wing and a cutlet stop at the half, joining the blanc and the breast. One of
+  them is the portion the knife carving the animal already produced, and a
+  quarter of one names a piece no one plates. This is what keeps
+  `3 cuisses de poulet` at a half now that the whole poulet goes to the quarter.
+- `clove` is read on the line that writes it, having named two foods with one
+  answer between them. Garlic in the line makes it the gousse d'ail, which a
+  knife takes to a quarter, so `4 cloves garlic, minced` reduced to a quarter
+  reads `1 clove garlic, minced`. On its own, or written `whole cloves`, it is
+  the clou de girofle dropped into the pot and fished back out: nothing about it
+  is measured, so `4 whole cloves` halved reads `2 whole cloves` where it read
+  `1 whole clof`. The French words need none of this, each naming one food and
+  one only.
+- A zest is counted whole, as a zeste is. `1 lemon zest` halved came back as
+  half of one, and a zest is what comes off one fruit in one go, so a share of
+  one names no amount a cook stops at.
+- An English plural in -ves is turned back into its singular only for the names
+  that carry a -f or a -fe, which are listed one by one. `4 olives` halved read
+  `2 olives` and `1 olive` read `1 olif`.
+- A dozen, and a douzaine, states a number of things rather than a measure of
+  them. `2 dozen mushrooms` reduced by a quarter came back as
+  `1 1/2 dozen mushrooms`, a count no kitchen works with, and the divisibility
+  of the line was being read off a word that names no food. The multiplier is
+  now folded into the count: the same line comes back as `18 mushrooms`, and it
+  divides the way a mushroom does. A line writing the count as a word,
+  `a dozen eggs`, is read the same way where it used to carry no quantity.
+- A blanc is divided by which blanc the line names. `1 blanc de poulet` halved
+  came back whole, because the reading meant for the white of an oeuf was
+  catching every blanc introduced the same way. The white of an oeuf stays
+  whole, with the oeuf and the jaune; a blanc de poulet or de dinde is meat and
+  halves, as a chicken breast does.
+- `ea` no longer appears in the line that is written back. It is short for
+  "each", a marker announcing that the figure counts pieces, and it names no
+  measure of any one of them, so `3 ea. tamarind pods` tripled read
+  `9 ea tamarind pods` where it now reads `9 tamarind pods`. The count is
+  unchanged, and the divisibility now comes from the thing counted, so
+  `1 ea. onion` goes to a quarter and `12 ea. eggs` lands on a whole number.
+
+## [1.0.0] - 2026-02-06
+
+First release.
+
+### Added
+
+- `search_recipes`: asks every registered source at the same time and returns one
+  merged list. Every row carries an identifier naming the source it came from.
+  Rows alternate one source at a time, and the answer says how the order was
+  built.
+- `get_recipe`: reads one recipe from the source its identifier names, optionally
+  rescaled to a number of servings. Sections are opt-in and the omitted ones are
+  named, a raw identifier is routed by its shape and the answer says how, and a
+  page stating no yield comes back as published with the reason.
+- `scale_ingredients`: multiplies a list a caller already holds, offline, with no
+  request to any site. Reads French and English lines in one call, each in its
+  own language.
+- `compare_recipes`: takes a dish, reads each source's closest version, rescales
+  them all to the same yield, and states what differs between them. Where the
+  versions agree, it says nothing.
+- A bilingual scaler. An egg stays whole and anything that pours, weighs or cuts
+  can halve, a measurement moves to a smaller unit before it is rounded, an
+  approximate measure has its count multiplied while the size of one stays the
+  cook's, and every branch of a line offering a choice is scaled. Each line
+  reports whether the arithmetic was exact, rounded, or impossible.
+- Argument names checked rather than filtered. Every tool refuses an argument it
+  does not declare, under the `invalid_input` code, naming the argument and
+  offering the declared name when one is close: `limit` on `search_recipes` is
+  refused and answered with `limit_per_source`. The schema each tool publishes
+  carries `additionalProperties: false`, so a client reads the rule before it
+  calls. A name that is read and dropped costs a caller an answer computed on
+  the defaults and presented as an answer to what they asked.
+- Per-source reporting on every tool that calls out: which sources answered,
+  which failed and why, and what each source's own count means in its own
+  terms.
+- A published client entry point (`mcp-recipes/client`) and a published scaler
+  entry point (`mcp-recipes/scale`), both usable as plain libraries with no
+  protocol attached.
+- Pacing with a floor that configuration cannot go below, and a User-Agent that
+  always carries a way to reach a human.
+- A source registry, so adding a corpus is an adapter and an entry rather than a
+  branch in every tool.
+- A nightly canary against the real sites, which opens an issue when one of them
+  changes something this server reads.
+
+[1.0.0]: https://github.com/smeet666/mcp-recipes/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Damien Bouissou
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.