[Image]
mcp-bbc-goodfood
[npm]
[CI]
[license]
[MCP Registry]
[Glama]
[M8ven]
[Install in Cursor]
[Install in VS Code]
BBC Good Food is a British cooking site, the
online home of the magazine of the same name. Its recipes are written and tested
by its own cooks, and each one gives its ingredients, its method, its
preparation and cooking times, its difficulty, the diets it suits, its nutrition
per serving and the stars its readers gave it. The site narrows its recipes along
axes of its own: a diet, a cuisine, a kind of meal, a difficulty. Part of the
collection sits behind a subscription.
This server connects a chat client to that site. You can read the values each
axis takes, search the recipes along them, read one recipe with its ingredients
rescaled to the number of people at your table, and switch its quantities between
metric and US units. 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.bbcgoodfood.com, and nothing else: no volume, no port, no credential.
Bundle, without npm
Download mcp-bbc-goodfood-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
- "Find me a vegetarian curry that takes under 40 minutes."
- "What diets can I filter on?"
- "Read me that recipe for six, in US cups."
- "Which of these are rated four stars or better?"
- "Scale this ingredient list from a magazine by 1.5."
The ordinary path runs list_filters, then search_recipes, then get_recipe
on the path a row carries.
Tools
Call list_filters before narrowing a search. The site accepts any value on
an axis and answers one it does not know with a total of zero, so a guessed
spelling comes back as a confident absence instead of a refusal.
list_filters
Reads the axes the site narrows by, and the values each one takes.
In return: filters, one entry per axis carrying name and label in the
site's own wording, argument, which names the argument search_recipes takes
for it, and options with each value, its label and its count. A count
the site published nothing for is null. option_count says how many options are
listed here, which is fewer than the site accepts: the values returned are the
most frequent ones, and an option absent from the list is still usable. Counts
are measured inside a scope, so passing query counts within one search and
leaving it out counts across the listing; the two answer different questions.
search_recipes
Searches the recipes, narrowed along the site's own axes and along restrictions
this server applies to the rows it read.
In return: rows carrying id, which get_recipe takes; title; url;
image_url; and rating, which is null where the site published none.
Alongside come result_count, rows_seen for the rows the site served before
anything was set aside, and total_available. A total marked total_is_ceiling
sits on the largest number of rows one search will serve, so it states a floor
rather than a count. restrictions_lifted names what was set aside when
narrowing made the search fail, and premium_dropped counts the subscription
rows removed. The site offers no restriction on subscription rows, so
exclude_premium removes them after the page arrives: a page then comes back
shorter than the limit asked for, and a short page is not the end of the results.
get_recipe
Reads one recipe, rescaled to a number of servings and in the unit system asked
for.
In return: title, url, premium, yield_text in the site's own wording
such as Serves 4 - 6, yield_count, prep_minutes, cook_minutes,
total_minutes, difficulty, diets, author, rating, rating_count,
description, ingredients, steps, nutrition with nutrition_per naming
the serving it describes, and unit_system. A figure the page states nothing for
is null. A recipe behind the site's subscription comes back with premium
true, no ingredients and no steps: send the reader to its page rather than
reconstructing them. Each ingredient carries scaling, reading scaled,
rounded or unscaled.
scale_ingredients
Applies the same arithmetic to any list of ingredient lines, with no request to
the site.
Pass factor, or the from_servings and to_servings pair.
In return: the rescaled lines in the shape get_recipe returns, each with its
original, its text, its amount, amount_max and unit, and its scaling.
Rescaling the quantities
A quantity is stated in the unit that suits it, so a line can come back in a
different unit from the one the recipe used: 200 g multiplied by twenty reads
4 kg, and 2 g divided by ten reads 200 mg.
How finely an ingredient can be divided depends on what it is. A loaf can be cut
in two, in three or in four; an egg cannot be shared out. A quantity landing
between the two is rounded, and the rescaled recipe then departs a little from
the proportions of the original. The line carries rounded, and its note says
what was done.
The figures are this server's arithmetic, so say they were recomputed when you
show them. A recipe whose page states no number of servings cannot be put to a
number of people, and the answer says so.
Configuration
Every variable is optional. Set them in the env block of your client config.
A value outside its range falls back to the default, and the reason is written to
stderr.
Errors
Every failure carries one of six codes, a message, and where it helps a hint
naming the next move.
As a library
The layer reading the site is published on its own, with its pacing, its cache
and its errors, and with no protocol attached.
listFilters, searchRecipes and getRecipe each answer { data, cached },
and throw an error carrying one of the six codes. The floor between two requests
holds here as well.
Pacing and attribution
Requests go out one at a time with at least a second and a half between them, and
the floor of one second holds however the server is configured. The User-Agent
always ends with the project identity and an address where a person can be
reached.
Every result carries the address of the page it was read from, and source names
the site. The recipes belong to BBC Good Food and to the cooks who wrote them.
This MCP server is an unofficial project, with no affiliation to BBC Good Food.
Privacy
This server collects nothing about you and sends nothing to its author. It runs
on your machine, contacts www.bbcgoodfood.com and nothing else, holds its answers in memory
while it runs, and writes nothing to disk.
PRIVACY.md states what a request carries and which settings change
any of it.
Development
Tests run against generated fixtures and make no network request. The live suite,
npm run test:live, makes one request per route and runs nightly against the
site itself.
Contributing
Bugs, questions and ideas belong in
the issue tracker. Pull
requests are welcome; opening an issue first helps agree on the shape of the
change. See CONTRIBUTING.md.
License
MIT, see LICENSE. The recipes belong to BBC Good Food and to their
authors.
mcp-bbc-goodfood (français)
English version
BBC Good Food est un site de cuisine britannique,
la maison en ligne du magazine du même nom. Ses recettes sont écrites et testées
par ses propres cuisiniers, et chacune donne ses ingrédients, sa méthode, ses
temps de préparation et de cuisson, sa difficulté, les régimes auxquels elle
convient, ses valeurs nutritionnelles par portion et les étoiles que ses lecteurs
lui ont données. Le site resserre ses recettes selon des axes qui lui sont
propres : un régime, une cuisine, un type de repas, une difficulté. Une partie de
la collection est réservée aux abonnés.
Ce serveur relie un client de conversation à ce site. On peut lire les valeurs
que prend chaque axe, chercher des recettes le long de ces axes, lire une recette
avec ses ingrédients adaptés au nombre de convives, et basculer ses quantités
entre unités métriques et américaines. Aucune clé d'API, aucun 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 nécessaire, et aucune variable d'environnement n'est à
renseigner.
Avec Docker
-i garde l'entrée standard ouverte, qui est le canal du protocole, et -t est
omis parce qu'un TTY réécrit le flux. Le conteneur a besoin d'un accès HTTPS
sortant vers www.bbcgoodfood.com, et de rien d'autre : aucun volume, aucun
port, aucun identifiant.
Bundle, sans npm
Téléchargez mcp-bbc-goodfood-1.2.0.mcpb depuis
la dernière publication
et ouvrez-le. 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
- « Trouve-moi un curry végétarien qui prend moins de 40 minutes. »
- « Sur quels régimes puis-je filtrer ? »
- « Lis-moi cette recette pour six, en tasses américaines. »
- « Lesquelles sont notées quatre étoiles ou plus ? »
- « Multiplie par 1,5 cette liste d'ingrédients tirée d'un magazine. »
Le chemin ordinaire va de list_filters à search_recipes, puis à get_recipe
sur le chemin que porte une ligne.
Les outils
Appelez list_filters avant de resserrer une recherche. Le site accepte
n'importe quelle valeur sur un axe et répond à celle qu'il ne connaît pas par un
total de zéro, donc une orthographe devinée revient comme une absence assurée au
lieu d'un refus.
list_filters
Lit les axes selon lesquels le site resserre, et les valeurs que chacun prend.
En retour : filters, une entrée par axe portant name et label dans les
termes du site, argument, qui nomme l'argument que search_recipes prend pour
lui, et options avec chaque value, son label et son count. Un count que
le site n'a pas publié vaut null. option_count dit combien d'options sont
listées ici, ce qui est moins que ce que le site accepte : les valeurs rendues
sont les plus fréquentes, et une option absente de la liste reste utilisable. Les
comptes sont mesurés dans une portée, donc passer query compte dans une
recherche et l'omettre compte sur toute la liste ; les deux répondent à des
questions différentes.
search_recipes
Cherche des recettes, resserrées selon les axes du site et selon des
restrictions que ce serveur applique aux lignes qu'il a lues.
En retour : des lignes portant id, que get_recipe reprend ; title ;
url ; image_url ; et rating, null là où le site n'en a publié aucune.
Viennent aussi result_count, rows_seen pour les lignes servies par le site
avant tout écartement, et total_available. Un total marqué total_is_ceiling
se pose sur le plus grand nombre de lignes qu'une recherche servira, donc il
énonce un plancher plutôt qu'un compte. restrictions_lifted nomme ce qui a été
écarté quand le resserrement faisait échouer la recherche, et premium_dropped
compte les lignes d'abonnés retirées. Le site n'offre aucune restriction sur les
lignes d'abonnés, donc exclude_premium les retire une fois la page arrivée :
une page revient alors plus courte que la limite demandée, et une page courte
n'est pas la fin des résultats.
get_recipe
Lit une recette, adaptée à un nombre de parts et dans le système d'unités
demandé.
En retour : title, url, premium, yield_text dans les termes du site
comme Serves 4 - 6, yield_count, prep_minutes, cook_minutes,
total_minutes, difficulty, diets, author, rating, rating_count,
description, ingredients, steps, nutrition avec nutrition_per qui nomme
la portion décrite, et unit_system. Un chiffre que la page n'indique pas vaut
null. Une recette réservée aux abonnés revient avec premium à vrai, sans
ingrédients et sans étapes : renvoyez le lecteur vers sa page au lieu de les
reconstituer. Chaque ingrédient porte scaling, valant scaled, rounded ou
unscaled.
scale_ingredients
Applique la même arithmétique à n'importe quelle liste d'ingrédients, sans
requête au site.
Passez factor, ou le couple from_servings et to_servings.
En retour : les lignes adaptées dans la forme que rend get_recipe, chacune
avec son original, son text, son amount, amount_max et unit, et son
scaling.
L'adaptation des quantités
Une quantité est exprimée dans l'unité qui lui convient. Après adaptation, une
ligne peut donc apparaître dans une autre unité que celle de la recette : 200 g
multipliés par vingt donnent 4 kg, et 2 g divisés par dix donnent 200 mg.
La finesse à laquelle un ingrédient se coupe dépend de sa nature. Un pain se
coupe en deux, en trois ou en quatre ; un oeuf ne se partage pas. Une quantité
qui tombe entre les deux est donc arrondie, et la recette adaptée s'écarte alors
un peu des proportions de l'originale. La ligne porte rounded, et sa note dit
ce qui a été fait.
Les chiffres sont l'arithmétique de ce serveur, donc dites qu'ils ont été
recalculés quand vous les montrez. Une recette dont la page n'indique aucun
nombre de parts ne peut pas être portée à un nombre de convives, et la réponse le
dit.
Configuration
Chaque variable est facultative. Elles se posent dans le bloc env de la
configuration du client.
Une valeur hors de sa plage retombe sur le défaut, et la raison est écrite sur la
sortie d'erreur.
Erreurs
Chaque échec porte un des six codes, un message, et quand cela aide une
indication du geste suivant.
Comme bibliothèque
La couche qui lit le site est publiée seule, avec son rythme, son cache et ses
erreurs, sans protocole attaché.
listFilters, searchRecipes et getRecipe répondent chacun { data, cached },
et lèvent une erreur portant un des six codes. Le plancher entre deux requêtes
tient également ici.
Rythme et attribution
Les requêtes partent une à une avec au moins une seconde et demie entre elles, et
le plancher d'une seconde tient quelle que soit la configuration. Le User-Agent
se termine toujours par l'identité du projet et une adresse où joindre une
personne.
Chaque résultat porte l'adresse de la page d'où il a été lu, et source nomme le
site. Les recettes appartiennent à BBC Good Food et aux cuisiniers qui les ont
écrites.
Ce MCP est un projet non officiel, sans affiliation à BBC Good Food.
Confidentialité
Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur. Il tourne sur
votre machine, ne joint que www.bbcgoodfood.com, garde ses réponses en mémoire le temps qu'il
tourne, et n'écrit rien sur le disque. PRIVACY.md dit ce qu'une
requête emporte et quels réglages changent cela.
Développement
Les tests s'exécutent sur des fixtures engendrées et n'émettent aucune requête.
La suite en direct, npm run test:live, émet une requête par route et tourne
chaque nuit contre le site lui-même.
Contribuer
Les anomalies, les questions et les idées ont leur place dans
le suivi d'incidents. Les
propositions de modification sont bienvenues ; ouvrir un ticket d'abord aide à
s'accorder sur la forme du changement. Voir CONTRIBUTING.md.
Licence
MIT, voir LICENSE. Les recettes appartiennent à BBC Good Food et à
leurs auteurs.
