HowToCook 程序员做饭指南：10 万星开源菜谱怎么用、怎么部署、怎么接 AI

一句话结论：HowToCook 是 GitHub 上 10.2 万星的中文开源菜谱库，372 道家常菜的用量写到克、步骤写到分钟，采用 Unlicense 公有领域授权。想直接用，打开在线站点或智盒的「今天吃什么」工具即可；想自托管，一条 Docker 命令就能跑起来；想让 AI 帮你排一周菜单，社区已经有现成的 MCP 服务器。

AI 摘要

• 资源类型：GitHub 开源项目（Markdown 菜谱库）
• 来源：Anduin 2017/HowToCook，社区维护，GitHub API 显示约 480 位贡献者（含匿名提交，2026-10-10 核查）
• 适合人群：做饭新手、独居上班族、想把菜谱数据接进自己应用或 AI 助手的开发者
• 使用价值：用量精确、步骤可执行、数据结构统一，可以直接解析成 JSON 二次开发
• 风险边界：卡路里和难度都是「预估」；Docker 版自带默认管理员密码，部署后必须修改

资源信息

• 资源名：HowToCook（程序员做饭指南）
• 资源 URL：https://github.com/Anduin 2017/HowToCook
• 类型：开源项目
• 许可或授权：Unlicense（放弃版权，等同公有领域）
• 是否免费：完全免费
• 是否需要登录：浏览和下载都不需要
• 最近核查日期：2026-10-10（10.26 万星、1.11 万 Fork，最近一次提交 2026-09-23）

HowToCook 是什么，为什么程序员会喜欢它？

HowToCook 是作者 Anduin 2017 发起的中文菜谱开源仓库，项目名直译就是「怎么做饭」。作者在 README 里说得很直白：网上的菜谱写法千奇百怪，中间常常莫名冒出一种没提过的材料，这对习惯形式语言的程序员极不友好。所以仓库里每道菜都按同一套模板来写：先列「必备原料和工具」，再给「计算」（每份用量），然后是编号的「操作」步骤，最后是「附加内容」。

这种写法本质上是把菜谱当成接口文档来维护：输入是原料清单，参数是克数和毫升数，流程是有序步骤，异常处理放在附加说明里。截至 2026-10-10，仓库有 10.26 万星和 1.11 万 Fork，最近一次提交在 2026-09-23，仍在持续更新。

菜谱到底写得有多精确？

以仓库里的「白菜猪肉炖粉条」为例：每份五花肉 300 g、大白菜 500 g、土豆干粉条 50 g、十三香 10 g、食用盐 15 g，老抽和生抽各 5 ml。步骤里的时间和火候也写成可执行的指令，例如「加入老抽，炒 1 分钟」「沸腾后将火调小，等待 20 分钟」，还提醒你粉条煮得慢，应该放在第一步先泡上。

每道菜开头还标了「预估烹饪难度」（1-5 颗星）和「预估卡路里」。我们用脚本解析了全部菜谱：372 道菜分布在 10 个分类里，荤菜 111 道、素菜 64 道、主食 59 道、水产 28 道、早餐 25 道、汤与粥 24 道、饮品 23 道、甜品 19 道、半成品加工 10 道、酱料 9 道。372 道都标了难度，371 道有结构化的原料清单。另外 tips/learn 目录收了 11 篇基础技法，涵盖焯水、炒与煎、蒸、煮、腌、去腥和食品安全等。

哪些人适合用 HowToCook？

• 做饭新手：用量精确到克，照着称就能复现，不用琢磨「盐少许」到底是多少。
• 独居上班族：早餐、半成品加工和微波炉、空气炸锅类菜谱多，适合下班后半小时内搞定一顿饭。
• 选择困难的人：仓库里专门有一篇「如何选择现在吃什么」，也可以直接用随机推荐工具帮你拍板。
• 开发者：所有菜谱都是统一模板的 Markdown，正则就能抽出菜名、难度、卡路里和原料，很适合拿来练手做菜谱 App、小程序，或者做 AI 应用的知识库。
• 内容创作者：Unlicense 授权允许自由改编和商用，不需要署名，但我们仍建议标注来源。

怎么在线使用和本地部署？

Docker 自托管是官方 README 给出的方式：

1. 拉取镜像：docker pull aiursoft/howtocookviewer
2. 启动容器：docker run -d -p 5000:5000 aiursoft/howtocookviewer
3. 浏览器访问 http://localhost:5000。官方说明启动后 30 分钟内会自动建立索引。
4. 默认管理员账号是 admin，密码是 Admin@123456!。只要服务能从外网访问，第一件事就是改掉这个密码。

如果只想要数据，执行 git clone --depth 1 https://github.com/Anduin2017/HowToCook.git 即可，菜谱都在 dishes/ 目录下按分类存放。仓库带了约 110 MB 的成品图，只要文字的话，可以加上 --filter=blob:limit=200k 跳过大文件。

