recipe.md 9.0 KB
菜谱工具 (Recipe Tools)
菜谱工具是一个综合性的 MCP 美食助手，提供了菜谱查询、分类浏览、智能推荐、搜索等功能，帮助用户解决"今天吃什么"的问题。
常见使用场景
菜谱查询:
- "我想学做宫保鸡丁"
- "红烧肉怎么做"
- "番茄炒蛋的做法"
- "查一下麻婆豆腐的菜谱"
分类浏览:
- "有什么川菜推荐"
- "给我看看家常菜"
- "有哪些素食菜谱"
- "推荐几道汤类菜谱"
智能推荐:
- "今天吃什么好呢"
- "推荐几道适合2个人的晚餐"
- "给我推荐几道早餐"
- "4个人的聚餐菜谱"
搜索功能:
- "有没有用土豆做的菜"
- "搜索含有鸡肉的菜谱"
- "找一些简单易做的菜"
- "有什么辣的菜推荐"
随机推荐:
- "随机推荐一道菜"
- "不知道做什么，随便推荐几个"
- "来个惊喜菜谱"
使用提示
- 明确需求: 可以指定菜系、食材、难度等偏好
- 人数考虑: 可以说明用餐人数，获得更精准的推荐
- 用餐时间: 可以指定早餐、午餐、晚餐等时间
- 食材偏好: 可以提及喜欢或不喜欢的食材
- 难度选择: 可以要求简单易做或挑战性菜谱
AI 助手会根据您的需求自动调用菜谱工具，为您提供详细的烹饪指导。
功能概览
菜谱查询功能
- 详细菜谱: 提供完整的制作步骤和食材清单
- 分类浏览: 按菜系、类型、难度等分类查看
- 智能搜索: 支持模糊搜索和关键词匹配
- 菜谱详情: 包含制作时间、难度、营养信息等
智能推荐功能
- 个性化推荐: 根据用餐人数和时间推荐
- 随机推荐: 解决选择困难症，随机推荐菜品
- 场景推荐: 针对不同用餐场景的菜谱推荐
- 营养搭配: 考虑营养均衡的菜品组合
分类管理功能
- 菜系分类: 川菜、粤菜、湘菜等地方菜系
- 类型分类: 家常菜、素食、汤类等类型
- 难度分类: 简单、中等、困难等难度级别
- 时间分类: 早餐、午餐、晚餐、夜宵等
搜索功能
- 食材搜索: 根据食材查找相关菜谱
- 关键词搜索: 支持菜名、特色等关键词
- 模糊搜索: 智能匹配相似菜谱
- 组合搜索: 多条件组合搜索
工具列表
1. 菜谱查询工具
get_all_recipes - 获取所有菜谱
获取菜谱列表，支持分页浏览。
参数:
page(可选): 页码，默认1page_size(可选): 每页数量，默认10，最大50
使用场景:
- 浏览菜谱列表
- 了解菜谱总览
- 分页查看菜谱
get_recipe_by_id - 获取菜谱详情
根据菜谱ID或名称获取详细信息。
参数:
query(必需): 菜谱名称或ID
使用场景:
- 查看具体菜谱详情
- 获取制作步骤
- 查询食材清单
2. 分类浏览工具
get_recipes_by_category - 按分类获取菜谱
根据分类获取菜谱列表。
参数:
category(必需): 分类名称page(可选): 页码，默认1page_size(可选): 每页数量，默认10，最大50
使用场景:
- 浏览特定菜系
- 查看分类菜谱
- 按类型筛选
3. 智能推荐工具
recommend_meals - 推荐菜品
根据用餐人数和时间推荐合适的菜品。
参数:
people_count(可选): 用餐人数，默认2meal_type(可选): 用餐类型，默认"dinner"page(可选): 页码，默认1page_size(可选): 每页数量，默认10，最大50
使用场景:
- 根据人数推荐菜品
- 按用餐时间推荐
- 个性化菜谱推荐
what_to_eat - 随机推荐菜品
随机推荐菜品，解决选择困难。
参数:
meal_type(可选): 用餐类型，默认"any"page(可选): 页码，默认1page_size(可选): 每页数量，默认10，最大50
使用场景:
- 随机菜品推荐
- 解决选择困难
- 尝试新菜谱
4. 搜索工具
search_recipes_fuzzy - 模糊搜索菜谱
根据关键词模糊搜索菜谱。
参数:
query(必需): 搜索关键词page(可选): 页码，默认1page_size(可选): 每页数量，默认10，最大50
使用场景:
- 关键词搜索
- 食材搜索
- 模糊匹配搜索
使用示例
菜谱查询示例
# 获取菜谱列表
result = await mcp_server.call_tool("get_all_recipes", {
"page": 1,
"page_size": 10
})
# 获取具体菜谱详情
result = await mcp_server.call_tool("get_recipe_by_id", {
"query": "宫保鸡丁"
})
# 按分类获取菜谱
result = await mcp_server.call_tool("get_recipes_by_category", {
"category": "川菜",
"page": 1,
"page_size": 10
})
智能推荐示例
# 根据人数和时间推荐
result = await mcp_server.call_tool("recommend_meals", {
"people_count": 4,
"meal_type": "dinner",
"page": 1,
"page_size": 5
})
# 随机推荐菜品
result = await mcp_server.call_tool("what_to_eat", {
"meal_type": "lunch",
"page": 1,
"page_size": 3
})
搜索功能示例
# 模糊搜索菜谱
result = await mcp_server.call_tool("search_recipes_fuzzy", {
"query": "土豆",
"page": 1,
"page_size": 10
})
# 搜索特定菜系
result = await mcp_server.call_tool("search_recipes_fuzzy", {
"query": "家常菜",
"page": 1,
"page_size": 15
})
数据结构
菜谱信息 (Recipe)
{
"id": "recipe_123",
"name": "宫保鸡丁",
"category": "川菜",
"difficulty": "中等",
"cooking_time": "30分钟",
"serving": "2-3人",
"ingredients": [
{
"name": "鸡胸肉",
"amount": "300g",
"note": "切丁"
},
{
"name": "花生米",
"amount": "50g",
"note": "炸熟"
}
],
"steps": [
{
"step": 1,
"description": "鸡胸肉切丁，用料酒、生抽、淀粉腌制15分钟"
},
{
"step": 2,
"description": "热锅下油，爆炒鸡丁至变色盛起"
}
],
"tips": "炒制时火候要控制好，避免过老",
"nutrition": {
"calories": "280kcal",
"protein": "25g",
"fat": "12g",
"carbs": "15g"
}
}
分页结果 (PagedResult)
{
"data": [
{
"id": "recipe_123",
"name": "宫保鸡丁",
"category": "川菜",
"difficulty": "中等",
"cooking_time": "30分钟"
}
],
"pagination": {
"page": 1,
"page_size": 10,
"total": 156,
"total_pages": 16,
"has_next": true,
"has_prev": false
}
}
推荐信息 (RecommendationInfo)
{
"recommendation_info": {
"people_count": 4,
"meal_type": "dinner",
"message": "为 4 人的dinner推荐菜品"
}
}
支持的分类
菜系分类
- 川菜: 麻辣鲜香的四川菜系
- 粤菜: 清淡鲜美的广东菜系
- 湘菜: 香辣浓郁的湖南菜系
- 鲁菜: 咸鲜为主的山东菜系
- 苏菜: 清淡甜美的江苏菜系
- 浙菜: 清香爽脆的浙江菜系
- 闽菜: 清淡甘甜的福建菜系
- 徽菜: 香鲜适口的安徽菜系
类型分类
- 家常菜: 日常家庭料理
- 素食: 素食菜谱
- 汤类: 各种汤品
- 凉菜: 冷菜开胃菜
- 面食: 面条、饺子等
- 甜品: 甜点糕点
- 下酒菜: 适合配酒的菜品
难度分类
- 简单: 新手友好，步骤简单
- 中等: 需要一定烹饪技巧
- 困难: 需要丰富烹饪经验
时间分类
- 早餐: 早餐菜谱
- 午餐: 午餐菜谱
- 晚餐: 晚餐菜谱
- 夜宵: 夜宵小食
- 下午茶: 茶点小食
最佳实践
1. 菜谱查询
- 使用准确的菜名获得最佳结果
- 可以通过分类浏览发现新菜谱
- 关注菜谱的难度和时间要求
2. 智能推荐
- 准确提供用餐人数获得合适分量
- 根据用餐时间选择合适菜品
- 考虑营养搭配的平衡性
3. 搜索技巧
- 使用食材名称搜索相关菜谱
- 尝试不同的关键词组合
- 利用模糊搜索发现意外惊喜
4. 分页使用
- 合理设置每页数量
- 逐页浏览避免信息过载
- 注意总页数和当前页位置
注意事项
- 食材新鲜: 确保使用新鲜食材
- 过敏提醒: 注意食物过敏问题
- 营养搭配: 考虑营养均衡
- 烹饪安全: 注意厨房安全操作
- 分量调整: 根据实际人数调整用量
故障排除
常见问题
- 搜索无结果: 尝试不同关键词或分类浏览
- 菜谱不详细: 查看菜谱详情页面
- 推荐不合适: 调整推荐参数
- 分页错误: 检查页码和页面大小
调试方法
- 验证搜索关键词拼写
- 检查分类名称是否正确
- 确认页码参数范围
- 查看返回的错误信息
通过菜谱工具，您可以轻松解决"今天吃什么"的问题，发现新的美食，学习烹饪技巧，享受美食带来的快乐。