🍳 HowToCook-MCP Server 🥘 -- Plan Your Weekly Meals, No More Daily Struggles

English | 简体中文

Turn your AI assistant into a personal chef that helps plan your daily meals!

An MCP (Model Context Protocol) server based on Anduin2017/HowToCook, allowing AI assistants to recommend recipes, plan meals, and solve the age-old question of "what should I eat today?"

Data Source: Anduin2017/HowToCook ⭐ Don't forget to star the repo if you haven't already!

🔌 Supported MCP Clients

This server works with all AI assistants and clients that support the MCP protocol, including but not limited to:

• 🤖 Claude Desktop App
• 📝 Cursor
• 💼 Other MCP-compatible clients

✨ Delicious Features

This MCP server provides the following culinary tools:

1. 📚 Query All Recipes - Access all available recipe data, your complete cooking encyclopedia -- Use with caution due to large context size
2. 🔍 Query Recipes by Category - Filter recipes by category: seafood, breakfast, meat dishes, staple foods, and more!
3. 🧩 Smart Meal Planning - Get a full week's meal plan based on dietary restrictions, allergies, and number of diners
4. 🎲 Don't Know What to Eat? - Perfect for the indecisive! Get instant menu recommendations based on party size

🚀 Quick Start

📋 Prerequisites

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

💻 Installation

1. Clone the repository

git clone https://github.com/worryzyy/howtocook-mcp.git
cd howtocook-mcp-server

2. Install dependencies (as simple as preparing ingredients!)

npm install

3. Build the code (the cooking process...)

npm run build

🍽️ Getting Started

🔥 Start the Server

npm start

🔧 Configure MCP Clients

Cursor Configuration

First run npm i howtocook-mcp, otherwise you'll encounter a Failed to create client error.

Then add the MCP server configuration in Cursor settings:

{
	"mcpServers": {
		"howtocook-mcp": {
			"command": "npx",
			"args": ["-y", "howtocook-mcp"]
		}
	}
}

If running from a local cloned repository, use this configuration:

{
	"mcpServers": {
		"howtocook-mcp": {
			"command": "node",
			"args": ["yourpath\\howtocook-mcp\\build\\index.js"]
		}
	}
}

Other MCP Clients

For other clients supporting the MCP protocol, refer to their respective documentation. Generally, you'll need to specify:

• Server name: howtocook-mcp
• Command: npx -y howtocook-mcp

3. Restart the client to activate the culinary magic ✨

🧙‍♂️ Culinary Magic Usage Guide

Here are example prompts for using these tools in MCP clients:

1. 📚 Query All Recipes

No parameters needed, just summon the culinary encyclopedia!

Please use the howtocook MCP service to query all recipes

2. 🔍 Query Recipes by Category

Please use the howtocook MCP service to query seafood recipes

Parameters:

• category: Recipe category (seafood, breakfast, meat dishes, staple foods, etc.)

3. 🧩 Smart Meal Planning

Please use the howtocook MCP service to recommend a weekly meal plan for 3 people. We don't eat cilantro and are allergic to shrimp.

Parameters:

• allergies: List of allergens, e.g., ["garlic", "shrimp"]
• avoidItems: Dietary restrictions, e.g., ["green onion", "ginger"]
• peopleCount: Number of diners (1-10)

4. 🎲 What to Eat Today?

Please use the howtocook MCP service to recommend a dinner menu for 4 people

Parameters:

• peopleCount: Number of diners (1-10)

📝 Tips

• This package is published on npm and can be installed globally via npm install -g howtocook-mcp
• Compatible with all AI assistants and applications that support the MCP protocol
• On first use, AI may need some time to familiarize itself with these tools (like preheating an oven)
• Ensure the all_recipes.json file is properly accessible by the program

🤝 Contributing

Forks and Pull Requests are welcome! Let's improve this culinary assistant together!

📄 License

MIT License - Feel free to use, just like sharing your favorite recipes!

---

🍴 The feast is about to begin, is your appetite ready?