项目简介

HowToCook-MCP 服务器是一个基于 Anduin2017/HowToCook 菜谱数据的 MCP (Model Context Protocol) 实现。它使得支持 MCP 协议的 AI 助手(如 Claude 桌面应用、Cursor 等)能够访问丰富的菜谱信息,并利用这些信息为你提供智能膳食规划和推荐服务,解决“今天吃什么”的难题。

主要功能点

  • 查询全部菜谱: 获取 HowToCook 项目中包含的所有菜谱列表。
  • 根据分类查询菜谱: 按照指定的分类(如水产、早餐、荤菜、主食等)筛选并返回菜谱。
  • 智能推荐膳食: 根据用餐人数、忌口食材、过敏原等条件,智能生成一周的膳食计划和购物清单。
  • 不知道吃什么: 根据用餐人数快速推荐一份当天的菜品组合。

安装步骤

  1. 准备 Node.js 环境: 确保你的电脑上安装了 Node.js (版本 16.0.0 或更高) 和 npm 或 yarn。
  2. 克隆项目: 打开终端或命令行工具,运行以下命令获取服务器代码:
    git clone https://github.com/worryzyy/howtocook-mcp.git
    cd howtocook-mcp
  3. 安装依赖: 进入项目目录后,运行以下命令安装所需的库文件:
    npm install
    # 或者使用 yarn install
  4. 编译代码: 运行以下命令编译项目:
    npm run build

服务器配置

MCP 服务器需要与 MCP 客户端配合使用。你需要在你的 AI 助手或客户端中配置该服务器,以便客户端知道如何启动和连接它。配置通常涉及指定服务器名称、启动服务器的命令和参数。

  • 服务器名称: howtocook-mcp
  • 启动命令 (command):
    • 如果你通过 'npm install -g howtocook-mcp' 全局安装了此包,命令通常是 'npx'。
    • 如果你是克隆仓库并在本地运行,命令通常是 'node'。
  • 命令参数 (args):
    • 如果使用全局安装的 'npx' 命令,参数通常是 '-y howtocook-mcp'。
    • 如果使用本地克隆的 'node' 命令,参数是编译后的入口文件路径,例如 '你本地howtocook-mcp项目路径\build\index.js'。

请参考你的 MCP 客户端(如 Cursor)的文档,在设置中添加类似上述信息的 MCP 服务器配置。配置完成后,通常需要重启客户端。

基本使用方法

配置并重启客户端后,你就可以在与 AI 助手的对话中通过自然语言调用 HowToCook-MCP 服务器提供的工具。通常你需要明确告诉 AI 助手使用哪个服务和哪个功能。以下是一些示例:

  • 查询全部菜谱: 对 AI 助手说:“请使用 howtocook 的 MCP 服务查询所有菜谱。”
  • 根据分类查询菜谱: 对 AI 助手说:“请使用 howtocook 的 MCP 服务查询水产类的菜谱。” (你可以替换“水产”为其他分类,如“早餐”、“荤菜”、“主食”等)
  • 智能推荐一周菜谱: 对 AI 助手说:“请使用 howtocook 的 MCP 服务为 3 人推荐一周菜谱,我们家不吃香菜,对虾过敏。” (你可以调整人数、忌口和过敏原)
  • 今天吃什么? 对 AI 助手说:“请使用 howtocook 的 MCP 服务为 4 人晚餐推荐菜单。” (你可以调整人数)

AI 助手会调用对应的服务器工具,并将返回的菜谱或计划信息展示给你。

信息

分类

生产力应用