菜谱搜索服务

一个供AI智能体搜索菜谱并获取菜谱内容的MCP服务。

  • by RicterZ
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 RicterZ/HowToCook-MCP

使用说明

如何查看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)