mcp-pequerecetas 是一个 MCP（Model Context Protocol）服务器，用于将聊天客户端连接到西班牙家庭烹饪网站 Pequerecetas。Pequerecetas 收录了数千道菜谱，包含食材、步骤和照片，并按适合的饮食、烹饪厨具、制作场合以及食用者年龄（从六个月起）进行分类。
用途
该服务器让用户通过聊天客户端搜索和阅读 Pequerecetas 上的菜谱，并按用餐人数重新缩放食材用量。它还可以列出网站用于浏览菜谱的各个分类法的取值，逐页浏览某个分类法下的菜谱，以及缩放用户已有的西班牙语食材清单。它不需要 API 密钥，也不需要账户。
主要能力
- 搜索菜谱：按菜品或食材搜索，返回带有 id、标题、URL 和图片链接的行。
- 读取菜谱：根据 id 读取一页菜谱，并在给出用餐人数时重新缩放食材用量。返回内容包括 kind（recipe 或 collection）、source_shape、标题、URL、描述、发布时间、修改时间、准备/烹饪/总分钟数、分类、菜系、关键词、作者、评分、营养信息和图片等。食材行带有 scaling（scaled、rounded 或 unscaled）和 is_equipment 标记。
- 列出分类法取值：读取 dieta、edad、ingrediente、ocasion、recetas-de、tecnica、tipo-de-cocina 和 tipo-plato 八个分类法，返回每个分类法的名称、取值数量和取值列表。
- 浏览分类法：逐页读取某个分类法下的菜谱，返回与搜索相同形状的行，并带有 page_served 和 has_more。
- 缩放食材清单：对西班牙语食材行列表进行缩放，可指定 factor，或同时指定 from_servings 和 to_servings。返回每行的 text、original、amount、amount_max、unit 和 scaling，以及 scaled_count、rounded_count 和 unscaled_count。不进行单位制转换，近似度量（如 pizca）保持厨师给出的量。
使用方式
- 一键安装：适用于 Claude Desktop、Cursor 及任何使用标准配置格式的客户端。需要 Node 24 或更高版本，无需设置环境变量。命令中使用 -i 保持 stdin 打开，不使用 -t。容器需要出站 HTTPS 访问 www.pequerecetas.com，无需卷、端口或凭据。
- Bundle 安装（无需 npm）：从最新发布下载 mcp-pequerecetas-1.1.0.mcpb 并打开，支持 MCP bundle 的客户端会自动安装，无需 npm 或编辑配置文件。bundle 自带依赖，安装时不下载任何内容。
- 作为库使用：读取层可单独发布，带有自己的节奏、缓存和错误词汇，不附带协议。loadConfig 和 createLogger 来自同一入口点。每次读取返回 { data, cached }。
适用场景
- 用西班牙语搜索菜谱，例如“Búscame una receta de paella de marisco.”
- 按人数读取菜谱，例如“Read me that recipe for eight people.”
- 按厨具浏览，例如“What can I cook in an air fryer on this site?”
- 按年龄浏览，例如“Show me the purées it files under six months.”
- 缩放已有的西班牙语食材清单，例如“Scale this Spanish ingredient list by three.”
限制
- Pequerecetas 使用西班牙语编写，搜索匹配页面原文，因此菜谱需用西班牙语查找。
- 搜索只提供单页结果，请求第二页会返回第一页，total_available 始终为 null。
- 分类法不能组合使用，网站不提供同时请求两个分类法的方式。
- 分类法的 slug 由网站生成，手工构建的 slug 可能返回 not_found。
- 请求间隔下限为 3000 毫秒，低于该值会被拒绝并使用默认值，该信息会输出到 stderr。
- 不进行单位制转换。
- 该服务器与 Pequerecetas 无关联。
- 不收集任何数据，只读取 www.pequerecetas.com，默认在内存中缓存十五分钟，不写入磁盘，诊断信息发送到 stderr。
- 许可证为 MIT。
