HowToCook-mcp

MCP.Pizza Chef: worryzyy

HowToCook-mcp is an MCP server based on Anduin2017/HowToCook that enables AI assistants to recommend recipes, plan meals, and solve daily meal decision problems. It supports querying all recipes, filtering by category, intelligent weekly meal planning based on dietary restrictions, and daily menu suggestions. Compatible with all MCP clients, it transforms AI into a personal chef for home cooking guidance.

Use This MCP server To

Query all available recipes for cooking reference Filter recipes by category like seafood, breakfast, or main dishes Plan weekly meals based on dietary restrictions and number of diners Get daily menu recommendations to solve meal decision difficulties Integrate with MCP clients like Claude and Cursor for cooking assistance

README

🍳 HowToCook-MCP Server 🥘 -- 炫一周好饭,拒绝拼好饭

English | 简体中文

让 AI 助手变身私人大厨,为你的一日三餐出谋划策!

基于Anduin2017/HowToCook打造的 MCP(Model Context Protocol)服务器,让 AI 助手能够为你推荐菜谱、规划膳食,解决"今天吃什么"的世纪难题!

数据来源:Anduin2017/HowToCook ⭐ 没有 star 的同学快去点个星星吧!

📸 效果预览

功能预览1 功能预览2

🔌 支持的 MCP 客户端

本服务器适用于所有支持 MCP 协议的 AI 助手和客户端,包括但不限于:

  • 🤖 Claude 桌面应用
  • 📝 Cursor
  • 💼 其他支持 MCP 的客户端

✨ 美味功能

该 MCP 服务器提供以下美食工具:

  1. 📚 查询全部菜谱 - 获取所有可用菜谱数据,做菜百科全书 -- 慎用这个--上下文太大
  2. 🔍 根据分类查询菜谱 - 按照分类筛选菜谱,想吃水产?早餐?荤菜?主食?一键搞定!
  3. 🧩 智能推荐膳食 - 根据你的忌口、过敏原和用餐人数,为你规划整整一周的美味佳肴
  4. 🎲 不知道吃什么 - 选择困难症福音!根据人数直接推荐今日菜单,再也不用纠结了

🚀 快速上手

📋 先决条件

  • Node.js 16.0.0+ 🟢
  • npm 或 yarn 📦

💻 安装步骤

  1. 克隆美食仓库
git clone https://github.com/worryzyy/howtocook-mcp.git
cd howtocook-mcp
  1. 安装依赖(就像准备食材一样简单!)
npm install
  1. 编译代码(烹饪过程...)
npm run build

🍽️ 开始使用

🔥 启动服务器

npm start

🔧 配置 MCP 客户端

推荐使用 Cursor 快速体验(两种方式)

  1. 使用 npm 包:请先运行 npm i -g howtocook-mcp ,否则会出现 Failed to create client

然后在 Cursor 设置中添加 MCP 服务器配置:

{
	"mcpServers": {
		"howtocook-mcp": {
			"command": "npx",
			"args": ["-y", "howtocook-mcp"]
		}
	}
}
  1. 如果是克隆仓库本地运行,请使用如下配置
{
	"mcpServers": {
		"howtocook-mcp": {
			"command": "node",
			"args": ["youpath\\howtocook-mcp\\build\\index.js"]
		}
	}
}

其他 MCP 客户端

对于其他支持 MCP 协议的客户端,请参考各自的文档进行配置,通常需要指定:

  • 服务器名称: howtocook-mcp
  • 命令: npx -y howtocook-mcp
  1. 重启客户端,让美食魔法生效 ✨

🧙‍♂️ 菜单魔法使用指南

以下是在各种 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全局安装
  • 本服务兼容所有支持 MCP 协议的 AI 助手和应用
  • 首次使用时,AI 可能需要一点时间来熟悉如何使用这些工具(就像烧热锅一样)

🤝 贡献

欢迎 Fork 和 Pull Request,让我们一起完善这个美食助手!

📄 许可

MIT License - 随意使用,就像分享美食配方一样慷慨!


🍴 美食即将开始,胃口准备好了吗?

HowToCook-mcp FAQ

How do I install the HowToCook-mcp server?
Clone the repository, ensure Node.js 16+ is installed, then run npm or yarn to install dependencies.
Can HowToCook-mcp handle dietary restrictions?
Yes, it intelligently plans meals considering allergies and dietary preferences.
Which MCP clients are compatible with HowToCook-mcp?
It supports all MCP clients including Claude desktop app and Cursor.
How does HowToCook-mcp recommend daily menus?
It uses user input like number of diners and preferences to suggest suitable daily meals.
Is the recipe data sourced externally?
Yes, it uses data from the Anduin2017/HowToCook GitHub repository.
Can I query recipes by category?
Yes, you can filter recipes by categories such as seafood, breakfast, or main dishes.
What programming environment is required?
Node.js version 16.0.0 or higher is required to run the server.
Does HowToCook-mcp support multiple languages?
The project provides documentation in English and Simplified Chinese.