Skip to content
MCP server

MCP Ptitchef

Search Ptitchef recipes, read one and rescale it to any servings, no API key

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.1.0
Listing updated
1 day ago

About MCP Ptitchef

MCP Ptitchef is an open-source MCP server for food and drink. It runs locally on your machine and is started by your AI client.

Ptitchef is a French cooking site where home cooks publish recipes with ingredients, photographed steps, timings, cost, nutrition figures and reader ratings. This server connects a chat client to it, so an assistant can browse the site's tree of ingredient families, search by dish or ingredient, and read a full recipe.

Two tools stand out. One answers what can be cooked from the ingredients already in the fridge, and another rescales an ingredient list to a chosen number of servings, without contacting the site at all. Recipes are searched in French, since that is the site's language, and a separate tool lists the other languages a recipe was published in.

The server is polite to the site: it waits at least 1.5 seconds between requests by default, caches results in memory, retries when the site is busy and identifies itself with a user agent you can extend. It needs Node 24 or later and runs through npx, Docker or a downloadable MCP bundle.

Install

Run in a terminal

claude mcp add mcp-ptitchef -- npx -y mcp-ptitchef

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-ptitchef": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ptitchef"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-ptitchef": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ptitchef"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-ptitchef": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-ptitchef"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PTC_USER_AGENTIdentify your own client. This project's identifier stays appended, so the site can always reach a human.
  • PTC_MIN_INTERVAL_MSMinimum milliseconds between requests. Default 1500, floor 1000, ceiling 60000.
  • PTC_TIMEOUT_MSDeadline for one request, in milliseconds. Default 20000.
  • PTC_MAX_RETRIESRetries when the site is busy or asks for room. Default 3.
  • PTC_CACHE_TTL_MSIn-memory cache lifetime, in milliseconds. Default 900000. Set 0 to turn it off.
  • PTC_CACHE_MAX_ENTRIESIn-memory cache size. Default 200.
  • PTC_MAX_BODY_BYTESThe most one page may run to before the read is abandoned. Default 8000000.
  • PTC_BUDGET_MSThe whole of the time one read may take, retries included. Default 60000.
  • PTC_LOG_LEVELsilent, error, info or debug. Default error. Logs go to stderr.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

list_categories
Walks the tree of ingredient families the site files recipes under.
search_recipes
Finds recipes by dish or by ingredient.
browse_recipes
Reads a category page by page, or one of the site's standing lists.
search_by_ingredients
Answers what can be made from the ingredients a cook already has.
get_recipe
Reads one recipe, rescaled to a number of servings on request.
scale_ingredients
Rescales any ingredient list without contacting the site.
get_recipe_translations
Lists the other languages a recipe was published in.

What it does

Recipe search
Finds recipes by dish or ingredient, in French.
Category browsing
Walks the ingredient tree and reads categories or standing lists.
Fridge search
Suggests recipes from ingredients a cook already has.
Serving rescale
Reads a recipe scaled to a chosen number of people.
Translations
Lists other languages a recipe was published in.
Rate-limited access
Spaces requests and caches results, with settings for both.

Good for

  • Find a dinner idea from what is left in the fridge
  • Scale a recipe up for eight guests
  • Browse the highest-rated recipes on the site
  • Check whether a recipe exists in another language

Pricing

Open source

Free; no API key needed

MCP Ptitchef FAQ

Does it need an API key?

No. The README says it needs no API key and no account.

How do I install it?

Run claude mcp add ptitchef -- npx -y mcp-ptitchef, or use the Docker image or the MCPB bundle. Node 24 or later is required.

What language do searches use?

French, because Ptitchef is a French site.

Can I change the request rate?

Yes. The PTC_MIN_INTERVAL_MS variable sets the minimum gap between requests, 1500 ms by default.

Is MCP Ptitchef free?

Yes. MCP Ptitchef is open source, so you can use and self-host it for free.

How do I add MCP Ptitchef to Claude Code?

Run this command in your terminal: claude mcp add mcp-ptitchef -- npx -y mcp-ptitchef

What are the best alternatives to MCP Ptitchef?

The closest alternatives to MCP Ptitchef are Fast Food Index, Cook with Loopware, O Meu Financeiro, Cellarion and Cellarion Wine Registry.

Alternatives to MCP Ptitchef

  1. Fast Food Index

    MCP server

    Live US fast food menu prices, Big Mac index by state and verified price changes

    • 6 tools
    • Remote
    • Free
    • Food and drink
  2. Calculated recipes for your cookware, guided step by step by your voice assistant

    Not checked yet
    • Remote
    • Free
    • Food and drink
  3. Ask about a Brazilian restaurant's sales, bills, balances and DRE, and log expenses

    Not checked yet
    • Remote
    • Free trial
    • Finance and payments
  4. Cellarion

    MCP server

    Local stdio bridge that lets Claude Desktop or Cursor query your Cellarion wine cellar

    Not checked yet
    • Remote
    • Open source
    • Food and drink
  5. Public MCP endpoint for searching wines, grapes, regions and appellations, no account

    • 6 tools
    • Remote
    • Free
    • Food and drink
  6. MyGroceryPal

    MCP server

    Compare UK supermarket prices for items, baskets and lists from ChatGPT or Claude

    • 11 tools
    • Remote
    • Free
    • E-commerce