🍳 HowToCook-MCP 服务器 🥘 -- 炫一周好饭，拒绝拼好饭

English | 简体中文

让 AI 助手变身私人大厨，为你的一日三餐出谋划策！

基于Anduin2017/HowToCook打造的 MCP(Model Context Protocol)服务器，让 AI 助手能够为你推荐菜谱、规划膳食，解决"今天吃什么"的世纪难题！

数据来源：Anduin2017/HowToCook ⭐ 没有 star 的同学快去点个星星吧！

🎉 想直接使用当前 MCP？立即体验 https://howtocookmcp.weilei.site/

🎉 同时，我们也提供了 DXT（Desktop Extensions）供大家体验，一键安装到 Claude Desktop

如下：请确保你已经安装了最新版的 Claude Desktop, 当前 MCP 的 DXT 文件已上传代码库，可以自行下载或者 Fork 本仓库自行构建

本地开发如何打包成 DXT？

1.运行 npm install -g @anthropic-ai/dxt

2.在包含本地 MCP 服务器的文件夹中，运行 dxt init。也就是您 MCP 的根目录，此命令将引导您创建manifest.json

3.运行dxt pack创建 dxt 文件

现在，任何支持 DXT 的应用都可以运行您的本地 MCP 服务器。例如，使用适用于 macOS 和 Windows 的 Claude 打开该文件即可显示安装对话框

具体参阅:anthropics/dxt

📸 效果预览

🔌 支持的 MCP 客户端

本服务器适用于所有支持 MCP 协议的 AI 助手和客户端，包括但不限于：

• 🤖 Claude 桌面应用
• 📝 Cursor
• 💼 其他支持 MCP 的客户端

✨ 美味功能

该 MCP 服务器提供以下美食工具:

1. 📚 查询全部菜谱 - 获取所有可用菜谱数据，做菜百科全书 -- 慎用这个--上下文太大
2. 🔍 根据分类查询菜谱 - 按照分类筛选菜谱，想吃水产？早餐？荤菜？主食？一键搞定！
3. 📖 查询指定菜谱 - 根据菜谱名称查询特定菜谱的完整详情，包括食材、步骤等
4. 🧩 智能推荐膳食 - 根据你的忌口、过敏原和用餐人数，为你规划整整一周的美味佳肴
5. 🎲 不知道吃什么 - 选择困难症福音！根据人数直接推荐今日菜单，再也不用纠结了

🚀 快速上手

📋 先决条件

• Node.js 16.0.0+ 🟢
• npm 或 yarn 📦

💻 安装步骤

1. 克隆美食仓库

git clone https://github.com/worryzyy/howtocook-mcp.git
cd howtocook-mcp

2. 安装依赖（就像准备食材一样简单！）

npm install

3. 编译代码（烹饪过程...）

npm run build

🎯 命令行参数

服务器支持以下命令行参数：

• --transport <stdio|http|sse> - 选择传输方式（默认为 stdio）
• --port <number> - 使用 http 或 sse 传输时的监听端口（默认为 3000）

示例：使用 http 传输并监听 8080 端口

node build/index.js --transport http --port 8080

🍽️ 开始使用

🔥 启动服务器

npm start

🔧 配置 MCP 客户端

推荐使用 Cursor 快速体验(两种方式)

1. 使用 npm 包：请先运行 npm i -g howtocook-mcp ,否则会出现 Failed to create client

然后在 Cursor 设置中添加 MCP 服务器配置：

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

2. 如果是克隆仓库本地运行，请使用如下配置

{
	"mcpServers": {
		"howtocook-mcp": {
			"command": "node",
			"args": ["youpath\\howtocook-mcp\\build\\index.js"]
		}
	}
}

其他 MCP 客户端

对于其他支持 MCP 协议的客户端，请参考各自的文档进行配置，通常需要指定：

• 服务器名称: howtocook-mcp
• 命令: npx -y howtocook-mcp

3. 重启客户端，让美食魔法生效 ✨

🧙‍♂️ 菜单魔法使用指南

以下是在各种 MCP 客户端中使用的示例提示语：

1. 📚 查询全部菜谱

无需参数，直接召唤美食全书！

请使用howtocook的MCP服务查询所有菜谱

2. 🔍 根据分类查询菜谱

请使用howtocook的MCP服务查询水产类的菜谱

参数:

• category: 菜谱分类（水产、早餐、荤菜、主食等）

3. 🧩 智能推荐一周菜谱

请使用howtocook的MCP服务为3人推荐一周菜谱，我们家不吃香菜，对虾过敏

参数:

• allergies: 过敏原列表，如 ["大蒜", "虾"]
• avoidItems: 忌口食材，如 ["葱", "姜"]
• peopleCount: 用餐人数 (1-10)

4. 🎲 今天吃什么？

请使用howtocook的MCP服务为4人晚餐推荐菜单

参数:

• peopleCount: 用餐人数 (1-10)

📝 小贴士

• 该包已发布至 npm，可直接通过npm install -g howtocook-mcp全局安装
• 本服务兼容所有支持 MCP 协议的 AI 助手和应用
• 首次使用时，AI 可能需要一点时间来熟悉如何使用这些工具（就像烧热锅一样）

🤝 贡献

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

📄 许可

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

---

🍴 美食即将开始，胃口准备好了吗？

HowToCook-mcp 快速上手指南

让 AI 助手变身私人大厨，基于 MCP 协议连接海量菜谱数据，轻松解决“今天吃什么”的难题。

🛠️ 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本 16.0.0 或更高
• 包管理器: npm 或 yarn
• MCP 客户端: 如 Cursor、Claude Desktop 或其他支持 MCP 协议的 AI 工具

💡 提示：本项目由 Tencent EdgeOne 提供 CDN 加速及安全防护，国内访问速度有保障。

📦 安装步骤

您可以选择全局安装（推荐）或本地克隆源码运行。

方式一：全局安装（推荐）

直接通过 npm 安装，无需下载源码，适合快速集成到现有项目：

npm install -g howtocook-mcp

方式二：本地源码运行

如果您需要修改代码或参与贡献，可克隆仓库：

git clone https://github.com/worryzyy/howtocook-mcp.git
cd howtocook-mcp
npm install
npm run build

🚀 基本使用

1. 配置 MCP 客户端

以 Cursor 为例，在设置中添加以下 MCP 服务器配置。

若使用全局安装：

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

若使用本地源码运行：

请将 youpath 替换为您的实际路径：

{
  "mcpServers": {
    "howtocook-mcp": {
      "command": "node",
      "args": ["youpath\\howtocook-mcp\\build\\index.js"]
    }
  }
}

配置完成后，重启客户端以生效。

2. 调用示例

配置成功后，直接在对话框中输入自然语言指令即可调用菜谱功能：

• 随机推荐菜单（解决选择困难症）：

  请使用 howtocook 的 MCP 服务为 4 人晚餐推荐菜单

• 按分类查询：

  请使用 howtocook 的 MCP 服务查询水产类的菜谱

• 智能规划一周食谱（支持忌口和过敏原）：

  请使用 howtocook 的 MCP 服务为 3 人推荐一周菜谱，我们家不吃香菜，对虾过敏

• 查询特定菜谱详情：

  请查询“红烧肉”的具体做法和食材清单

现在，您的 AI 助手已经准备好为您烹饪美味佳肴了！🍳