# Menus Recommender

> Menus Recommender is an open-source MCP server for food and drink. MCP server that suggests diverse dishes from a global food knowledge base for AI clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/spyyps/recommend-dish/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.spyyps/menus-recommender
- **Categories:** [food and drink](https://ai-powered.com/categories/food-and-drink)
- **Listing updated:** 2026-11-18

## About

The README says this server ships a weighted random dish recommender built on a knowledge base of roughly 460 dishes across 41 cuisines, so an AI assistant can propose meal ideas instead of generating them from scratch. Callers can narrow results by keywords such as flavour, ingredient or dish type, by price tier or price ceiling in CNY, by cuisine or broad region, and can pass previously shown dish IDs to avoid repeats when asking for a fresh batch.

The main tool, recommend_dishes, returns structured JSON with dish names in Chinese and English, price, cuisine, region and a short description, plus a flag indicating whether the candidate pool was exhausted. The README describes a fallback chain for that case: relaxing the price filter, searching the web, or answering from general knowledge, with the calling agent responsible for that logic.

It is aimed at developers and users of MCP-compatible clients such as Claude Desktop, Cline, Cursor and Continue who want dining suggestions. It is installable from PyPI via uvx or pip, or can be run from source.

## Features

- **Weighted random recommendations:** Picks dishes at random with weights that offset large cuisines so smaller ones still appear.
- **Keyword and price filters:** Filters results by a fixed keyword list covering taste, ingredient and dish type, plus price tiers and a maximum price.
- **Cuisine and region selection:** Narrows suggestions to a named cuisine or a broad geographic region.
- **Deduplicated refresh:** Accepts excluded dish IDs so repeated requests return a different set of dishes.
- **Structured JSON output:** Returns dish IDs, names in Chinese and English, prices, cuisines, regions and descriptions as JSON.
- **Exhaustion signal:** Reports when the candidate pool is too small so the calling agent can fall back to other sources.

## Good for

- Suggesting dinner options within a set budget
- Finding dishes from a specific cuisine or region for a meal plan
- Generating a fresh list of dish ideas without repeating earlier picks
- Giving an AI assistant a local knowledge base to answer what to eat questions

## Install

### Claude Code (Terminal)

```sh
claude mcp add menus-recommender -- uvx menus-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "menus-recommender": {
      "command": "uvx",
      "args": [
        "menus-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "menus-recommender": {
      "command": "uvx",
      "args": [
        "menus-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "menus-recommender": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "menus-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "menus-recommender": {
      "command": "uvx",
      "args": [
        "menus-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "menus-recommender": {
      "command": "uvx",
      "args": [
        "menus-mcp"
      ]
    }
  }
}
```

## Tools

- `recommend_dishes`: Returns weighted random dish recommendations with optional keyword, price, cuisine, region and exclusion filters.
- `list_keywords`: Returns the supported keyword whitelist.

## FAQ

### How do I install the server?

The README lists three methods: run it with uvx using the PyPI package menus-mcp, install it with pip and point the client at the menus-mcp command, or run the source file from the GitHub repository.

### Does it need any API keys or environment variables?

The registry entry lists no environment variables for the PyPI package.

### What happens when a keyword is passed?

The README says keywords act as hard filters with OR matching, so a dish must match at least one supplied keyword; it advises omitting a keyword rather than passing a negated one.

### Which MCP tools are exposed?

The README documents recommend_dishes and list_keywords.

### Is Menus Recommender free?

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

### How do I add Menus Recommender to Claude Code?

Run this command in your terminal: claude mcp add menus-recommender -- uvx menus-mcp

### What are the best alternatives to Menus Recommender?

The closest alternatives to Menus Recommender are Spoonacular, MCP Ptitchef, MCP Recipes, ask.recipes and Frigolog HACCP — French Food Safety Compliance.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Spoonacular](https://ai-powered.com/mcp/spoonacular): Spoonacular is a freemium MCP server for food and drink.
- [MCP Ptitchef](https://ai-powered.com/mcp/mcp-ptitchef): MCP Ptitchef is an open-source MCP server for food and drink.
- [MCP Recipes](https://ai-powered.com/mcp/mcp-recipes): MCP Recipes is a free MCP server for food and drink.
- [ask.recipes](https://ai-powered.com/mcp/ask-recipes): ask.recipes is a free MCP server for food and drink.
- [Frigolog HACCP — French Food Safety Compliance](https://ai-powered.com/mcp/frigolog-haccp-french-food-safety-compliance): Frigolog HACCP — French Food Safety Compliance is an open-source MCP server for security.
- [Plate Artists](https://ai-powered.com/mcp/plate-artists): Plate Artists is a free MCP server for food and drink.
- [Foodish](https://ai-powered.com/mcp/foodish): Foodish is a freemium MCP server for food and drink.
- [eatmundo](https://ai-powered.com/mcp/eatmundo): eatmundo is a free MCP server for food and drink.

---
Source: https://ai-powered.com/mcp/menus-recommender