智盒「今天吃什么」工具能帮你做什么？

官方站适合按目录翻菜谱，但很多人真正的问题是「今天吃什么」和「冰箱里这些东西能做什么」。所以我们用 HowToCook 的数据做了一个纯静态小工具，部署在 今天吃什么在线工具，也收录在智盒的 在线工具合集 里。

它有三个功能：随机推荐可以限定分类和最高难度，一次出 1、3 或 5 道菜；按食材找菜会按命中的食材数排序，比如输入「鸡蛋 西红柿 土豆」，西红柿炒鸡蛋、西红柿土豆炖牛肉这类菜会排在最前面；全部菜谱支持按菜名或食材搜索。点开任何一道菜都能看到完整做法，链接可以直接发给家人。工具不需要登录，也不加统计代码。菜谱数据是 2026-10-10 的仓库快照，之后会定期重新构建。

怎样让 AI 助手帮你安排一周菜单？

HowToCook 的 README 在「衍生作品推荐」里列了两个 MCP 服务器，可以让 Claude、Cursor 等支持 MCP 的 AI 助手直接查询菜谱。其中 Node.js 版 worryzyy/HowToCook-mcp 有 779 星，npm 包 howtocook-mcp 当前版本为 0.2.2，需要 Node.js 16 或更高版本。

接入只要在 MCP 客户端配置里加一段：

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

它提供五个工具：查询全部菜谱、按分类查询、查询指定菜谱、按忌口/过敏原/人数推荐一周膳食，以及按人数直接推荐今日菜单。作者特别提醒「查询全部菜谱」返回的上下文很大，要慎用。要注意，这个仓库的 README 写的是 MIT，npm 包元数据标的却是 ISC，GitHub 也没有识别出许可证文件，用于商业产品前最好先找作者确认。接入任何第三方 MCP 前，都建议先读一遍源码，可以参考我们写过的 MCP 与 Skill 供应链安全检测。如果你想把更多 SaaS 也接进 Agent，可以看 open-connector 统一网关方案。

下载地址

• 官方在线站：https://howtocook.aiursoft.com
• GitHub 源码：https://github.com/Anduin 2017/HowToCook （页面右上角 Code → Download ZIP）
• Docker 镜像：https://hub.docker.com/r/aiursoft/howtocookviewer
• 在线工具：https://aikit-howtocook.vercel.app
• MCP 服务器：https://github.com/worryzyy/HowToCook-mcp

使用 HowToCook 有哪些风险和限制？

• 授权：主仓库是 Unlicense，可以自由使用、修改和商用。衍生的 MCP 项目许可证标注不一致（见上文），不能默认按主仓库的授权处理。
• 数据精度：难度和卡路里都是贡献者「预估」的，不能当作营养计算或医疗饮食依据。克数是「每份」的参考值，人数不同要自己换算。
• 质量边界：菜谱由社区提交，写法和精细程度参差不齐。仓库里还出现过同名菜谱，比如「陈皮排骨汤」有两份。遇到矛盾的地方，以附加说明和实际试吃为准。
• 自托管安全：Docker 版自带默认管理员密码，暴露到公网前必须修改，最好再放到反向代理和访问控制后面。如果你要自托管更复杂的业务系统，可以参考 Chatwoot 自托管部署思路。
• 替代资源：想要图文排版和 PDF 导出，可以看 README 推荐的「图像化菜谱」衍生站；想要更多地方菜系，可以去下厨房等商业平台，但它们的数据不能自由二次开发。

FAQ

HowToCook 的菜谱可以商用吗？

可以。主仓库采用 Unlicense，作者放弃了版权，相当于公有领域，可以复制、修改、商用，不强制署名。不过衍生项目各有各的许可证，比如 HowToCook-mcp 的标注就不一致，商用前需要逐个确认。

完全不会做饭的新手适合用吗？

适合。每道菜都标了 1-5 星的预估难度，还有每份用量和编号步骤。新手可以先从一星、两星的菜开始，比如炒滑蛋、蒸水蛋，再配合 tips/learn 里焯水、炒与煎这几篇基础技法。

本地部署需要什么配置？

只要能运行 Docker 就行，执行 docker run -d -p 5000:5000 aiursoft/howtocookviewer 即可。官方说明启动后 30 分钟内自动建立索引，默认账号 admin、密码 Admin@123456!，部署后务必修改。

怎么让 ChatGPT 或 Claude 根据菜谱推荐菜单？

用支持 MCP 的客户端（如 Claude 桌面版、Cursor），在 mcpServers 里配置 npx -y howtocook-mcp。之后就可以让 AI 按忌口、过敏原和人数安排一周菜单，或者直接推荐今天吃什么。

有哪些同类资源？

官方 README 推荐了「图像化菜谱」（支持在线预览和 PDF 导出）和 Python 版 MCP 服务器 howtocook-py-mcp。如果只想快速决定吃什么，可以直接用智盒的「今天吃什么」工具。