mcp-supertoinette

Lies Rezepte von Supertoinette in einem MCP-Client: suche sie, lies eines, skaliere es für eine andere Personenzahl neu, durchstöbere die Kategorien und schlage Weinbegleitungen nach.

Nur lesend. Kein API-Schlüssel, kein Konto.

Französische Version

Installation

claude mcp add supertoinette -- npx -y mcp-supertoinette

Oder in der Konfiguration eines beliebigen MCP-Clients:

{
  "mcpServers": {
    "supertoinette": {
      "command": "npx",
      "args": ["-y", "mcp-supertoinette"]
    }
  }
}

Mit Docker:

docker build -t mcp-supertoinette .
docker run -i --rm mcp-supertoinette

Der Container muss lediglich www.supertoinette.com erreichen können.

Related MCP server: spoonacular-mcp

Werkzeuge

Ein Rezept wird durch die Nummer in seiner Adresse identifiziert: 4210 in /recette/4210/veloute-de-gaverole.html. search_recipes und browse_recipes geben diese Nummer in jeder Zeile zurück.

search_recipes

{
  "query": "cabillaud",
  "page": 1,
  "last_page": 2,
  "results": [
    {
      "id": "702",
      "title": "Cabillaud aux champignons",
      "url": "https://www.supertoinette.com/recette/702/cabillaud-aux-champignons.html",
      "image_url": "https://recette.supertoinette.com/new/…-800.webp",
      "categories": ["Sauces", "Poissons"]
    }
  ],
  "result_count": 20,
  "rows_published": 39,
  "total_available": null,
  "facets": [{ "label": "Poissons", "count": 60 }]
}

category nimmt eines der facets-Labels, genau wie es zurückgegeben wurde. Ein unbekanntes Label findet nichts; der Filter wird daher verworfen, die Suche ohne ihn erneut ausgeführt, und eine Notiz sagt, welches Label entfernt wurde. total_available ist immer null, da Supertoinette keine Gesamtzahl veröffentlicht; verwenden Sie last_page. Die Facettenzähler überlappen sich, sodass ihre Summe größer ist als die Anzahl der gelieferten Zeilen. Eine Suche mischt Rezepte mit den redaktionellen Auswahlen der Website; diese Auswahlen werden entfernt, weshalb result_count unter limit liegen kann.

get_recipe

{
  "id": "4210",
  "title": "Velouté de gaverole au pravin",
  "url": "https://www.supertoinette.com/recette/4210/veloute-de-gaverole.html",
  "yield": { "original_text": "6 personnes", "requested": 4, "factor": 0.6667 },
  "ingredients": [
    {
      "text": "533 g de tiges de gaverole",
      "original": "800 g de tiges de gaverole",
      "scaling": "scaled",
      "amount": 533,
      "unit": "g",
      "is_heading": false
    }
  ],
  "steps": ["Émincer les tiges de gaverole."],
  "prep_minutes": 15,
  "cook_minutes": 25,
  "rest_minutes": 30,
  "total_minutes": 70,
  "difficulty": { "label": "Recette facile" },
  "cost_level": { "label": "Economique", "level": 1, "scale": 3 },
  "rating": { "value": 4.2, "count": 9, "scale": 5 },
  "tags": [{ "label": "Soupes & potages", "category": "91/recettes-soupes-potages" }],
  "faq": []
}

Zeiten sind in Minuten und null, wenn Supertoinette keinen Wert veröffentlicht. difficulty hat ein Label, aber keine Skala, weil die Website keine Skala dafür veröffentlicht; cost_level hat eine, weil die Website sie darstellt. ingredient_sheets enthält die eigenen Links der Website, und etwa einer von zwanzig verweist auf eine andere Zutat als die Zeile daneben.

Wird servings für ein Rezept angefordert, dessen Mengenangabe keine Zahl enthält – „pour un grand plat“ –, wird invalid_input zurückgegeben. Wird die id einer Kategorieseite angefordert, wird parse_failure zurückgegeben.

list_categories und browse_recipes

list_categories nimmt kein Argument entgegen und gibt die vierzig Kategorien zurück, die Supertoinette auf seinen Seiten auflistet:

{
  "categories": [
    {
      "label": "Soupes & potages",
      "category": "91/recettes-soupes-potages",
      "url": "https://www.supertoinette.com/recettes/91/recettes-soupes-potages",
      "listed_in": "footer"
    }
  ],
  "category_count": 40
}

