🥗 Kitchen MCP Server

A Model Context Protocol (MCP) server focused on food, nutrition, and recipe suggestions. This project allows you to query ingredients, get nutritional information, and receive recipe recommendations using the open MCP standard, making it compatible with Claude Desktop and other MCP clients.

Features

Query foods and their nutritional information.
Search for foods by nutritional criteria (protein, fat, calories).
List available ingredients.
Get all available recipes.
Get recipe suggestions based on nutrition.
Find recipes by ingredients.
Suggest recipes by diet type (vegan, keto, etc.) and calories.
Suggest substitutes for a given ingredient.
Suggest necessary kitchen utensils for a recipe.
Recommend foods or recipes based on your mood and optionally the season.
All endpoints follow the MCP protocol and are compatible with Claude Desktop and other MCP clients.

Project Structure

src/mcp-server.js: Main MCP server implementation (Node.js).
src/utils.js: Utility functions (e.g., Levenshtein distance).
data/: Contains JSON and CSV files with food and recipe data.

Requirements

Node.js 18 or higher
npm

Installation

Clone the repository:
git clone https://github.com/paulabaal12/kitchen-mcp.git cd kitchen-mcp
Install dependencies:
npm install
Make sure your data files (ingredientes_unificados.json, recetas_unificadas.json) are present in the src/data/ directory.

Usage

Running the MCP Server

To start the server for use with Claude Desktop:

node src/mcp-server.js

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

{ "mcpServers": { "kitchen": { "command": "node", "args": [ "D:/Documentos/GitHub/kitchen-mcp/src/mcp-server.js" ], "env": { "NODE_ENV": "production" } } } }

Adjust the path if your project is in a different location.

Example: Get Recipes by Ingredients

Prompt in Claude Desktop:

I want to cook something with apple, sugar and butter.

Sample MCP Tool Call (Direct Format):

{ "method": "get_recipes_by_ingredients", "params": { "ingredients": ["apple", "sugar", "butter"] } }

Sample MCP Tool Call (Generic Format):

{ "method": "tools/call", "params": { "name": "get_recipes_by_ingredients", "arguments": { "ingredients": ["apple", "sugar", "butter"] } } }

Sample Response:

{ "content": [ { "type": "text", "text": "[\n {\n \"name\": \"Fruit Galette\",\n \"ingredients\": [\"apple\", \"sugar\", \"butter\", ...],\n ...\n },\n ...\n]" } ] }

Example Recipe: Creole Cream Cheesecake With Caramel-Apple Topping

Ingredients:

Graham cracker crumbs, sugar, butter, cream cheese, eggs, apples, honey, cinnamon, cardamom, ginger, vanilla, lemon.

Preparation:

Prepare the crust and bake.
Mix and bake the cheesecake filling.
Make the caramel-apple topping in a pan.
Chill the cheesecake, then top with apples before serving.

Approximate Calories:
~7,700 calories for the whole cheesecake (about 480–640 per slice).

MCP Tools (Endpoints)

The following MCP tools are available:

Name	Description
`get_foods`	Get all available foods.
`get_food_by_name`	Find a specific food by name.
`search_foods`	Search foods by nutritional criteria (minProtein, maxFat, maxCalories).
`get_ingredients`	Get list of available ingredients.
`get_recipe_suggestions`	Get recipe suggestions based on nutritional content.
`get_recipes`	Get all available recipes.
`get_recipes_by_ingredients`	Find recipes by specific ingredients.
`suggest_recipe_by_diet`	Suggest recipes by diet type (vegan, keto, etc). Optionally filter by calories.
`suggest_ingredient_substitution`	Suggest substitutes for a given ingredient (e.g., orange juice).
`suggest_utensils_for_recipe`	Suggest necessary kitchen utensils for a given recipe (by name).
`recommend_by_mood_and_season`	Recommends foods or recipes based on mood and optionally season (e.g., happy + summer).

Prompt:

I feel happy, what can I eat?

Sample MCP Tool Call (Direct Format):

{ "method": "recommend_by_mood_and_season", "params": { "mood": "happy" } }

Sample MCP Tool Call (Generic Format):

{ "method": "tools/call", "params": { "name": "recommend_by_mood_and_season", "arguments": { "mood": "happy" } } }

Sample Response:

{ "content": [ { "type": "text", "text": "[\n {\"name\": \"Fruit Salad\", ...}, ...]" } ] }

If you add a season (e.g., "season": "autumn"), the recommendations will also consider seasonal foods.
You can set type to food or recipe (default is recipe).

Example: Suggest Utensils for a Recipe

Prompt:

What utensils do I need for lasagna?

Sample MCP Tool Call (Direct Format):

{ "method": "suggest_utensils_for_recipe", "params": { "recipe_name": "lasagna" } }

Sample MCP Tool Call (Generic Format):

{ "method": "tools/call", "params": { "name": "suggest_utensils_for_recipe", "arguments": { "recipe_name": "lasagna" } } }

Sample Response:

{ "content": [ { "type": "text", "text": "{\n \"recipe\": \"lasagna\",\n \"utensils\": [\"pan\", \"pot\", ...]\n}" } ] }

Visual Examples with Claude Desktop

Example: Recipe search by ingredients or diet

alt text Recipe search using ingredients in Claude Desktop.

Example: Recommendation by mood

alt text Food recommendation based on mood in Claude Desktop.

Example: Utensil suggestion

alt text Automatic utensil suggestion for a recipe in Claude Desktop.

Example: Ingredient substitution

alt text Ingredient substitution suggestion in Claude Desktop

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Kitchen MCP Server

🥗 Kitchen MCP Server

Features

Project Structure

Requirements

Installation