Recipe

Provides AI-powered recipe generation and transformation via an MCP server with dietary and nutrition targeting.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 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": {
    "valetdotdev-recipe-mcp": {
      "command": "npx",
      "args": [
        "@cookwith/recipe-mcp"
      ],
      "env": {
        "COOKWITH_API_URL": "https://cookwith.co"
      }
    }
  }
}

You can deploy and run an MCP server that generates and modifies personalized recipes using natural language prompts. This server supports creating new recipes from descriptions, transforming existing ones to meet dietary goals, and adjusting nutrition targets, all accessible through MCP clients without requiring an API key.

How to use

Use an MCP client to connect to the Recipe MCP Server. You can generate new recipes by describing what you want and apply transformations to existing recipes to meet dietary or nutritional goals. Typical workflows include creating a recipe from a description, adjusting ingredients to be vegan or gluten-free, and tuning calories or protein per serving.

How to install

Prerequisites: you should have Node.js installed on your system. You may also need a terminal or command prompt with access to npm and npx.

# Install the MCP server
npm install -g @cookwith/recipe-mcp

Additional setup for Claude Desktop

Configure your Claude Desktop to use the Recipe MCP Server by adding a server configuration that points to the MCP runner and its API URL.

{
  "mcpServers": {
    "recipe-mcp": {
      "command": "npx",
      "args": ["@cookwith/recipe-mcp"],
      "env": {
        "COOKWITH_API_URL": "https://cookwith.co"
      }
    }
  }
}

Run in development mode

If you are developing or testing locally, you can clone the project, install dependencies, and run in development mode to iterate on changes quickly.

# Clone the repository
git clone https://github.com/cookwith/recipe-mcp.git
cd recipe-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

Usage examples

Generate a recipe by describing your needs in natural language, optionally including dietary restrictions and calorie targets. The MCP server will produce a recipe object with ingredients and instructions that fit your criteria.

Available tools

generate_recipe

Generate a new recipe based on a natural language description with optional dietary restrictions, allergies, disLikes, calories, protein, and servings.

transform_recipe

Transform an existing recipe according to instructions, with optional new calories, protein, and servings.