
Menus Recommender
A weighted random recommender that pulls from a 396 dish knowledge base spanning 40+ global cuisines. It exposes two MCP tools: recommend_dishes for filtering by keywords like "辣" or "海鲜", price tiers, cuisine types, and geographies, plus list_keywords to show what's supported. The algorithm does OR matching on keywords, applies inverse square root weighting to prevent Chinese cuisine from dominating results, and enforces diversity so you don't get three Sichuan dishes in one batch. Reach for this when you want meal suggestions that balance variety across cuisines instead of just frequency based recommendations. Install via uvx menus-mcp or pip, works with Claude Desktop, Cline, Cursor, and any MCP compatible client. Zero external dependencies, pure Python stdlib.
- tools
- 2
- transport
- STDIO
- last updated
- Jun 9, 2026
Tools
2 toolsPublic tool metadata for what this MCP can expose to an agent.
recommend_dishes在 mcp-server/README.md 中被列为 MCP server 暴露的工具(推荐菜品)。
在 mcp-server/README.md 中被列为 MCP server 暴露的工具(推荐菜品)。
No parameter schema in public metadata yet.
list_keywords在 mcp-server/README.md 中被列为 MCP server 暴露的工具(列出关键词)。
在 mcp-server/README.md 中被列为 MCP server 暴露的工具(列出关键词)。
No parameter schema in public metadata yet.
Sponsors
Readme
环球美食推荐 Plugin
一个 AI agent 插件:当用户表达就餐意向(「推荐晚餐」「不知道吃什么」「想吃点辣的」),基于 462 道菜的全球美食知识库做加权随机推荐。
- 零依赖:纯 Python 3 标准库
- 跨 agent:Claude Code(plugin)+ Gemini CLI(GEMINI.md)+ 任何 MCP 兼容 agent(规划中)
- 智能兜底:本地知识库 → 自动放宽 → 网络搜索 → LLM 常识,4 层兜底
- 去偏置 + 多样性:避免大菜系(如中餐)压制小菜系;避免推荐 3 道全是同一菜系
快速测试
python3 scripts/recommender.py --count 3 --keywords "辣,牛肉"
返回 JSON:
{"dishes": [{"id": "...", "name": "麻婆豆腐", "price": 38, "cuisine": "川菜", ...}, ...], "exhausted": false, ...}
完整参数:
python3 scripts/recommender.py --help
安装到不同 AI Agent
Claude Code
方式 A:自建 marketplace(推荐)
/plugin marketplace add spyyps/recommend-dish
/plugin install menus-recommender@spyyps-recommend-dish
安装后在任意目录的 Claude Code 会话里说「推荐晚餐」「想吃点辣的」即可触发。
后续更新插件:/plugin update menus-recommender。
方式 B:本地 git clone
git clone https://github.com/spyyps/recommend-dish ~/.claude/plugins/menus-recommender
Gemini CLI
git clone https://github.com/spyyps/recommend-dish
cd recommend-dish
gemini # 在本目录运行 Gemini CLI,会自动加载 GEMINI.md
Cursor / Codex
待添加(参考 .cursor-plugin/ 与 .codex-plugin/ 的多 manifest 适配,第二阶段交付)。
Details
- Repository
- github.com/spyyps/recommend-dish
- Package
menus-mcp- Transport
- STDIO
- Registry
- MCP registry, active