howtocook mcp

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!

? Preview

? 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

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

npm install

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

npm run build

?️ Getting Started

? Start the Server

npm start

? Configure MCP Clients

It is recommended to use Cursor for quick experience (two methods)Cursor Configuration

1. Using npm package: Please run npm i -g howtocook-mcp first, otherwise Failed to create client will appear

Then add the MCP server configuration in Cursor settings:

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

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

{
    "mcpServers": {
        "howtocook-mcp": {
            "command": "node",
            "args": ["yourpathhowtocook-mcpbuildindex.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

• 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)

? 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?