Recipe MCP

配方mcp

赋予你的人工智能助手查找、调整和计划食谱的能力。

一次搜索12个食谱来源，包括25个以上的流行美食博客和Instagram。用聪明的替代品调整任何食谱以适应你的饮食（无乳制品、犹太洁食、纯素食、酮……）。量配料，计划膳食，建立杂货清单，跟踪你的食品储藏室，一步一步地做饭。所有这些都是通过一个与Claude、ChatGPT、Cursor和任何兼容MCP的AI兼容的工具完成的。

零依赖。2分钟内即可开箱即用。

______________________________________________________________________

它做什么（用简单的英语）

recipe mcp是一个用于AI助手的插件。安装后，您可以与Claude（或任何支持MCP的AI）交谈，并说出以下内容：

• *“给我找一份工作日晚上的意大利面食谱”* --搜索25+热门美食博客和食谱数据库
• *“我有鸡肉、米饭和大蒜——我能做什么？”*
• *“让这个食谱不含乳制品”* （建议用燕麦奶代替牛奶，用纯素奶酪代替奶酪等。）
• *“这个食谱有4份，但我需要12份”*
• *“计划一周的饮食——我是素食主义者”*
• *“根据这些食谱给我列一份购物清单”*
• *“我是犹太教徒——调整这个食谱”* （将肉类和乳制品分开，取代猪肉）
• *“这要煮多久？一步一步地教我”*
• *“现在流行什么？推荐一些新鲜的”*
• *“从这篇Instagram帖子中获取食谱”* --从Instagram标题中提取食谱
• *“我可以用什么来代替浓奶油？”* --智能替代建议
• *“将此配方导出到Notion”*

你的人工智能可以搜索12个来源，包括25个以上的高流量美食博客，找到你需要的东西，并可以修改任何食谱以满足你的饮食需求，而不仅仅是拒绝不匹配的食谱。

______________________________________________________________________

设置（无需编程经验）

第一步：安装Node.js

你的计算机上需要Node.js。如果你没有：

1. 首选 https://nodejs.org
2. 点击大绿色 “下载” 按钮
3. 打开下载的文件并按照安装程序进行操作
4. 完成后，打开你的 终端 （Mac）或 命令提示符 （Windows）
5. 类型 node --version 然后按Enter键——您应该看到一个版本号，如下所示 v20.10.0

步骤2：安装配方mcp

打开终端/命令提示符并键入：

npm install -g recipe-mcp

就是这样。不需要API密钥，不需要帐户，也不需要配置文件。

步骤3：连接到您的AI助手

适用于Claude Desktop（推荐）

1. 打开克劳德桌面
2. 首选 设置 （齿轮图标）→ 开发者 → 编辑配置
3. 这将打开一个文件。将此添加到 "mcpServers" 章节：

{
  "mcpServers": {
    "recipes": {
      "command": "recipe-mcp-server"
    }
  }
}

1. 保存文件并 重新启动克劳德桌面
2. 你应该看到一个锤子图标(🔨) — 单击它查看所有配方工具

对于光标

1. 打开光标设置→ MCP
2. 点击 “添加MCP服务器”
3. 姓名： recipes
4. 命令： recipe-mcp-server
5. 保存并重新启动

对于其他MCP客户端

使用命令 recipe-mcp-server --它通过stdio使用标准MCP协议。

第四步：开始烹饪！

只需向你的AI助手询问食谱。它将自动使用配方工具。

______________________________________________________________________

定价和功能

免费--0美元（无需帐户）

• 从6个免费来源搜索食谱（TheMealDB、TheCockendDB、DummyJSON、RecipePuppy、博客搜索、网络食谱）
• 博客搜索 --搜索超过25个高流量的美食博客（半熟收获、美味小吃、Skinnytaste、Budget Bytes、Smitten Kitchen等）
• 从任何博客URL中提取食谱 --秘密武器
• 获取完整的食谱细节，随机灵感
• 列出饮食概况
• 无需设置 --安装后立即工作

加上——每年8美元· 购买Plus

一切免费，加上：

