返回 MCP 目录
public公开dns本地运行

HowToCook-mcp

HowToCook-MCP Server是一个让AI助手变身私人大厨的项目,基于HowToCook菜谱数据,通过MCP协议为AI客户端提供菜谱查询、膳食推荐等功能,解决'今天吃什么'的难题。

article

README

🚀 🍳 如何烹饪-MCP 服务器 🥘

让 AI 助手化身私人大厨,为你的一日三餐出谋划策,解决“今天吃什么”的世纪难题!本项目基于 Anduin2017/HowToCook 打造 MCP(模型上下文协议)服务器,助力 AI 助手推荐菜谱、规划膳食。

English | 简体中文

🚀 快速开始

先决条件

  • Node.js(版本要求:14.17.0 或更高)
  • npm(版本要求:6.1.0 或更高)

安装步骤

  1. 克隆代码库:
git clone https://github.com/yourusername/HowToCook-MCP.git
cd HowToCook-MCP
  1. 安装依赖项:
npm install
  1. 启动服务器:
node index.js
  1. 配置客户端(示例 JSON):
{
  "command": "recommendWeeklyMenu",
  "peopleCount": 3,
  "allergies": ["shellfish", "peanut"],
  "avoidItems": ["tomato"]
}

✨ 主要特性

支持的 MCP 客户端

  • Claude 桌面应用
  • Cursor
  • 其他支持 MCP 协议的应用

功能模块

1. 查询全部菜谱

# 示例:列出所有可用菜谱
{
  "command": "listAllRecipes"
}

2. 分类查询菜谱

# 示例:查询早餐类菜谱
{
  "command": "getRecipeByCategory",
  "category": "breakfast"
}

3. 智能推荐一周菜谱

# 示例:为一家四口推荐一周菜谱,不含香葱和大蒜
{
  "command": "recommendWeeklyMenu",
  "peopleCount": 4,
  "allergies": ["garlic", "green onion"],
  "avoidItems": []
}

4. 随机推荐菜单

# 示例:为两人的晚餐推荐随机菜单
{
  "command": "recommendRandomDinner",
  "peopleCount": 2
}

💻 使用示例

基础用法

智能推荐一周菜谱:

# 示例:为三口之家推荐一周菜谱,不含香葱和大蒜
{
  "command": "recommendWeeklyMenu",
  "peopleCount": 3,
  "allergies": ["garlic"],
  "avoidItems": ["green onion"]
}

随机推荐菜单:

# 示例:为四人晚餐推荐随机菜单
{
  "command": "recommendRandomDinner",
  "peopleCount": 4
}

📚 详细文档

使用指南

示例对话

上述功能模块中的代码示例,均可作为与服务器交互的示例对话,你可以根据实际需求修改参数,如人数、过敏食材等。

小贴士

  • 已发布到 npm,可直接全局安装:
npm install -g how-to-cook-mcp
  • 支持所有符合 MCP 协议的 AI 助手和应用
  • 第一次使用时,AI 可能需要一些时间来熟悉这些工具(就像烧热锅一样)

🤝 贡献

欢迎 Fork 和 Pull Request,让我们一起完善这个美食助手!

📄 许可证

MIT License - 随意使用,就像分享美食配方一样慷慨!


🍴 美食即将开始,胃口准备好了吗?

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端