Kitchen

Provides MCP-based access to food data, nutrition, and recipe recommendations via a Node.js server.

javascript

0

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run a Model Context Protocol (MCP) server focused on food, nutrition, and recipe recommendations. You can query ingredients, access nutritional data, search by nutritional criteria, explore recipes, and get personalized suggestions. This MCP server is designed to work with Claude Desktop and other MCP clients, enabling seamless interaction with your food data and recipes.

How to use

Connect to this MCP server using an MCP client. You can query all available foods, search foods by nutritional criteria, list ingredients, retrieve all recipes, get recipe suggestions based on nutrition, find recipes by ingredients, and obtain substitutions or utensils for recipes. You can also get mood- and season-aware recommendations and tailor results for diets like vegan or keto. Interacting through an MCP client keeps your requests and responses consistent with MCP standards.

How to install

Prerequisites you need before starting: Node.js version 18 or higher and npm. Ensure you have access to a terminal or command prompt.

# 1) Clone the project
git clone https://github.com/paulabaal12/kitchen-mcp.git
cd kitchen-mcp

# 2) Install dependencies
npm install

# 3) Ensure required data files exist in the data directory
# (ingredientes_unificados.json, recetas_unificadas.json) under src/data/

Additional notes

Start the MCP server locally for use with MCP clients like Claude Desktop. The server is run with Node.js using the main script at src/mcp-server.js.

node src/mcp-server.js

Claude Desktop configuration

If you use Claude Desktop, add a configuration entry to point to the local MCP server. For a typical setup, specify the Node command and the path to the server script as shown.

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

Available tools

get_foods

Retrieve all available foods in the MCP data set.

get_food_by_name

Find a specific food by its name.

search_foods

Search foods by nutritional criteria such as minProtein, maxFat, and maxCalories.

get_ingredients

Get the list of available ingredients.

get_recipe_suggestions

Obtain recipe suggestions based on nutritional content.

get_recipes

Get all available recipes.

get_recipes_by_ingredients

Find recipes that include specified ingredients.

suggest_recipe_by_diet

Suggest recipes by diet type (vegan, keto, etc.) and optional calories filter.

suggest_ingredient_substitution

Suggest substitutes for a given ingredient.

suggest_utensils_for_recipe

Suggest necessary kitchen utensils for a given recipe.

recommend_by_mood_and_season

Recommend foods or recipes based on mood and optionally season.