Content
# 🍳 HowToCook-MCP Server 🥘 -- Show off a week of delicious meals, say no to mediocre food
[English](./README.en.md) | 简体中文
> Let the AI assistant transform into your personal chef, helping you plan your three meals a day!
Based on [Anduin2017/HowToCook](https://github.com/Anduin2017/HowToCook), the MCP (Model Context Protocol) server allows the AI assistant to recommend recipes and plan meals, solving the century-old dilemma of "What to eat today?"
Data source: [Anduin2017/HowToCook](https://github.com/Anduin2017/HowToCook) ⭐ If you haven't starred it yet, go give it a star!
## 📸 Preview
## 🔌 Supported MCP Clients
This server is compatible with all AI assistants and clients that support the MCP protocol, including but not limited to:
- 🤖 Claude Desktop Application
- 📝 Cursor
- 💼 Other MCP-compatible clients
## ✨ Delicious Features
This MCP server provides the following culinary tools:
1. **📚 Query All Recipes** - Retrieve all available recipe data, a cooking encyclopedia -- use this with caution -- the context is too large.
2. **🔍 Query Recipes by Category** - Filter recipes by category. Want seafood? Breakfast? Meat dishes? Staples? One-click solution!
3. **🧩 Smart Meal Recommendations** - Plan an entire week of delicious meals based on your dislikes, allergens, and number of diners.
4. **🎲 Not Sure What to Eat** - A blessing for those with decision fatigue! Directly recommend today's menu based on the number of people, no more indecision.
## 🚀 Quick Start
### 📋 Prerequisites
- Node.js 16.0.0+ 🟢
- npm or yarn 📦
### 💻 Installation Steps
1. Clone the culinary repository
```bash
git clone https://github.com/worryzyy/howtocook-mcp.git
cd howtocook-mcp-server
```
2. Install dependencies (as simple as preparing ingredients!)
```bash
npm install
```
3. Compile the code (the cooking process...)
```bash
npm run build
```
## 🍽️ Getting Started
### 🔥 Start the Server
```bash
npm start
```
### 🔧 Configure MCP Client
#### Recommended to use Cursor for a quick experience (two methods)
1. Using npm package: First run `npm i -g howtocook-mcp`, otherwise you will encounter `Failed to create client`.
Then add the MCP server configuration in Cursor settings:
```json
{
"mcpServers": {
"howtocook-mcp": {
"command": "npx",
"args": ["-y", "howtocook-mcp"]
}
}
}
```
2. If running locally from the cloned repository, please use the following configuration:
```json
{
"mcpServers": {
"howtocook-mcp": {
"command": "node",
"args": ["yourpath\\howtocook-mcp\\build\\index.js"]
}
}
}
```
#### Other MCP Clients
For other clients that support the MCP protocol, please refer to their respective documentation for configuration, typically requiring:
- Server Name: `howtocook-mcp`
- Command: `npx -y howtocook-mcp`
3. Restart the client to let the culinary magic take effect ✨
## 🧙♂️ Menu Magic Usage Guide
Here are example prompts for use in various 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, staples, etc.)
### 3. 🧩 Smart Weekly Recipe Recommendation
```
Please use the howtocook MCP service to recommend a week's worth of recipes for 3 people. We don't eat cilantro and are allergic to shrimp.
```
Parameters:
- `allergies`: List of allergens, e.g., ["garlic", "shrimp"]
- `avoidItems`: Disliked ingredients, e.g., ["scallions", "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 has been published to npm and can be globally installed via `npm install -g howtocook-mcp`.
- This service is compatible with all AI assistants and applications that support the MCP protocol.
- On first use, the AI may need a little time to get familiar with how to use these tools (just like heating up a pan).
## 🤝 Contribution
Feel free to Fork and Pull Request, let's improve this culinary assistant together!
## 📄 License
MIT License - Use freely, as generously as sharing a recipe!
---
> 🍴 The feast is about to begin, are you ready to satisfy your appetite?