listed_in ist footer für die Gerichtarten und menu für die Zubereitungsarten und Jahreszeiten. Die tags eines Rezepts führen zu Hunderten weiterer Kategorien, die in keiner der beiden Listen enthalten sind.

browse_recipes liest eine davon:

Das Token ist eine Nummer und ein Name zusammen. Nehmen Sie es aus list_categories oder aus den tags eines Rezepts und geben Sie es unverändert zurück: Jede andere Schreibweise des Namens führt zu einer Seite, die nicht existiert. Jede Zeile ergänzt difficulty und total_minutes zu dem, was eine Suchzeile enthält.

Die category von search_recipes und die category von browse_recipes sind verschiedene Dinge. Die erste ist ein Facetten-Label (Poissons), die zweite ein Token (95/recettes-poissons).

Eine Seite nach der letzten wird ohne Zeilen und ohne Fehler zurückgegeben; vergleichen Sie page mit last_page.

get_wine_pairings

Geben Sie id für ein einzelnes Gericht an oder page für den alphabetischen Index der Gerichte. kind gibt an, welches der beiden zurückgegeben wurde; das andere Feld ist null.

{
  "kind": "dish",
  "dish": {
    "dish": "Aligot",
    "style": "Un vin blanc sec assez puissant, fin et très légèrement boisé",
    "pairings": [
      { "rank": "Bon accord", "wine": "Premières côtes de bordeaux" },
      { "rank": "Accord parfait", "wine": "Mâcon blanc" }
    ],
    "recipes": [{ "id": "1081", "title": "Aligot" }]
  },
  "index": null
}

Die fünf Ränge sind Supertoinettes eigene Formulierungen in eigener Reihenfolge.

scale_ingredients

Skaliert jede französische Zutatenliste neu, ohne das Netzwerk zu berühren.

Jede Zeile wird markiert zurückgegeben. scaled ist exakte Arithmetik. rounded wurde auf eine Menge verschoben, die eine Küche abmessen kann, mit einer note, die den genauen Ausgangswert angibt. unscaled hatte keine zu multiplizierende Menge. Einheiten bleiben im System des Rezepts, und ein ungefähres Maß behält seine eigene Größe: viermal eine Prise ist vier Prisen.

get_recipe wendet dieselben Regeln an, wenn servings angegeben wird.

Einstellungen

Umgebungsvariablen, alle optional. Ein Wert außerhalb seines Bereichs wird auf stderr abgelehnt und der Standardwert angewendet.

Eine Anfrage nach der anderen. STO_MIN_INTERVAL_MS erhöht den Abstand zwischen zwei Anfragen über seine Untergrenze von 3000 ms, und keine Einstellung senkt ihn.

Fehler

Jede Meldung beginnt mit ihrem Code in Klammern.

Als Bibliothek

Die Leseschicht wird eigenständig ausgeliefert, mit ihrem Takt, ihrem Cache und ihrer Fehlerbehandlung:

import { SupertoinetteClient } from "mcp-supertoinette/client";

Mengen werden so zurückgegeben, wie Supertoinette sie veröffentlicht hat; die Neuskalierung lebt in den Werkzeugen darüber.

Namensnennung

Rezepte, Titel und Fotografien gehören Supertoinette. Nennen Sie die Website und verlinken Sie die Seite, wenn Sie ein Rezept zeigen.

Mitwirken

Siehe CONTRIBUTING.md. Lizenziert unter MIT.

mcp-supertoinette (français)

Lies die Rezepte von Supertoinette aus einem MCP-Client: suche sie, lies eines, skaliere es für eine andere Personenzahl neu, durchstöbere die Kategorien und schlage Weinbegleitungen nach.

Nur lesend. Ohne API-Schlüssel, ohne Konto.

Installation

claude mcp add supertoinette -- npx -y mcp-supertoinette

Oder in der Konfiguration eines beliebigen MCP-Clients:

{
  "mcpServers": {
    "supertoinette": {
      "command": "npx",
      "args": ["-y", "mcp-supertoinette"]
    }
  }
}

Mit Docker:

docker build -t mcp-supertoinette .
docker run -i --rm mcp-supertoinette

Der Container muss lediglich www.supertoinette.com erreichen können.

Die Werkzeuge

Ein Rezept wird durch die Nummer seiner Adresse identifiziert: 4210 in /recette/4210/veloute-de-gaverole.html. search_recipes und browse_recipes geben diese Nummer in jeder Zeile zurück.

search_recipes

