Food Recipe MCP

Food Recipe MCP

Busca semântica em mais de 50.000+ receitas de comida — criada para agentes de IA e LLMs. Recuperação híbrida em dois estágios (densa + esparsa BM25, fundida via RRF) com reordenação por cross-encoder. Suporta consultas em linguagem natural em norueguês e inglês.

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

---

Conectar

Adicione à configuração do seu cliente MCP:

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

Ou com Claude Code:

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

---

Teste Rápido

Experimente a demonstração ao vivo no seu navegador:
https://recipes.aidatanorge.no/

Nenhuma instalação ou configuração necessária.

---

Ferramentas MCP

search_recipes

Busca semântica em mais de 50.000 receitas do Food.com com recuperação híbrida e reordenação.

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

Exemplos de consulta:

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

Pipeline de busca: Embedding denso (intfloat/e5-large-v2, 1024d) + BM25 esparso, fundidos via Reciprocal Rank Fusion (RRF), reordenados por mmarco-mMiniLMv2-L12-H384-v1.

ping

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

---

Dados

• Fonte: Food.com (~50.000 receitas)
• Cobertura: Ampla variedade de culinárias, tipos de refeição e estilos de cozimento
• Dados nutricionais: calorias, gordura, proteína, carboidratos, sódio, fibras, açúcar por porção
• Avaliações: avaliação do usuário + contagem de avaliações por receita
• Idiomas: inglês e norueguês suportados nativamente em consultas

---

Arquitetura

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 (esparso)
• Reranker: cross-encoder/mmarco-mMiniLMv2-L12-H384-v1
• Vector DB: Qdrant (auto-hospedado)
• Servidor: FastMCP 3.2 via HTTP
• Infraestrutura: Ubuntu Server 24 LTS, Cloudflare Tunnel

---

Licença

MIT