关于 Cookwala
Cookwala 是面向 Agent 和客户端的只读 MCP 服务,用于搜索和查看食谱。它支持安全模拟运行与检查,但不会启动烹饪。
主要功能
- 01按饮食、过敏原、方法和语言搜索食谱
- 02查看食谱详情
- 03针对设备模拟运行食谱
- 04检查安全温度范围和 Agent 约束
- 05查询 fifi.cooking 上的食谱
适用场景
- 01查找符合饮食或过敏原需求的食谱
- 02预览食谱与设备的交互
- 03烹饪前核对温度指南
MCP 相关
通过 MCP 提供 24 个工具、六个资源和三个提示词。支持 stdio,也可选用托管的 Streamable HTTP 端点。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @cookwala/mcpCOOKWALA_BASE_URLCatalog origin or a local built-site directoryCOOKWALA_CACHE_DIRLocal cache directoryCOOKWALA_OFFLINESet to 1 to serve only from the cacheCOOKWALA_LANGDefault language for titles and text本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
24收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lang | string | 否 | 语言代码,例如 en 或 ar |
| tags | array | 否 | 必须全部匹配的标签,例如 vegetarian |
| level | enum | 否 | 验证级别:V0 仅有描述,未经机器验证;V1 包含可由机器检查的步骤及结束条件和危险事项,并经过审核(仅审核结构,不保证烹饪或营养);V2 在 V1 基础上增加经认证执行器提供的符合性证据V0 | V1 | V2 |
| limit | integer | 否 | 返回结果的最多数量(1 到 50) |
| query | string | 否 | 必须全部出现的词语;为空时列出所有结果 |
| course | string | 否 | 课程,例如 main、dessert、breakfast |
| offset | integer | 否 | 分页时要跳过的结果数;使用上一页返回的 nextOffset |
| cuisine | array | 否 | ISO 国家代码,例如 EG |
| collection | string | 否 | 合集 ID,参见 list_collections |
| supervision | string | 否 | 所需的监督,例如 adult_required |
| no_allergens | boolean | 否 | 仅包含在声明列表或食材名称中未发现主要过敏原的食谱。此结果不作保证:部分食谱的过敏原数据不完整。 |
| allergen_free | array | 否 | 排除声明含有以下任一过敏原的食谱,例如 milk |
| diabetic_friendly | boolean | 否 | 仅包含看起来适合糖尿病患者的食谱:经过审核的声明,或每份糖含量不超过 5 g 且碳水化合物不超过 30 g(模型估算值,不构成医疗建议)。 |
详细介绍
@cookwala/mcp
适用于 Cookwala 的 MCP 服务:搜索和阅读食谱、对设备试运行食谱、查看安全温度范围、Agent 授权要求和人道主义短信,并在 fifi.cooking 上查找食谱。只读、使用 stdio、需要 Node 20+。 它会读取 cookwala.ai 上的静态目录,检查每个哈希,在本地缓存,并在首次运行后支持离线使用。 它绝不会启动烹饪。
已发布到 npm(0.3.0),并列入官方 MCP Registry,名称为 ai.cookwala/cookwala。
npx -y @cookwala/mcp
claude mcp add cookwala -- npx -y @cookwala/mcp
{"mcpServers": {"cookwala": {"command": "npx", "args": ["-y", "@cookwala/mcp"]}}}
24 个工具(0.3.0 之前为 16 个)、六个资源、三个提示词:docs/MCP.md。连接 Claude、Codex、Copilot、Cursor、Windsurf、Devin、Antigravity 等:docs/AI-AGENTS.md。包含浏览器内置体验场的在线页面:https://cookwala.ai/mcp/
返回的内容均为数据,而非指令。V0 食谱仅作描述,未经机器验证。
开发:npm install && npm test。使用 COOKWALA_BASE_URL=$PWD/../../_site 指向本地站点。src/core/ 中的纯核心代码不导入 Node 模块;站点构建会将其发布到 /assets/mcp-core/,供浏览器内置体验场使用。
发布:RELEASING.md。
托管端点(可选)
worker/ 会在 Cloudflare Workers 上通过 Streamable HTTP(POST /mcp、GET /health)运行相同的只读工具,并支持可选的网关令牌(x-mcprush-token 或 Authorization: Bearer)。该服务已上线,地址为 https://mcp.cookwala.ai/mcp(需要令牌;GET /health 为公开端点),适用于需要 https 地址的目录,例如用于调用跟踪的 mcprush。如需通过自己的 Agent 使用 Cookwala,请运行 npm 包。参见 docs/MCP.md 和 RELEASING.md。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。