• 全部12个食谱来源 解锁（纽约时报烹饪，Spoonacular，Edamam，美味，Instagram）
• 1M以上食谱 来自高级数据库
• 保存收藏夹 使用注释和标签——在本地构建您的个人食谱集合
• 库克历史 --跟踪你做了什么、什么时候做的以及你的个人评分
• 无限制搜索（免费等级：50/天）
• 需要设置 -每个附加源都需要一个免费的API密钥（请参阅 源设置指南 在......下面

专业版——19美元/年· 购买专业版

Plus中的所有内容，加上：

• Instagram食谱 --粘贴Instagram帖子URL，获得结构化、可烹饪的食谱
• 烹饪模式 --分步食谱步行器（下一步、上一步、跳到步骤、进度条）
• 智能替换 --“我可以用什么来代替浓奶油？”配上比例和烹饪说明
• 聪明的饮食适应 --它不仅过滤掉食谱，还建议用替代品（无乳制品？用燕麦奶代替牛奶，用奶酪代替营养酵母）
• 12种饮食习惯 --素食、纯素、无麸质、无乳制品、无坚果、鱼素、酮、低碳水化合物、古生物、无贝类、犹太洁食、清真
• 犹太洁食智慧 --检测肉类和乳制品的混合，提出替代品，取代猪肉
• 配方缩放 --按任意数量加倍、减半或缩放+单位转换（杯子↔ml，oz↔g、 °F↔°C）
• 餐具室追踪 --添加您已有的配料，按过道自动分类
• “我的冰箱里有什么？” --告诉它你的配料，找到匹配的食谱
• 季节性建议 --现在流行什么+食谱创意
• 营养比较 --并排比较两个食谱
• 烹饪时间表 --主动时间与被动时间的逐步时序分解
• 膳食计划 --根据饮食偏好自动生成每周计划
• 杂货清单 --按商店过道分类，重复数据消除
• 配方导出 --格式化为Notion、Google Docs或纯markdown
• 食谱分享 --格式化为Slack、Discord或短信
• 无需额外设置 --Pro功能适用于任何来源的任何食谱。只要设置好你的来源就可以了。

激活您的许可证

购买后，您将通过电子邮件收到许可证密钥。激活它：

Ask Claude: "Activate my recipe-mcp license: RMCP-XXXX-XXXX-XXXX"

或者通过CLI：

recipe-mcp license activate RMCP-XXXX-XXXX-XXXX

要检查您当前的级别：请咨询Claude *“我的配方mcp许可证状态如何？”* 或奔跑 recipe-mcp license status.

______________________________________________________________________

源设置指南

配方mcp连接到12个配方源。免费的立即工作。其他人需要一个免费的API密钥或您自己的订阅-下面是如何设置每个密钥。

您可以配置源 通过克劳德 （只需在聊天中提问）或 通过CLI.

免费资源（即时工作，无需设置）

安装配方mcp后，这6个源代码就可以使用了：

没有密钥，没有帐户，没有配置。他们只是工作。

搜索的博客： 极瘦的味道，一点美味，半烤的收获，萨莉的烘焙瘾，该死的美味，用便士消费，RecipeTin Eats，娜塔莎的厨房，Budget Bytes，咖啡馆美食，给我一些烤箱，极简主义面包师，饼干和凯特，爱和柠檬，两个豌豆和它们的豆荚，镀得很好，微笑的厨房，放慢生活节奏，先锋女性，雄心勃勃的厨房，哦，她发光，在动物园吃晚餐，食谱评论家，烹饪课堂等等。加上从Delish、Taste of Home、Simply Recipes、Serious Eats、Bon Appetit、Food Network、Epicurious和King Arthur Baking中提取的JSON-LD。

Spoonacular——1M以上食谱，150次免费请求/天

所需级别： Plus或Pro

1. 注册地址： https://spoonacular.com/food-api （免费，无需信用卡）
2. 转到您的个人资料→ API密钥并复制
3. 配置：

- 在克劳德： *“用钥匙配置Spoonacular your-api-key"* - CLI： recipe-mcp configure spoonacular （然后在提示时粘贴密钥）

Edamam——200多万份含有营养数据的食谱

所需级别： Plus或Pro

