[图片]
mcp-pequerecetas
[npm]
[CI]
[license]
[MCP Registry]
[Glama]
[Install in Cursor]
[Install in VS Code]
Pequerecetas is a Spanish home-cooking site
written for families. It holds a few thousand recipes with their ingredients,
their steps and their photographs, and files each one under the diet it suits,
the appliance it is cooked in, the occasion it is made for and the age of whoever
eats it, from six months up.
This server connects a chat client to that site. You can search its recipes, read
one with its quantities rescaled to the number of people at your table, list the
values each taxonomy publishes, walk a taxonomy page by page, and rescale any
Spanish ingredient list you already hold. It needs no API key and no account.
Version française
Install
One-click install
[Install in Cursor]
[Install in VS Code]
Claude Code
Claude Desktop, Cursor, and any client using the standard config format
Node 24 or later is required, and no environment variable has to be set.
With Docker
-i keeps stdin open, which is where the protocol travels, and -t is left out
because a TTY rewrites the stream. The container needs outbound HTTPS to
www.pequerecetas.com, and nothing else: no volume, no port, no credential.
Bundle, without npm
Download mcp-pequerecetas-1.2.0.mcpb from
the latest release
and open it. A client that supports MCP bundles installs it on its own, with no
npm and no configuration file to edit. The bundle carries its dependencies, so
nothing is fetched at install time.
What you can ask
- « Búscame una receta de paella de marisco. »
- "Read me that recipe for eight people."
- "What can I cook in an air fryer on this site?"
- "Show me the purées it files under six months."
- "Scale this Spanish ingredient list by three."
Pequerecetas is written in Spanish and its search matches the words a page was
written with, so recipes are found in Spanish. The ordinary path runs from a
search or a taxonomy to a recipe: a row carries an id, and get_recipe takes
that id.
Tools
get_recipe
Reads one page of the recipe section, and rescales its quantities when a number
of servings is given.
In return: kind, which reads recipe or collection. The site publishes
both at this kind of address and describes them alike, so this is what tells them
apart: a collection is an article gathering other recipes, and it comes back with
headings and recipes, the rows it points at, in place of a recipe's fields.
A recipe carries source_shape, reading structured when the block the page
publishes for search engines held its ingredients and article when they were
read from the body of the page, which is where most of this site's recipes keep
them. Then come title, url, description, published_at, modified_at,
prep_minutes, cook_minutes, total_minutes, categories, cuisines,
keywords, author, author_url, rating, nutrition and images, each
null or empty where the page states nothing. yield says what the recipe was
written for and what it was rescaled to; a page stating no number of servings
comes back with factor at 1 and a note saying why. Each line of ingredients
carries scaling, reading scaled, rounded or unscaled, and is_equipment,
which marks a line naming a tool rather than something eaten.
search_recipes
Searches the recipes for a dish or an ingredient.
In return: rows carrying id, which get_recipe takes, title, url and
image_url. Alongside come result_count for the rows returned and
total_available, which is always null: the site publishes no count of what a
search matched. The site serves its search on a single page and answers a request
for a second with the first again, so these are all the rows it offers for a
query. Some rows are articles gathering recipes, which get_recipe reports as a
collection.
list_facets
Lists the values the site browses its recipes by, read from the sitemap each
taxonomy publishes.
The taxonomies are dieta, edad, ingrediente, ocasion, recetas-de,
tecnica, tipo-de-cocina and tipo-plato: diet, the age of whoever eats it,
main ingredient, occasion, moment of the day, appliance, cuisine and kind of
dish.
In return: facets, each carrying name, value_count and values, whose
value is the slug browse_recipes takes. The values keep the order the site
publishes them in. Reading all eight costs one request per taxonomy. A taxonomy
that could not be read is named in notes and left out of facets, so a
listing short of one never reads like a site that has seven.
browse_recipes
Reads one page of a taxonomy's recipes.
In return: rows of the same shape search_recipes returns, with
page_served for the page the site actually served, has_more for whether its
own pagination offers another, and total_available, always null because the
site prints no count on these pages. The site writes its own slugs, so one built
by hand reaches a page it does not hold and comes back as not_found. The
taxonomies cannot be combined: the site offers no way to ask for two at once.
scale_ingredients
Rescales a list of Spanish ingredient lines. It reaches no site.
Give factor, or from_servings and to_servings together. Naming both ways at
once is refused, because they can ask for different things.
In return: each line with text as it now reads, original as it was given,
amount, amount_max, unit, and scaling, which carries the honesty of the
answer: scaled when the arithmetic landed exactly, rounded when the value
moved to stay something a kitchen can measure out, unscaled when the line
carries no quantity. is_equipment marks a line naming a tool. Alongside come
scaled_count, rounded_count and unscaled_count. Nothing is converted
between unit systems, and an approximate measure such as a pizca keeps the size
the cook gives it.
Configuration
The interval has a floor of 3000 milliseconds. A value below it is refused and
the default stands, which is stated on stderr rather than applied in silence.
Errors
As a library
The reading layer is published on its own, with its pacing, its store and its
error vocabulary, and no protocol attached.
Built with nothing, it takes its settings from the environment and sends its
diagnostics to stderr. loadConfig and createLogger come from the same entry
point for a caller who would rather set them in code:
Every read returns { data, cached }, and cached says whether the answer came
from the store rather than from the site.
Pacing and attribution
One request at a time, three seconds apart, and the interval widens when the site
pushes back. The User-Agent carries the project's name, its version and an
address where a person can be reached.
Pequerecetas is free to read and pays for its own hosting. When you show a recipe
to someone, credit the site and link the page it came from.
This server is not affiliated with Pequerecetas.
Privacy
Nothing is collected. The server reads www.pequerecetas.com and no other host,
keeps what it read in memory for fifteen minutes by default, writes nothing to
disk, and sends its diagnostics to stderr. It carries no credential, because the
site asks for none. See PRIVACY.md.
Development
The corpus the suite reads is written by scripts/build-fixtures.mjs and holds
invented recipes, so no third-party content is stored here. A live suite runs
behind PQR_LIVE=1, one request per route.
Contributing
Issues and pull requests are welcome. See CONTRIBUTING.md.
License
MIT. See LICENSE.
mcp-pequerecetas (français)
English version
Pequerecetas est un site espagnol de cuisine
familiale. Il tient quelques milliers de recettes avec leurs ingrédients, leurs
étapes et leurs photographies, et range chacune sous le régime auquel elle
convient, l'appareil qui la cuit, l'occasion pour laquelle on la fait et l'âge de
celui qui la mange, à partir de six mois.
Ce serveur relie un client de conversation à ce site. On peut chercher ses
recettes, en lire une avec ses quantités mises à l'échelle du nombre de personnes
à table, lister les valeurs que publie chaque taxonomie, parcourir une taxonomie
page par page, et mettre à l'échelle n'importe quelle liste d'ingrédients
espagnole qu'on a déjà. Il ne demande ni clé d'API ni compte.
Installation
Installation en un clic
[Install in Cursor]
[Install in VS Code]
Claude Code
Claude Desktop, Cursor, et tout client au format de configuration standard
Node 24 ou plus récent est requis, et aucune variable d'environnement n'est à
définir.
Avec Docker
-i garde stdin ouvert, où passe le protocole, et -t est laissé de côté parce
qu'un TTY réécrit le flux. Le conteneur a besoin de joindre
www.pequerecetas.com en HTTPS sortant, et de rien d'autre : aucun volume, aucun
port, aucun identifiant.
Bundle, sans npm
Télécharger mcp-pequerecetas-1.2.0.mcpb depuis
la dernière publication
et l'ouvrir. Un client qui gère les bundles MCP l'installe seul, sans npm et sans
fichier de configuration à modifier. Le bundle emporte ses dépendances, donc rien
n'est téléchargé à l'installation.
Ce qu'on peut demander
- « Búscame una receta de paella de marisco. »
- « Lis-moi cette recette pour huit personnes. »
- « Qu'est-ce que je peux cuisiner à la friteuse à air sur ce site ? »
- « Montre-moi les purées qu'il range sous six mois. »
- « Multiplie cette liste d'ingrédients espagnole par trois. »
Pequerecetas est écrit en espagnol et sa recherche compare les mots dont une page
est faite, donc les recettes se trouvent en espagnol. Le chemin ordinaire va
d'une recherche ou d'une taxonomie vers une recette : une ligne porte un id, et
get_recipe prend cet id.
Les outils
get_recipe
Lit une page de la section des recettes, et met ses quantités à l'échelle quand
un nombre de parts est donné.
En retour : kind, qui vaut recipe ou collection. Le site publie les deux
à ce genre d'adresse et les décrit pareillement, donc c'est ce qui les distingue :
une collection est un article qui rassemble d'autres recettes, et elle revient
avec headings et recipes, les lignes qu'elle désigne, à la place des champs
d'une recette.
Une recette porte source_shape, qui vaut structured quand le bloc que la page
publie pour les moteurs de recherche portait ses ingrédients, et article quand
ils ont été lus dans le corps de la page, où la plupart des recettes de ce site
les gardent. Viennent ensuite title, url, description, published_at,
modified_at, prep_minutes, cook_minutes, total_minutes, categories,
cuisines, keywords, author, author_url, rating, nutrition et
images, chacun null ou vide là où la page n'énonce rien. yield dit pour
combien la recette a été écrite et vers combien elle a été portée ; une page qui
n'énonce aucun nombre de parts revient avec factor à 1 et une note qui le dit.
Chaque ligne d'ingredients porte scaling, qui vaut scaled, rounded ou
unscaled, et is_equipment, qui marque une ligne nommant un ustensile plutôt
que quelque chose qui se mange.
search_recipes
Cherche les recettes par plat ou par ingrédient.
En retour : des lignes portant id, que prend get_recipe, title, url et
image_url. À côté viennent result_count pour les lignes rendues et
total_available, toujours null : le site ne publie aucun compte de ce qu'une
recherche a trouvé. Le site sert sa recherche sur une seule page et répond à une
demande de deuxième page par la première à l'identique, donc ce sont là toutes
les lignes qu'il offre pour cette requête. Certaines lignes sont des articles qui
rassemblent des recettes, ce que get_recipe rend comme une collection.
list_facets
Liste les valeurs par lesquelles le site parcourt ses recettes, lues dans le plan
de site que chaque taxonomie publie.
Les taxonomies sont dieta, edad, ingrediente, ocasion, recetas-de,
tecnica, tipo-de-cocina et tipo-plato : le régime, l'âge de celui qui
mange, l'ingrédient principal, l'occasion, le moment de la journée, l'appareil,
la cuisine et le type de plat.
En retour : facets, portant chacune name, value_count et values, dont
value est le slug que prend browse_recipes. Les valeurs gardent l'ordre dans
lequel le site les publie. Lire les huit coûte une requête par taxonomie. Une
taxonomie qui n'a pas pu être lue est nommée dans notes et laissée hors de
facets, pour qu'une liste amputée d'une taxonomie ne se lise pas comme un site
qui en aurait sept.
browse_recipes
Lit une page des recettes d'une taxonomie.
En retour : des lignes de la forme que rend search_recipes, avec
page_served pour la page que le site a servie, has_more pour savoir si sa
pagination en offre une autre, et total_available, toujours null parce que le
site n'imprime aucun compte sur ces pages. Le site écrit ses propres slugs, donc
un slug construit à la main atteint une page qu'il ne tient pas et revient en
not_found. Les taxonomies ne se croisent pas : le site n'offre aucun moyen d'en
demander deux à la fois.
scale_ingredients
Met à l'échelle une liste de lignes d'ingrédients espagnoles. Il ne joint aucun
site.
Donner factor, ou from_servings et to_servings ensemble. Nommer les deux
manières à la fois est refusé, parce qu'elles peuvent demander deux choses
différentes.
En retour : chaque ligne avec text telle qu'elle se lit maintenant,
original telle qu'elle a été donnée, amount, amount_max, unit, et
scaling, qui porte l'honnêteté de la réponse : scaled quand l'arithmétique
est tombée juste, rounded quand la valeur a bougé pour rester une quantité
qu'une cuisine mesure, unscaled quand la ligne ne porte aucune quantité.
is_equipment marque une ligne qui nomme un ustensile. À côté viennent
scaled_count, rounded_count et unscaled_count. Rien n'est converti d'un
système d'unités à un autre, et une mesure approximative comme une pizca garde
la taille que lui donne le cuisinier.
Configuration
L'intervalle a un plancher de 3000 millisecondes. Une valeur en dessous est
refusée et le défaut s'applique, ce qui est dit sur stderr plutôt qu'appliqué en
silence.
Erreurs
Comme bibliothèque
La couche de lecture est publiée seule, avec son rythme, son cache et son
vocabulaire d'erreurs, sans protocole attaché.
Construit sans rien, il prend ses réglages dans l'environnement et envoie ses
diagnostics sur stderr. loadConfig et createLogger viennent du même point
d'entrée pour qui préfère les fixer dans le code :
Toute lecture rend { data, cached }, et cached dit si la réponse vient du
cache plutôt que du site.
Rythme et attribution
Une requête à la fois, trois secondes d'écart, et l'intervalle s'élargit quand le
site demande de la place. Le User-Agent porte le nom du projet, sa version et une
adresse où joindre une personne.
Pequerecetas se lit gratuitement et paie son hébergement. Quand on montre une
recette à quelqu'un, on crédite le site et on lie la page d'où elle vient.
Ce serveur n'est pas affilié à Pequerecetas.
Confidentialité
Rien n'est collecté. Le serveur lit www.pequerecetas.com et aucun autre hôte,
garde ce qu'il a lu en mémoire quinze minutes par défaut, n'écrit rien sur
disque, et envoie ses diagnostics sur stderr. Il ne porte aucun identifiant,
puisque le site n'en demande aucun. Voir PRIVACY.md.
Développement
Le corpus que lit la suite est écrit par scripts/build-fixtures.mjs et tient
des recettes inventées, donc aucun contenu tiers n'est stocké ici. Une suite en
direct tourne derrière PQR_LIVE=1, une requête par route.
Contribuer
Les issues et les pull requests sont bienvenues. Voir
CONTRIBUTING.md.
Licence
MIT. Voir LICENSE.
