使用说明
如何查看MCP
一个基于 Anduin2017/HowToBook 的 MCP 服务:供 AI 智能体搜索菜谱并获取菜谱内容。
MCP 服务器配置
{
"mcpServers": {
"howtocook": {
"command": "python",
"args": ["-m", "howtocook_mcp", "--data", "data/recipes.json"]
}
}
}
功能
- 菜谱标题模糊搜索:
search_recipes - 菜谱分类搜索:
search_categories - 全部菜谱列出、分类菜谱列出:
list_recipes - 根据菜谱 ID 获取菜谱内容:
get_recipe
数据准备(打包 HowToCook dishes)
安装依赖
如果你使用 Poetry:
poetry install
或使用 pip:
pip install howtocook-mcp
先准备好 HowToCook 仓库(本地 clone 或下载均可),确保存在 dishes/ 目录。
在本项目根目录执行:
python scripts/package_howtocook_dishes.py --dishes C:\path\to\HowToCook\dishes --output data\recipes.json
也可以直接从 GitHub 下载并打包(需要网络):
python scripts/package_howtocook_dishes.py --download --output data\recipes.json
生成的
data/recipes.json即 MCP 服务的数据源。
运行 MCP 服务
安装后可以直接使用 howtocook_mcp 命令:
howtocook_mcp --data data\recipes.json
也可以:
python main.py --data data\recipes.json
默认数据路径也可通过环境变量配置:
HOWTOCOOK_RECIPES_PATH
MCP工具
about()list_categories()search_categories(query, limit=20)list_recipes(category=None, limit=200, offset=0)search_recipes(query, category=None, limit=20)get_recipe(recipe_id)