category nimmt eines der in facets zurückgegebenen Labels, genau wie es geschrieben wurde. Ein unbekanntes Label findet nichts; der Filter wird dann verworfen, die Suche ohne ihn erneut ausgeführt, und eine Notiz sagt, welches entfernt wurde. total_available ist immer null, da Supertoinette keine Gesamtzahl veröffentlicht; verwenden Sie last_page. Die Facettenzähler überschneiden sich, und ihre Summe übersteigt die Anzahl der Zeilen. Eine Suche mischt Rezepte mit den redaktionellen Auswahlen der Website; diese werden entfernt, was ein result_count erklärt, das unter dem angeforderten limit liegt.

get_recipe

Die Zeiten sind in Minuten und null, wenn Supertoinette keine veröffentlicht. difficulty trägt ein Label ohne Skala, da die Website keine veröffentlicht; cost_level trägt eine, da die Website sie darstellt. ingredient_sheets enthält die Links der Website selbst, von denen etwa einer von zwanzig auf eine andere Zutat zeigt als die der Zeile.

Wird servings für ein Rezept angefordert, dessen Mengenangabe keine Zahl enthält – „pour un grand plat“ –, wird invalid_input zurückgegeben. Wird die id einer Kategorieseite angefordert, wird parse_failure zurückgegeben.

list_categories und browse_recipes

list_categories nimmt kein Argument entgegen und gibt die vierzig Kategorien zurück, die Supertoinette auf seinen Seiten auflistet. listed_in ist footer für die Gerichtarten und menu für die Zubereitungsarten und Jahreszeiten. Die tags eines Rezepts führen zu Hunderten weiterer Kategorien, die keine der beiden Listen enthält.

browse_recipes liest eine davon:

Das Token ist eine Nummer und ein Name zusammen. Nehmen Sie es aus list_categories oder aus den tags eines Rezepts und übergeben Sie es unverändert weiter: Jede andere Schreibweise des Namens erreicht eine nicht existierende Seite. Jede Zeile fügt difficulty und total_minutes zu dem hinzu, was eine Suchzeile enthält.

Das category von search_recipes und das von browse_recipes sind zwei verschiedene Dinge. Ersteres ist eine Facettenbezeichnung (Poissons), Letzteres ein Token (95/recettes-poissons).

Eine Seite jenseits der letzten wird ohne Zeile und ohne Fehler zurückgegeben; vergleichen Sie page und last_page.

get_wine_pairings

Geben Sie id für ein Gericht an, oder page für den alphabetischen Index der Gerichte. kind gibt an, welche der beiden Antworten kommt, das andere Feld ist null.

Die fünf Ränge sind die von Supertoinette, in seiner Reihenfolge.

scale_ingredients

Skaliert eine französische Zutatenliste neu, ohne das Netzwerk zu berühren.

Jede Zeile wird markiert zurückgegeben. scaled für eine exakte Berechnung. rounded für einen Wert, der auf eine in der Küche messbare Menge gebracht wurde, mit einer note, die die genaue Zahl angibt, um die er sich bewegt hat. unscaled für eine Zeile ohne zu multiplizierende Menge. Die Einheiten bleiben im System des Rezepts, und ein ungefähres Maß behält seine Größe: viermal eine Prise ergibt vier Prisen.

get_recipe wendet dieselben Regeln an, wenn ihm servings übergeben wird.

Einstellungen

Umgebungsvariablen, alle optional. Ein Wert außerhalb der Grenzen wird auf stderr abgelehnt und der Standardwert wird angewendet.

Eine Anfrage nach der anderen. STO_MIN_INTERVAL_MS verlängert den Abstand zwischen zwei von ihnen über sein Minimum von 3000 ms hinaus, und keine Einstellung senkt ihn.

Fehler

Jede Meldung beginnt mit ihrem Code in eckigen Klammern.

Als Bibliothek

Die Leseschicht wird separat veröffentlicht, mit ihrem Takt, ihrem Cache und ihrer Fehlerbehandlung:

import { SupertoinetteClient } from "mcp-supertoinette/client";

Die Mengen werden so zurückgegeben, wie Supertoinette sie veröffentlicht; die Neuskalierung lebt in den oben genannten Werkzeugen.

Namensnennung

Die Rezepte, die Titel und die Fotografien gehören Supertoinette. Nennen Sie die Website als Quelle und verlinken Sie die Seite, wenn Sie ein Rezept zeigen.

Mitwirken

Siehe CONTRIBUTING.md. Unter der Lizenz MIT.