mcp-supertoinette

MCP 클라이언트에서 Supertoinette의 레시피를 읽으세요: 검색하고, 하나를 읽고, 다른 인원 수에 맞게 조정하고, 카테고리를 탐색하고, 와인 페어링을 확인하세요.

읽기 전용입니다. API 키도, 계정도 필요 없습니다.

Version française

설치

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

또는 MCP 클라이언트 설정에서:

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

Docker 사용 시:

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

컨테이너는 www.supertoinette.com에만 접근하면 됩니다.

Related MCP server: spoonacular-mcp

도구

레시피는 주소의 숫자로 식별됩니다: /recette/4210/veloute-de-gaverole.html의 4210. search_recipes와 browse_recipes는 모든 행에서 그 숫자를 반환합니다.

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는 facets 라벨 중 하나를 반환된 그대로 받습니다. 알 수 없는 라벨은 아무것도 찾지 못하므로 필터가 제거되고, 필터 없이 검색이 다시 실행되며, 어떤 라벨이 제거되었는지 메모가 표시됩니다. total_available은 Supertoinette가 총계를 게시하지 않으므로 항상 null입니다. last_page를 사용하세요. 패싯 수는 겹치므로 제공된 행 수보다 합계가 더 큽니다. 검색은 레시피와 사이트 자체의 편집 선택을 혼합합니다. 선택 항목은 제거되므로 result_count가 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": []
}

시간은 분 단위이며, Supertoinette가 값을 게시하지 않는 경우 null입니다. difficulty는 라벨만 있고 척도는 없습니다. 사이트가 척도를 게시하지 않기 때문입니다. cost_level은 사이트가 그리기 때문에 척도가 있습니다. ingredient_sheets는 사이트 자체 링크를 담고 있으며, 약 20개 중 1개는 옆 줄의 재료와 다른 재료를 가리킵니다.

수량에 숫자가 없는 레시피("pour un grand plat")에 servings를 요청하면 invalid_input이 반환됩니다. 카테고리 페이지의 id를 요청하면 parse_failure가 반환됩니다.

list_categories 및 browse_recipes

list_categories는 인수를 받지 않으며 Supertoinette가 페이지에 나열하는 40개 카테고리를 반환합니다:

{
  "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은 요리 종류에는 footer, 조리 방법과 계절에는 menu입니다. 레시피의 tags는 두 목록 모두에 없는 수백 개의 추가 카테고리로 이어집니다.

browse_recipes는 그중 하나를 읽습니다:

토큰은 숫자와 이름이 함께 있는 것입니다. list_categories 또는 레시피의 tags에서 가져와 변경 없이 그대로 전달하세요. 이름의 다른 철자는 존재하지 않는 페이지에 도달합니다. 각 행은 검색 행이 담는 것에 difficulty와 total_minutes를 추가합니다.

search_recipes의 category와 browse_recipes의 category는 서로 다른 것입니다. 전자는 패싯 라벨(Poissons)이고, 후자는 토큰(95/recettes-poissons)입니다.

마지막 페이지를 넘어가는 페이지는 행도 오류도 없이 반환됩니다. page를 last_page와 비교하세요.

get_wine_pairings

하나의 요리에는 id를, 요리의 알파벳순 색인에는 page를 주세요. kind는 둘 중 무엇이 반환되었는지 알려주며, 다른 필드는 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
}

다섯 등급은 Supertoinette 자체 표현을 자체 순서로 나열한 것입니다.

scale_ingredients

네트워크에 접촉하지 않고 프랑스어 재료 목록의 크기를 조정합니다.

모든 줄은 표시되어 반환됩니다. scaled는 정확한 산술입니다. rounded는 주방에서 측정할 수 있는 양으로 이동했으며, note는 이동 전의 정확한 수치를 제공합니다. unscaled는 곱할 수량이 없었습니다. 단위는 레시피가 사용한 체계를 유지하며, 근사 측정은 자체 크기를 유지합니다. 한 꼬집(pincée)의 네 배는 네 꼬집입니다.

get_recipe는 servings가 주어지면 동일한 규칙을 적용합니다.

설정

환경 변수, 모두 선택 사항입니다. 범위를 벗어난 값은 stderr에 거부되고 기본값이 적용됩니다.

한 번에 하나의 요청만 처리합니다. STO_MIN_INTERVAL_MS는 두 요청 사이의 간격을 3000ms 하한선 이상으로 높이며, 어떤 설정도 이를 낮출 수 없습니다.

오류

각 메시지는 대괄호 안의 코드로 시작합니다.

라이브러리로 사용

읽기 계층은 자체 페이싱, 캐시 및 오류 처리를 갖춘 독립형으로 제공됩니다:

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

수량은 Supertoinette가 게시한 그대로 반환됩니다. 크기 조정은 위의 도구에 있습니다.

출처 표시

레시피, 제목 및 사진은 Supertoinette에 속합니다. 레시피를 표시할 때 사이트를 표시하고 페이지를 링크하세요.

기여

CONTRIBUTING.md를 참조하세요. MIT 라이선스입니다.

