Food Recipe MCP

Búsqueda semántica en más de 50,000 recetas de Food.com, filtra por dieta, tiempo de cocción y dificultad.

Documentación

Food Recipe MCP

Búsqueda semántica en más de 50,000 recetas de comida, diseñada para agentes de IA y LLMs. Recuperación híbrida de dos etapas (densa + dispersa BM25, fusionada mediante RRF) con reranking de cross-encoder. Admite consultas en lenguaje natural en noruego e inglés.

Endpoint en vivo: https://recipes.aidatanorge.no/mcp
Transporte: streamable-http
Demo: https://recipes.aidatanorge.no/


Conectar

Agrégalo a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "food-recipe": {
      "type": "streamable-http",
      "url": "https://recipes.aidatanorge.no/mcp"
    }
  }
}

O con Claude Code:

claude mcp add --transport http food-recipe https://recipes.aidatanorge.no/mcp

Prueba rápida

Prueba la demo en vivo en tu navegador:
https://recipes.aidatanorge.no/

No se necesita instalación ni configuración.


Herramientas MCP

search_recipes

Búsqueda semántica en más de 50,000 recetas de Food.com con recuperación híbrida y reranking.

search_recipes(
    query="quick Italian pasta for weeknight dinner",
    diet="vegetarian",      # vegetarian | vegan | gluten-free | dairy-free | low-carb | keto | paleo
    max_minutes=30,         # maximum total cooking time in minutes
    difficulty="easy",      # easy | medium | hard
    limit=5                 # default 5, max 20
)
# Returns: rerank_score, rrf_score, title, description, total_time, difficulty,
#          diet, main_ingredient, servings, ingredients, instructions, nutrition,
#          rating, rating_count, source, recipe_id

Ejemplos de consultas:

  • "Swedish meatballs with gravy"
  • "healthy high-protein chicken bowl"
  • "easy chocolate cake for beginners"
  • "traditional Norwegian kjøttkaker"
  • "hurtig pasta med kylling"

Pipeline de búsqueda: Embedding denso (intfloat/e5-large-v2, 1024d) + BM25 disperso, fusionado mediante Fusión de Rango Recíproco (RRF), reordenado por mmarco-mMiniLMv2-L12-H384-v1.

ping

ping(name="world")
# Returns: "Hello world! Recipe MCP server is running."

Datos

  • Fuente: Food.com (~50,000 recetas)
  • Cobertura: Amplia variedad de cocinas, tipos de comida y estilos de cocina
  • Datos nutricionales: calorías, grasas, proteínas, carbohidratos, sodio, fibra y azúcar por porción
  • Calificaciones: calificación de usuarios + número de calificaciones por receta
  • Idiomas: inglés y noruego compatibles de forma nativa en las consultas

Arquitectura

Food.com recipes → Python ingest → Qdrant (recipe_data_v2 collection)
                                         ↓
                              Hybrid search (dense e5-large-v2 + sparse BM25)
                                         ↓
                              RRF fusion + cross-encoder reranking
                                         ↓
                              FastMCP 3.2 → MCP clients / AI agents

Stack técnico

  • Embeddings: intfloat/e5-large-v2 (1024d denso) + Qdrant/bm25 (disperso)
  • Reranker: cross-encoder/mmarco-mMiniLMv2-L12-H384-v1
  • Base de datos vectorial: Qdrant (autoalojado)
  • Servidor: FastMCP 3.2 sobre HTTP
  • Infraestructura: Ubuntu Server 24 LTS, Cloudflare Tunnel

Licencia

MIT