Howtocook MCP

🚀 How to Cook - MCP Server

Let the AI assistant act as your personal chef to plan your daily meals!

This MCP (Model Context Protocol) server, built on Anduin2017/HowToCook, enables the AI assistant to recommend recipes, plan meals, and solve the age - old problem of "What to eat today"!

Data source: Anduin2017/HowToCook ⭐ If you haven't starred it yet, come and give it a star!

🚀 Quick Start

Prerequisites

• Node.js (Version requirement: 14.17.0 or higher)
• npm (Version requirement: 6.1.0 or higher)

Installation Steps

1. Clone the repository:

git clone https://github.com/yourusername/HowToCook-MCP.git
cd HowToCook-MCP

2. Install dependencies:

npm install

3. Start the server:

node index.js

4. Configure the client (example JSON):

{
  "command": "recommendWeeklyMenu",
  "peopleCount": 3,
  "allergies": ["shellfish", "peanut"],
  "avoidItems": ["tomato"]
}

✨ Features

1. Query All Recipes

# Example: List all available recipes
{
  "command": "listAllRecipes"
}

2. Query Recipes by Category

# Example: Query breakfast recipes
{
  "command": "getRecipeByCategory",
  "category": "breakfast"
}

3. Smartly Recommend Weekly Recipes

# Example: Recommend a weekly menu for a family of four, excluding chives and garlic
{
  "command": "recommendWeeklyMenu",
  "peopleCount": 4,
  "allergies": ["garlic", "green onion"],
  "avoidItems": []
}

4. Randomly Recommend a Menu

# Example: Recommend a random dinner menu for two people
{
  "command": "recommendRandomDinner",
  "peopleCount": 2
}

📦 Supported MCP Clients

• Claude Desktop App
• Cursor
• Other applications supporting the MCP protocol

💻 Usage Examples

Example Conversations

Smartly Recommend Weekly Recipes:

# Example: Recommend a weekly menu for a family of three, excluding chives and garlic
{
  "command": "recommendWeeklyMenu",
  "peopleCount": 3,
  "allergies": ["garlic"],
  "avoidItems": ["green onion"]
}

Randomly Recommend a Menu:

# Example: Recommend a random dinner menu for four people
{
  "command": "recommendRandomDinner",
  "peopleCount": 4
}

💡 Usage Tip

• It has been published to npm and can be installed globally directly:

npm install -g how-to-cook-mcp

• It supports all AI assistants and applications that comply with the MCP protocol.
• When using it for the first time, the AI may take some time to get familiar with these tools (just like heating up a pan).

📸 Preview

🤝 Contribution

Welcome to fork and submit pull requests. Let's improve this food assistant together!

📄 License

MIT License - Use it freely, just as generously as sharing a food recipe!

🍴 The feast is about to begin. Are you ready to dig in?