food-recipe-mcp

Food Recipe MCP

针对 50,000 多道美食食谱的语义搜索——专为 AI Agent 和大模型打造。采用两阶段混合检索（稠密 + 稀疏 BM25，通过 RRF 融合），并使用交叉编码器重排。支持挪威语和英语自然语言查询。

在线端点： https://recipes.aidatanorge.no/mcp
传输方式： streamable-http
演示： https://recipes.aidatanorge.no/

---

连接

添加到你的 MCP 客户端配置中：

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

或使用 Claude Code：

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

---

快速测试

在浏览器中试用在线演示：
https://recipes.aidatanorge.no/

无需安装或配置。

---

MCP 工具

search_recipes

对 Food.com 上 50,000 多道食谱进行语义搜索，并采用混合检索和重排。

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

查询示例：

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

搜索流程： 稠密嵌入（intfloat/e5-large-v2，1024d）+ 稀疏 BM25，通过倒数排名融合（RRF）进行融合，再由 mmarco-mMiniLMv2-L12-H384-v1 重排。

ping

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

---

数据

• 来源： Food.com（约 50,000 道食谱）
• 覆盖范围： 丰富的菜系、餐食类型和烹饪风格
• 营养数据： 每份的卡路里、脂肪、蛋白质、碳水化合物、钠、膳食纤维和糖含量
• 评分： 每道食谱的用户评分和评分数量
• 语言： 查询原生支持英语和挪威语

---

架构

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

---

技术栈

• 嵌入模型： intfloat/e5-large-v2（1024d 稠密）+ Qdrant/bm25（稀疏）
• 重排器： cross-encoder/mmarco-mMiniLMv2-L12-H384-v1
• 向量数据库： Qdrant（可自托管）
• 服务： 基于 HTTP 的 FastMCP 3.2
• 基础设施： Ubuntu Server 24 LTS、Cloudflare Tunnel

---

许可证

MIT