mcp-supertoinette

Lee recetas de Supertoinette desde un cliente MCP: buscarlas, leer una, reescalarla para otro número de personas, navegar por las categorías y consultar los maridajes de vino.

Solo lectura. Sin clave de API, sin cuenta.

Versión en español

Instalación

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

O en la configuración de cualquier cliente MCP:

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

Con Docker:

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

El contenedor solo necesita poder acceder a www.supertoinette.com.

Related MCP server: spoonacular-mcp

Herramientas

Una receta se identifica por el número de su dirección: 4210 en /recette/4210/veloute-de-gaverole.html. search_recipes y browse_recipes devuelven ese número en cada fila.

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 toma una de las etiquetas de facets, escrita tal como se devolvió. Una etiqueta desconocida no encuentra nada, así que el filtro se descarta, la búsqueda se repite sin él y una nota indica qué etiqueta se fue. total_available es siempre null, ya que Supertoinette no publica ningún total; usa last_page. Los contadores de facetas se solapan, por lo que suman más que las filas servidas. Una búsqueda mezcla recetas con las selecciones editoriales del propio sitio; las selecciones se eliminan, por eso result_count puede quedarse corto respecto a limit.

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": []
}

Los tiempos están en minutos, y valen null cuando Supertoinette no publica ningún valor. difficulty tiene una etiqueta y ninguna escala, porque el sitio no publica ninguna escala para ella; cost_level tiene una, porque el sitio la dibuja. ingredient_sheets contiene los enlaces del propio sitio, y aproximadamente uno de cada veinte apunta a un ingrediente distinto del de la línea que lo acompaña.

Pedir servings en una receta cuyo rendimiento no contiene ningún número — «para un gran plato» — devuelve invalid_input. Pedir el id de una página de categoría devuelve parse_failure.

list_categories y browse_recipes

list_categories no toma ningún argumento y devuelve las cuarenta categorías que Supertoinette lista en sus páginas:

{
  "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 es footer para los tipos de plato y menu para las formas de cocinar y las estaciones. Los tags de una receta abren cientos de categorías adicionales que ninguna de las dos listas contiene.

browse_recipes lee una de ellas:

El token es un número y un nombre juntos. Tómalo de list_categories o de los tags de una receta, y pásalo de vuelta sin cambios: cualquier otra forma de escribir el nombre llega a una página que no existe. Cada fila añade difficulty y total_minutes a lo que contiene una fila de búsqueda.

La category de search_recipes y la category de browse_recipes son cosas distintas. La primera es una etiqueta de faceta (Poissons), la segunda es un token (95/recettes-poissons).

Una página más allá de la última vuelve sin filas y sin error; compara page con last_page.

get_wine_pairings

Proporciona id para un plato, o page para el índice alfabético de platos. kind indica cuál de los dos se devolvió, y el otro campo es 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
}

Los cinco rangos son las palabras propias de Supertoinette, en su propio orden.

scale_ingredients

Reescala cualquier lista de ingredientes francesa sin tocar la red.

Cada línea vuelve marcada. scaled es aritmética exacta. rounded se movió a una cantidad que una cocina puede medir, con una note que indica la cifra exacta de la que partió. unscaled no tenía ninguna cantidad que multiplicar. Las unidades se mantienen en el sistema que usó la receta, y una medida aproximada conserva su propio tamaño: cuatro veces una pizca son cuatro pizcas.

get_recipe aplica las mismas reglas cuando se le da servings.

Ajustes

Variables de entorno, todas opcionales. Un valor fuera de su rango se rechaza en stderr y se aplica el valor por defecto.

Una petición a la vez. STO_MIN_INTERVAL_MS aumenta el intervalo entre dos de ellas por encima de su mínimo de 3000 ms, y ningún ajuste lo reduce.

Errores

Cada mensaje empieza con su código entre corchetes.

Como librería

La capa de lectura se distribuye por sí sola, con su ritmo, su caché y su gestión de errores:

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

Las cantidades se devuelven tal como las publicó Supertoinette; el reescalado vive en las herramientas de arriba.

Atribución

Las recetas, los títulos y las fotografías pertenecen a Supertoinette. Acredita al sitio y enlaza la página cuando muestres una receta.

Contribuir

Consulta CONTRIBUTING.md. Licenciado bajo MIT.

mcp-supertoinette (español)

Leer las recetas de Supertoinette desde un cliente MCP: buscarlas, leer una, reescalarla para otro número de personas, recorrer las categorías, consultar los maridajes de vino.

Solo lectura. Sin clave de API, sin cuenta.

Instalación

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

O en la configuración de cualquier cliente MCP:

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

Con Docker:

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

El contenedor solo necesita poder acceder a www.supertoinette.com.

Las herramientas

El token es un número y un nombre juntos. Tómelo de list_categories o de los tags de una receta y páselo sin cambios: cualquier otra forma de escribir el nombre da con una página inexistente. Cada línea añade difficulty y total_minutes a lo que lleva una línea de búsqueda.

El category de search_recipes y el de browse_recipes son dos cosas diferentes. El primero es una etiqueta de faceta (Poissons), el segundo un token (95/recettes-poissons).

Una página más allá de la última se devuelve sin filas y sin error; compare page y last_page.

get_wine_pairings

Proporcione id para un plato, o page para el índice alfabético de los platos. kind indica cuál de las dos respuestas llega, siendo el otro campo null.

Los cinco rangos son los de Supertoinette, en su orden.

scale_ingredients

Reescala una lista de ingredientes francesa sin tocar la red.

Cada línea vuelve marcada. scaled para un cálculo exacto. rounded para un valor reducido a una cantidad medible en cocina, con una note que indica la cifra exacta de la que se ha movido. unscaled para una línea sin cantidad que multiplicar. Las unidades permanecen en el sistema de la receta, y una medida aproximada conserva su tamaño: cuatro veces una pizca son cuatro pizcas.

get_recipe aplica las mismas reglas cuando se le da servings.

Ajustes

Variables de entorno, todas opcionales. Un valor fuera de los límites se rechaza en stderr y se aplica el valor por defecto.

Una solicitud a la vez. STO_MIN_INTERVAL_MS alarga el intervalo entre dos de ellas más allá de su mínimo de 3000 ms, y ningún ajuste lo reduce.

Errores

Cada mensaje comienza con su código entre corchetes.

Como biblioteca

La capa de lectura se publica sola, con su ritmo, su caché y su gestión de errores:

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

Las cantidades se devuelven tal como las publica Supertoinette; el reescalado reside en las herramientas de arriba.

Atribución

Las recetas, los títulos y las fotografías pertenecen a Supertoinette. Acredite el sitio y enlace la página cuando muestre una receta.

Contribuir

Ver CONTRIBUTING.md. Bajo licencia MIT.