项目简介
HowToCook-MCP 服务器是一个基于 Anduin2017/HowToCook 菜谱数据的 MCP (Model Context Protocol) 实现。它使得支持 MCP 协议的 AI 助手(如 Claude 桌面应用、Cursor 等)能够访问丰富的菜谱信息,并利用这些信息为你提供智能膳食规划和推荐服务,解决“今天吃什么”的难题。
主要功能点
- 查询全部菜谱: 获取 HowToCook 项目中包含的所有菜谱列表。
- 根据分类查询菜谱: 按照指定的分类(如水产、早餐、荤菜、主食等)筛选并返回菜谱。
- 智能推荐膳食: 根据用餐人数、忌口食材、过敏原等条件,智能生成一周的膳食计划和购物清单。
- 不知道吃什么: 根据用餐人数快速推荐一份当天的菜品组合。
安装步骤
- 准备 Node.js 环境: 确保你的电脑上安装了 Node.js (版本 16.0.0 或更高) 和 npm 或 yarn。
- 克隆项目: 打开终端或命令行工具,运行以下命令获取服务器代码:
git clone https://github.com/worryzyy/howtocook-mcp.git cd howtocook-mcp - 安装依赖: 进入项目目录后,运行以下命令安装所需的库文件:
npm install # 或者使用 yarn install - 编译代码: 运行以下命令编译项目:
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 助手会调用对应的服务器工具,并将返回的菜谱或计划信息展示给你。
信息
分类
生产力应用