1. 注册地址： https://developer.edamam.com （提供免费套餐，无需信用卡）
2. 创建应用程序→ 选择 “配方搜索API”
3. 复制您的 应用标识符 和 程序键 （两个单独的值）
4. 配置：

- 在克劳德： *“配置Edamam YOUR_APP_ID:YOUR_APP_KEY"* （结肠分离） - CLI： recipe-mcp configure edamam （然后粘贴 APP_ID:APP_KEY 当提示时）

美味（Buzzfeed）——流行的时尚食谱

所需级别： Plus或Pro

1. 注册地址： https://rapidapi.com/apidojo/api/tasty （免费版可用）
2. 订阅基本（免费）计划
3. API密钥显示在 X-RapidAPI-Key 任何端点页面上的字段--单击任何端点以查看它
4. 配置：

- 在克劳德： *“使用密钥配置Tasty your-rapidapi-key"* - CLI： recipe-mcp configure tasty （然后在提示时粘贴密钥）

纽约时报烹饪——高级食谱和系列

所需级别： Plus或Pro 还需要： 活跃的纽约时报烹饪订阅（纽约时报每月5美元或每年40美元）

1. 登录 https://cooking.nytimes.com 在浏览器中
2. 打开DevTools：

- 雨衣： Cmd+选项+I - 窗户： F12

1. 点击 应用 DevTools顶部的选项卡
2. 在左侧边栏中，展开 Cookie → click https://cooking.nytimes.com
3. 查找名为的行 NYT-S 然后双击 价值 列以选择它
4. 复制值（它是一个长字符串）
5. 配置：

- 在克劳德： *“使用cookie配置NYT your-NYT-S-value"* - CLI： recipe-mcp configure nyt （然后在提示时粘贴cookie）

注： 您的NYT-S cookie可能会定期过期（通常每几周一次）。如果您遇到身份验证错误，请使用上述相同步骤从浏览器中获取新的cookie。

博客搜索+网络配方适配器（秘密武器）

所需级别： 免费（适用于所有级别）

无需设置。 博客搜索 使用WordPress REST API自动搜索互联网上25个以上流量最高的美食博客。只需正常搜索，Skinnytaste、Pinch of Yum、Half Baked Harvest、Budget Bytes和20多个博客的结果就会与您的其他来源一起显示出来。

这 Web配方 适配器允许您粘贴 任何配方URL 从任何食品博客中，食谱mcp都会自动提取完整的结构化食谱。与数千个网站合作，包括AllRecipes、Serious Eats、Simply Recipes，Bon Appetit，Epicurious，Food Network，King Arthur Baking等。

例子： *“从获取食谱https://www.budgetbytes.com/slow-cooker-chili/"*

Instagram食谱（专业版）

所需级别： 专业版

使用Instagram的两种方式：

1. 关注厨师账户 --建立你自己的食物创造者名单，浏览他们的食谱帖子：

- *“在Instagram上关注@halfbakedharvest”* - *“显示我关注的Instagram帐户”* - *“浏览来自halfbakedharvest的食谱”*

1. 从任何帖子中摘录 --粘贴任何Instagram帖子URL，并从标题中获得结构化、可烹饪的食谱：

- *“从获取食谱https://www.instagram.com/p/ABC123/"*

不再试图阅读小标题或观看10分钟的食谱视频。

检查你的来源

要查看哪些源已配置并准备就绪：

• 在克劳德： *“显示我的食谱来源”*
• CLI： recipe-mcp sources

______________________________________________________________________

所有32个MCP工具

免费工具（8个工具-适用于所有级别）

Plus工具（7个工具-需要Plus或Pro许可证）

专业工具（17个工具-需要专业许可证）

______________________________________________________________________

饮食适应是如何起作用的

大多数食谱工具只是扔掉不符合你饮食的食谱。 配方mcp更聪明。 它通过智能替换来调整食谱：

示例：制作不含乳制品的食谱

示例：制作犹太洁食食谱

如果食谱中有肉类和乳制品（如鸡肉帕尔马干酪配奶酪）：

• 肉留了下来
• 奶酪→ 纯素奶酪或营养酵母
• 黄油→ 橄榄油
• 奶油汁→ 椰子奶油酱
• Pork → 建议的替代品（菠萝蜜、西坦）
• 贝类→ 棕榈心、王氏香菇