mcp-supertoinette (français)

MCP 클라이언트에서 Supertoinette의 레시피를 읽으세요: 검색하고, 하나를 읽고, 다른 인원 수에 맞게 조정하고, 카테고리를 탐색하고, 음식과 와인의 궁합을 확인하세요.

읽기 전용입니다. API 키도, 계정도 필요 없습니다.

설치

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

또는 MCP 클라이언트 설정에서:

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

Docker 사용 시:

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

컨테이너는 www.supertoinette.com에만 접근하면 됩니다.

도구

레시피는 주소의 숫자로 식별됩니다: /recette/4210/veloute-de-gaverole.html의 4210. search_recipes와 browse_recipes는 모든 행에서 그 숫자를 반환합니다.

search_recipes

category는 facets에서 반환된 라벨 중 하나를 그대로 받습니다. 알 수 없는 라벨은 아무것도 찾지 못합니다. 필터가 제거되고, 필터 없이 검색이 다시 실행되며, 어떤 라벨이 제거되었는지 메모가 표시됩니다. total_available은 Supertoinette가 총계를 게시하지 않으므로 항상 null입니다. last_page를 사용하세요. 패싯 수는 겹치므로 합계가 행 수를 초과합니다. 검색은 레시피와 사이트의 편집 선택을 혼합합니다. 선택 항목은 제거되므로 result_count가 요청한 limit보다 작을 수 있습니다.

get_recipe

시간은 분 단위이며, Supertoinette가 값을 게시하지 않는 경우 null입니다. difficulty는 라벨만 있고 척도는 없습니다. 사이트가 척도를 게시하지 않기 때문입니다. cost_level은 사이트가 그리기 때문에 척도가 있습니다. ingredient_sheets는 사이트 자체 링크를 담고 있으며, 약 20개 중 1개는 옆 줄의 재료와 다른 재료를 가리킵니다.

수량에 숫자가 없는 레시피("pour un grand plat")에 servings를 요청하면 invalid_input이 반환됩니다. 카테고리 페이지의 id를 요청하면 parse_failure가 반환됩니다.

list_categories 및 browse_recipes

list_categories는 인수를 받지 않으며 Supertoinette가 페이지에 나열하는 40개 카테고리를 반환합니다. listed_in은 요리 종류에는 footer, 조리 방법과 계절에는 menu입니다. 레시피의 tags는 두 목록 모두에 없는 수백 개의 추가 카테고리로 이어집니다.

browse_recipes는 그중 하나를 읽습니다:

토큰은 번호와 이름이 함께 있는 것입니다. list_categories 또는 레시피의 tags에서 가져와 변경하지 않고 그대로 전달하세요. 이름을 다르게 쓰면 존재하지 않는 페이지에 도달합니다. 각 행은 검색 행이 담고 있는 것에 difficulty와 total_minutes를 추가합니다.

search_recipes의 category와 browse_recipes의 category는 서로 다른 것입니다. 전자는 패싯 라벨(Poissons)이고, 후자는 토큰(95/recettes-poissons)입니다.

마지막 페이지를 넘어선 페이지는 행도 오류도 없이 반환됩니다. page와 last_page를 비교하세요.

get_wine_pairings

요리의 경우 id를, 요리의 알파벳순 색인의 경우 page를 제공하세요. kind는 두 응답 중 어느 것이 오는지 나타내며, 다른 필드는 null입니다.

다섯 등급은 Supertoinette의 순서를 따릅니다.

scale_ingredients

네트워크에 접촉하지 않고 프랑스어 재료 목록의 크기를 조정합니다.

각 줄은 표시되어 반환됩니다. scaled는 정확한 계산입니다. rounded는 주방에서 측정 가능한 양으로 반올림된 값이며, note는 이동한 정확한 수치를 제공합니다. unscaled는 곱할 수량이 없는 줄입니다. 단위는 레시피의 체계를 유지하며, 근사 측정은 그 크기를 유지합니다. 한 꼬집의 네 배는 네 꼬집입니다.

get_recipe는 servings가 주어지면 동일한 규칙을 적용합니다.

설정

환경 변수, 모두 선택 사항입니다. 범위를 벗어난 값은 stderr에 거부되고 기본값이 적용됩니다.

한 번에 하나의 요청입니다. STO_MIN_INTERVAL_MS는 두 요청 사이의 간격을 3000ms의 최소값 이상으로 늘리며, 어떤 설정도 이 값을 낮출 수 없습니다.

오류

각 메시지는 대괄호 안의 코드로 시작합니다.

라이브러리로 사용

읽기 계층은 자체 속도, 캐시, 오류 처리를 포함하여 단독으로 게시됩니다:

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

수량은 Supertoinette가 게시한 그대로 반환됩니다. 크기 조정은 위의 도구에 있습니다.

출처 표시

레시피, 제목, 사진은 Supertoinette의 소유입니다. 레시피를 보여줄 때는 사이트를 출처로 표시하고 페이지에 링크하세요.

기여

CONTRIBUTING.md를 참조하세요. MIT 라이선스입니다.