io.github.jkakar/cookwith-mcp

Cookwith MCP Server

An MCP (Model Context Protocol) server that provides AI-powered recipe generation and transformation tools using Cookwith's advanced culinary AI.

Features

• Recipe Generation: Create custom recipes from natural language descriptions
• Recipe Transformation: Modify existing recipes based on dietary needs, serving sizes, or other requirements
• Dietary Support: Handle allergies, dietary restrictions, and nutritional goals
• Smart Adaptations: Adjust for calories, protein targets, and serving counts

Installation

Via MCP Registry

npx @modelcontextprotocol/create-server install @cookwith/mcp-server

Via npm

npm install -g @cookwith/mcp-server

For Claude Desktop

Add to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cookwith": {
      "command": "npx",
      "args": ["@cookwith/mcp-server"]
    }
  }
}

Available Tools

generate_recipe

Generate a new recipe based on natural language instructions.

Parameters:

• prompt (string, required): Natural language description of the desired recipe
• dietaryRestrictions (array): Dietary restrictions (e.g., vegetarian, vegan, gluten-free)
• allergies (array): Ingredients to avoid due to allergies
• dislikes (array): Foods the user doesn't like
• calories (string): Target calories per serving
• protein (string): Target protein in grams per serving
• servings (number): Number of servings (1-20, default: 4)

Example:

{
  "prompt": "A healthy pasta dish with lots of vegetables",
  "dietaryRestrictions": ["vegetarian"],
  "calories": "500",
  "servings": 2
}

transform_recipe

Transform or modify an existing recipe based on instructions.

Parameters:

• recipe (object, required): The recipe to transform
  • title (string): Recipe title
  • description (string): Recipe description
  • ingredients (array): List of ingredients
  • instructions (array): Cooking instructions
  • servings (number): Number of servings
  • Additional optional fields for nutrition, timing, etc.
• instructions (string, required): How to transform the recipe
• calories (string): New target calories per serving
• protein (string): New target protein per serving
• servings (number): New number of servings

Example:

{
  "recipe": {
    "title": "Classic Spaghetti Carbonara",
    "description": "Traditional Italian pasta dish",
    "ingredients": ["400g spaghetti", "200g guanciale", "4 eggs", "100g pecorino"],
    "instructions": ["Cook pasta", "Fry guanciale", "Mix eggs and cheese", "Combine"],
    "servings": 4
  },
  "instructions": "Make it vegetarian and reduce calories",
  "calories": "400"
}

Usage Examples

With Claude

Once configured, you can use natural language to interact with the tools:

"Generate a healthy dinner recipe for 2 people with chicken and vegetables, around 500 calories per serving"

"Transform this pasta recipe to be gluten-free and dairy-free"

Programmatic Usage

import { Client } from '@modelcontextprotocol/sdk';

const client = new Client({
  name: 'my-app',
  version: '1.0.0'
});

await client.connect('npx', ['@cookwith/mcp-server']);

// Generate a recipe
const result = await client.callTool('generate_recipe', {
  prompt: 'Quick and healthy breakfast',
  calories: '350',
  servings: 1
});

Development

Building from Source

git clone https://github.com/blaideinc/cookwith-mcp
cd cookwith-mcp
npm install
npm run build

Running Locally

npm start

Testing

npm test

API Endpoint

The MCP server can also be accessed via HTTP at:

• Production: https://cookwith.co/api/mcp
• Development: http://localhost:3000/api/mcp

License

MIT

Support

• GitHub Issues: https://github.com/blaideinc/cookwith-mcp/issues
• Website: https://cookwith.co

About Cookwith

Cookwith is an AI-powered cooking platform that generates personalized recipes based on your preferences, dietary restrictions, and taste profile. Learn more at cookwith.co.