每次替换都包含替代选项，因此您可以选择适合自己的选项。

______________________________________________________________________

CLI参考

# Search
recipe-mcp search "chicken tikka"
recipe-mcp search "tacos" --source themealdb

# Get a recipe
recipe-mcp recipe 
recipe-mcp recipe "https://www.seriouseats.com/the-best-slow-cooked-bolognese-sauce-recipe"

# Random inspiration
recipe-mcp random
recipe-mcp random --source thecocktaildb

# See your sources
recipe-mcp sources

# Favorites (requires Plus+)
recipe-mcp favorites
recipe-mcp save  --source themealdb

# NYT Cooking (requires Plus+ and NYT subscription)
recipe-mcp collections

# Configure API keys
recipe-mcp configure spoonacular
recipe-mcp configure edamam
recipe-mcp configure tasty
recipe-mcp configure nyt

# License management
recipe-mcp license status
recipe-mcp license activate RMCP-XXXX-XXXX-XXXX

______________________________________________________________________

对于开发者

程序化API

import {
  searchAll,
  getRecipeFrom,
  getAllAdapters,
  adaptRecipe,
  scaleRecipe,
  convertUnits,
  createTimeline,
  searchByIngredients,
  generateMealPlan,
  generateGroceryList,
} from 'recipe-mcp';

// Search across all sources
const results = await searchAll('pasta carbonara');

// Get a recipe from any URL
const recipe = await getRecipeFrom('https://www.budgetbytes.com/slow-cooker-chili/');

// Adapt for dietary needs
const veganVersion = adaptRecipe(recipe, ['vegan', 'gluten-free']);

// Scale for a bigger group
const doubled = scaleRecipe(recipe, 2);

// Convert to metric
const metric = convertUnits(recipe, 'metric');

构建自己的适配器

import { RecipeAdapter, Capabilities, registerAdapter } from 'recipe-mcp';

class MyAdapter extends RecipeAdapter {
  get key() { return 'mysite'; }
  get name() { return 'My Recipe Site'; }
  get capabilities() {
    return new Set([Capabilities.SEARCH, Capabilities.GET_RECIPE]);
  }

  async search(query, opts) { /* your search logic */ }
  async getRecipe(id) { /* your fetch logic */ }
}

registerAdapter(new MyAdapter());

______________________________________________________________________

建筑

src/
  core/           # Adapter interface, registry, config, license, favorites, history, pantry, types
  adapters/       # 12 source adapters (TheMealDB, NYT, Spoonacular, blogs, Instagram, etc.)
  mcp/            # MCP server (JSON-RPC 2.0 over stdio) — 33 tools
  cli/            # Command-line interface
  premium/        # Dietary adaptation, scaling, cook mode, substitutions, export, sharing, seasonal, nutrition

零依赖。 仅内置Node.js。安装速度快，无供应链风险。

______________________________________________________________________

故障排除

“找不到命令：配方mcp”

• 确保你跑了 npm install -g recipe-mcp
• 尝试关闭并重新打开终端

克劳德没有展示食谱工具

• 请确保在编辑配置后重新启动了Claude Desktop
• 检查配置JSON是否有效（没有尾随逗号）

“未找到食谱”

• 尝试更简单的搜索查询
• 检查 recipe-mcp sources 查看哪些来源可用

Spoonacula/Edamam不工作

• 跑 recipe-mcp configure 并输入您的API密钥
• 检查您的免费套餐当天的请求是否没有用完

______________________________________________________________________

演示

运行一个完整的交互式演示，演示每个主要功能：

node demo.js              # Interactive — press Enter between steps
node demo.js --fast       # Auto-advance with 2s pauses
node demo.js --instant    # No pauses, just output

非常适合屏幕录制产品演示视频。

______________________________________________________________________

政策

• 服务条款
• 退款政策 --所有付费计划14天退款保证

______________________________________________________________________

Bug报告和功能请求

发现bug还是有想法？

• 程序错误 → 打开错误报告
• 特色创意？ → 请求功能
• 问题？ → 开始讨论

______________________________________________________________________

许可证

麻省理工学院