mirror of
https://github.com/worryzyy/HowToCook-mcp.git
synced 2026-06-04 21:05:55 +08:00
基于Anduin2017 / HowToCook (程序员在家做饭指南)的mcp server
| src | ||
| .gitignore | ||
| all_recipes.json | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
🍳 HowToCook MCP Server 🥘 -- 炫一周好饭,拒绝拼好饭
让 AI 助手变身私人大厨,为你的一日三餐出谋划策!
基于美味的菜谱 JSON 数据打造的 MCP(Model Context Protocol)服务器,让 AI 助手能够为你推荐菜谱、规划膳食,解决"今天吃什么"的世纪难题!
数据来源:HowToCook ⭐ 没有 star 的同学快去点个星星吧!
🔌 支持的 MCP 客户端
本服务器适用于所有支持 MCP 协议的 AI 助手和客户端,包括但不限于:
- 🤖 Claude 桌面应用
- 📝 Cursor IDE
- 💼 其他支持 MCP 的客户端
✨ 美味功能
该 MCP 服务器提供以下美食工具:
- 📚 查询全部菜谱 - 获取所有可用菜谱数据,做菜百科全书
- 🔍 根据分类查询菜谱 - 按照分类筛选菜谱,想吃水产?早餐?荤菜?主食?一键搞定!
- 🧩 智能推荐膳食 - 根据你的忌口、过敏原和用餐人数,为你规划整整一周的美味佳肴
- 🎲 不知道吃什么 - 选择困难症福音!根据人数直接推荐今日菜单,再也不用纠结了
🚀 快速上手
📋 先决条件
- Node.js 16.0.0+ 🟢
- npm 或 yarn 📦
💻 安装步骤
- 克隆美食仓库
git clone https://github.com/worryzyy/howtocook-mcp.git
cd howtocook-mcp-server
- 安装依赖(就像准备食材一样简单!)
npm install
- 编译代码(烹饪过程...)
npm run build
🍽️ 开始使用
🔥 启动服务器
npm start
🔧 配置 MCP 客户端
Claude 桌面应用配置
-
找到 Claude 桌面应用的配置文件:
- Windows:
%AppData%\Claude\claude_desktop_config.json🪟 - MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json🍎
- Windows:
-
修改配置文件,添加以下内容:
{
"mcpServers": {
"howtocook": {
"command": "npx",
"args": ["-y", "howtocook-mcp-server"]
}
}
}
Cursor IDE 配置
在 Cursor 设置中添加 MCP 服务器配置:
{
"mcpServers": {
"howtocook": {
"command": "npx",
"args": ["-y", "howtocook-mcp-server"]
}
}
}
其他 MCP 客户端
对于其他支持 MCP 协议的客户端,请参考各自的文档进行配置,通常需要指定:
- 服务器名称:
howtocook - 命令:
npx -y howtocook-mcp-server
- 重启客户端,让美食魔法生效 ✨
🧙♂️ 菜单魔法使用指南
以下是在各种 MCP 客户端中使用的示例提示语:
1. 📚 查询全部菜谱
无需参数,直接召唤美食全书!
请使用howtocook的MCP服务查询所有菜谱
2. 🔍 根据分类查询菜谱
请使用howtocook的MCP服务查询水产类的菜谱
参数:
category: 菜谱分类(水产、早餐、荤菜、主食等)
3. 🧩 智能推荐一周菜谱
请使用howtocook的MCP服务为3人推荐一周菜谱,我们家不吃香菜,对虾过敏
参数:
allergies: 过敏原列表,如 ["大蒜", "虾"]avoidItems: 忌口食材,如 ["葱", "姜"]peopleCount: 用餐人数 (1-10)
4. 🎲 今天吃什么?
请使用howtocook的MCP服务为4人晚餐推荐菜单
参数:
peopleCount: 用餐人数 (1-10)
📝 小贴士
- 该包已发布至 npm,可直接通过
npm install -g howtocook-mcp-server全局安装 - 本服务兼容所有支持 MCP 协议的 AI 助手和应用
- 首次使用时,AI 可能需要一点时间来熟悉如何使用这些工具(就像烧热锅一样)
- 确保
all_recipes.json文件可被程序正确访问
🤝 贡献
欢迎 Fork 和 Pull Request,让我们一起完善这个美食助手!
📄 许可
MIT License - 随意使用,就像分享美食配方一样慷慨!
🍴 美食即将开始,胃口准备好了吗?