Cookidoo for Thermomix (unofficial)

Cookidoo MCP 服务 – 使用 Thermomix 食谱、膳食规划与引导式烹饪，搭配 Claude

让 AI 助手为你打理 Thermomix 厨房。 只需向 Claude（或其他 MCP 客户端）提出要求，即可将任何食谱创意或网页食谱变成可用于引导式烹饪的 Cookidoo 食谱、在 Cookidoo 目录中找到合适的菜肴、规划一周菜单并填写购物清单。

“把我最喜欢的美食博客上的这道咖喱改成适用于 TM6 的 Thermomix 食谱。”

“找三道 30 分钟内能完成的素食晚餐，安排在周一到周三，并把食材加到我的购物清单里。”

“为我的面包食谱补上缺失的 Thermomix 设置，并用揉面模式揉面。”

你会喜欢它的原因：

• 食谱自动烹饪。 上传的食谱不只是文本：每个步骤都带有实际的 Thermomix 设置。点击步骤，Thermomix 就会设置正确的时间、温度和速度。还支持 Varoma、反转和柔和搅拌。
• Cookidoo 支持的所有模式。 揉面、涡轮、搅拌、加热和煮饭；TM7 还支持蒸煮和煎炒。服务会实时读取 Cookidoo 提供的模式，因此 Cookidoo 新增模式时也能跟上。
• 食材会像在官方编辑器中一样关联。 步骤中的食材会变成链接，就像你亲自在 Cookidoo 编辑器中制作食谱一样。无需在 Cookidoo 中手动编辑。
• 从灵感到晚餐计划。 搜索整个 Cookidoo 目录和你自己的食谱，将它们安排到 Meine Woche，并将食材发送到 Cookidoo 购物清单。
• 上传前先检查。 每份食谱都会按照 Cookidoo 编辑器使用的相同规则进行检查。遇到无效的温度、速度或模式时，系统会说明原因，而不是让上传失败。
• 专为 TM6 和 TM7 打造。 每份食谱都针对你的设备制作，只使用设备支持的功能。

免责声明： 这是一个非官方项目。开发者与 Cookidoo、Vorwerk、Thermomix 或其任何子公司或商标均无关联，也未获得其认可或与其存在联系。

德语版：使用 AI 创建 Thermomix 食谱并规划一周菜单

借助此 MCP 服务，你的 AI 助手（例如 Claude）可以根据创意、网上的食谱或家庭食谱，直接在 Cookidoo 中创建自己的 Thermomix 食谱。食谱会保存到“Meine Rezepte”，并支持引导式烹饪：

• **设置：**时间、温度、档位、反转和 Varoma 均已设置。
• **模式：**揉面、涡轮、搅拌、加热和煮饭；TM7 还支持蒸煮和煎炒。
• **食材：**食材会像在 Cookidoo 编辑器中一样，在步骤中建立链接。

无需在编辑器中进行后续修改。

此外，助手还可以：

• **搜索：**在 Cookidoo 目录和你自己的创作中查找食谱。
• **规划：**将食谱添加到 Cookidoo 周计划（“Meine Woche”）中。
• **购物：**将食材添加到 Cookidoo 购物清单。

它适用于 Thermomix TM6 和 TM7。下方介绍了设置方法（英文）。 你也可以让它用德语编写食谱。

功能介绍

创建自己的食谱

功能	功能说明
上传自己的食谱	在 Cookidoo 的“My recipes”（Meine Rezepte）中创建新食谱，适用于 TM6 或 TM7。
Thermomix 设置（引导烹饪）	步骤中如 3 Min./120°C/Stufe 1 这样的设置会转换为实际的 Thermomix 设置。点击步骤即可设置 Thermomix。支持时间、温度、Varoma、转速、反转（Linkslauf）和轻柔搅拌（Sanftrührstufe）。
Thermomix 模式	揉面、涡轮、搅拌、加热和电饭煲模式；TM7 还支持蒸煮和煎炒（Teig kneten/2 Min., Turbo/1 Sek. 等），实时从 Cookidoo 读取。
食材链接	如果某个步骤中的食材行与食材列表中的内容完全一致，就会显示为链接，就像使用 Cookidoo 编辑器制作的食谱一样。
上传前检查	验证食谱，并显示检测到的设置、模式和食材链接；对于不符合要求的内容，会清楚说明原因。
修正已上传的食谱	替换已上传食谱的步骤，例如稍后添加 Thermomix 设置。食材、时间和提示保持不变。

查找、规划和购物

功能	功能说明
查找食谱	搜索 Cookidoo 目录（可按排除的食材、最长时间或设备等条件筛选），并列出自己的食谱。
查看食谱	显示目录食谱或自有食谱的食材、步骤和时间。
规划一周	显示 Cookidoo 周计划（Meine Woche），将目录食谱或自有食谱安排到某一天，并可移除。
购物清单	将食谱的食材添加到 Cookidoo 购物清单。

设置

你需要一个 Cookidoo 账号（需有有效订阅，才能创建自己的食谱） 以及 uv，它会为你安装 Python 和服务。无需下载此项目。

Claude Desktop

打开 Settings → Developer → Edit Config，并将服务添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "cookidoo": {
      "command": "uvx",
      "args": ["mcp-cookidoo"],
      "env": {
        "COOKIDOO_EMAIL": "[email protected]",
        "COOKIDOO_PASSWORD": "your-password-here"
      }
    }
  }
}

重启 Claude Desktop。Cookidoo 工具现在会显示在工具列表中。

Claude Code

claude mcp add cookidoo -e [email protected] -e COOKIDOO_PASSWORD=your-password-here -- uvx mcp-cookidoo

其他国家/地区

此服务默认使用德国 Cookidoo。若要使用其他国家/地区的版本，可在 env 中添加，例如 "COOKIDOO_COUNTRY": "fr" 和 "COOKIDOO_LANGUAGE": "fr-FR"。步骤中的 Thermomix 设置 始终使用德语格式（见下文）。

从源代码检出目录运行

用于开发，或在你不想使用 uvx 时：

git clone https://github.com/tobilektri/mcp-cookidoo.git
cd mcp-cookidoo
python -m venv venv
source venv/bin/activate        # Windows: .\venv\Scripts\Activate.ps1
pip install -e ".[dev]"
cp .env.example .env            # then enter your Cookidoo login in .env

在 MCP 客户端中，使用命令 /path/to/mcp-cookidoo/venv/bin/mcp-cookidoo（Windows： C:\\path\\to\\mcp-cookidoo\\venv\\Scripts\\mcp-cookidoo.exe）代替 uvx。.env 文件 保留在你的电脑上，并且已从 git 中排除。在项目文件夹中运行 fastmcp run server.py 也可以启动服务。

使用方法

将下面的示例提示词复制到助手中，并替换第一行的菜品名称。它包含助手正确处理 Thermomix 设置和食材链接所需的全部信息。 你可以使用任意语言编写；最后一条规则决定食谱的语言。

Create a Thermomix recipe for [DISH, e.g. "vegetable curry for 4 people"] and save it to my
Cookidoo account with the Cookidoo tools.

Rules for the recipe:
- Ingredients: one per line, short and without preparation notes ("1 Zwiebel", not
  "1 Zwiebel, halbiert"). Notes like "halbiert" go into the step.
- Every ingredient must appear in a step exactly as written in the ingredient list, word for
  word, so that it is linked. Write "1 Zwiebel in den Mixtopf geben", not "die Zwiebel".
- Write each Thermomix setting in Cookidoo notation as time/temperature/speed, in German, e.g.
  "5 Sek./Stufe 5", "3 Min./120°C/Stufe 1", "15 Min./100°C/Linkslauf/Stufe 1" or
  "12 Min./100°C/Linkslauf/Sanftrührstufe".
- Use Thermomix modes (dough, turbo, blend, ...) where they fit, written exactly as
  get_thermomix_modes shows them, e.g. "Teig kneten/2 Min." or "Turbo/1 Sek.".
- Use only one Thermomix setting or mode per step; split longer processes into several steps.
- The recipe is for my [TM6 / TM7].
- Write the recipe in German.

Process:
1. Connect with connect_to_cookidoo.
2. Call get_thermomix_modes for my device and use only the modes and values it lists.
3. Check the recipe with generate_recipe_structure (with my device). If the output lists
   warnings, unlinked ingredients or unrecognised settings, fix the steps and check again until
   everything is linked.
4. Show me the recipe and wait for my OK.
5. Upload it with upload_custom_recipe and give me the recipe ID and link.

然后，助手会依次使用以下工具：

1. connect_to_cookidoo 登录。
2. get_thermomix_modes 列出 Cookidoo 为该设备提供的模式及其写法。
3. generate_recipe_structure 检查食谱，并报告检测到的设置、模式和链接。
4. upload_custom_recipe 将食谱保存到你的账号，并返回食谱 ID 和链接。

规划一周

你也可以让助手查找食谱并进行规划，例如：

Connect to Cookidoo. Find three quick vegetarian dinners (at most 30 minutes, for my TM6)
in the Cookidoo catalogue or among my own recipes, show them to me and, after my OK, plan
them for Monday to Wednesday next week and put their ingredients on my shopping list.

助手使用 search_recipes 和 list_my_recipes 查找食谱，使用 get_recipe_details 查看食谱，并使用 plan_recipe、get_week_plan 和 add_to_shopping_list 进行规划和购物。

所有工具

工具	用途
connect_to_cookidoo	登录。请先调用此工具。
get_thermomix_modes(device="TM6")	列出 Cookidoo 目前为 TM6 或 TM7 提供的模式，以及其拼写和允许值。
search_recipes(query, ingredients, exclude_ingredients, max_total_time, difficulty, portions, device, limit, page)	搜索 Cookidoo 目录。所有筛选条件均为可选项；Cookidoo 每页最多返回 20 条结果。
list_my_recipes()	列出你自己的食谱，包含 ID、设备和时间。
get_recipe_details(recipe_id)	显示目录食谱（r59322）或你自己的食谱（01M5…）的食材、步骤和时间。自创食谱的步骤会以 update_custom_recipe_steps 接受的格式显示。
get_week_plan(day="")	显示从 day 开始这一周（YYYY-MM-DD，默认为今天）的计划食谱。
plan_recipe(day, recipe_ids)	在某一天计划一道或多道食谱（以逗号分隔，可混合目录食谱和自创食谱）。
unplan_recipe(day, recipe_id)	从周计划中的某一天移除一道食谱。
add_to_shopping_list(recipe_ids)	将食谱所需的食材添加到 Cookidoo 购物清单。
generate_recipe_structure(name, ingredients, steps, servings, prep_time, total_time, hints, device="TM6")	验证食谱，并预览检测到的设置、模式和链接。
upload_custom_recipe(recipe_json)	在 Cookidoo 上创建食谱（传入 generate_recipe_structure 返回的 JSON）。
update_custom_recipe_steps(recipe_id, steps, ingredients="")	替换你某个食谱的全部步骤。设备信息取自该食谱。不传入 ingredients 时，会从 Cookidoo 加载当前食材清单。

你不必调用 get_thermomix_modes，检查功能也能正常工作：检查、上传和更新时，都会在生成步骤前直接从 Cookidoo 读取模式。如果未连接，generate_recipe_structure 会使用内置列表，并说明这一点。

食材、步骤和提示均按每行一项传入。步骤开头的 1. 或 - 等列表标记会被移除。

编写 Thermomix 设置

请按照 Cookidoo 的显示方式，将设置写入步骤文本，格式为 time/temperature/speed：

步骤中的写法	含义
4 Sek./Stufe 5	4 秒，速度 5
3 Min./120°C/Stufe 1	3 分钟，120 °C，速度 1
1 Min. 30 Sek./90°C/Stufe 2	1 分 30 秒，90 °C，速度 2
15 Min./100°C/Linkslauf/Stufe 1	反转（逆时针）
12 Min./100°C/Linkslauf/Sanftrührstufe	反转并柔和搅拌（Stufe Sanftrühren 也有效）
20 Min./Varoma/Stufe 1	Varoma 温度（仅限 TM6）
10 Sek./Stufe 0,5	速度 0.5

步骤示例：

1 Zwiebel in den Mixtopf geben und 5 Sek./Stufe 5 zerkleinern.

规则（与 Cookidoo 编辑器应用的规则相同）：

• 速度可设为 0.5 至 10，以 0.5 为步进；也可使用柔和搅拌。温度为可选项，可选 Thermomix 温度档位为 37 至 120 °C（37、40、45……95、98、100、105、110、115、120）。
• 加热时，速度最高为 6。
• 时间最多为 5 分钟时，以 10 秒为步进；最多为 20 分钟时，以半分钟为步进；之后以整分钟为步进，最长为 99 分钟。其他时间也会被采用，但工具输出会发出警告。
• 无论食谱其余部分使用何种语言，均使用德语记法（Min.、Sek.、Stufe、Linkslauf）。
• 无效值（例如 Stufe 12 或 42°C）会保留为普通文本，工具输出会说明原因。
• **暂不支持：**华氏度。

Thermomix 模式

按 Cookidoo 显示的名称写出模式，然后写出其值，并用 / 分隔：

步骤中的写法	模式	设备	允许的值
Teig kneten/2 Min.	dough（也称 Teigstufe、Teigmodus）	TM6、TM7	1 秒至 20 分钟
Turbo/1 Sek.	turbo	TM6、TM7	0.5、1 或 2 秒
Turbo/1 Sek./3x	带脉冲的 turbo	TM7	1 至 9 次脉冲
Pürieren/1 Min./Stufe 8	blend	TM6、TM7	10 秒至 5 分钟，速度 6 至 8
Erwärmen/65°C/Stufe 1	warm up	TM6、TM7	37 至 90 °C，轻柔搅拌（默认）、速度 1 或 2
[Reis kochen]	rice cooker	TM6、TM7	无（方括号表示这是一个模式）
Dampfgaren/20 Min./Stufe 1/im Varoma	steaming	TM7	最长 99 分钟，轻柔搅拌至速度 5，可选 Linkslauf、im Varoma（默认）、im Gareinsatz 或 in beidem
Anbraten/10 Min./160°C/Leicht	browning	TM7	140 至 160 °C，最长 30 分钟（默认 10 分钟），Leicht（默认）或 Intensiv

食谱中的步骤随后会按照 Cookidoo 的方式显示模式（名称、模式图标和时间，例如 “Teig kneten”及揉面图标、“2 Min.”）；点按后即可在 Thermomix 上启动该模式。

以上列表截至 2026 年 10 月。服务会从 Cookidoo 读取当前列表 （get_thermomix_modes）：Cookidoo 不再提供的模式将不再使用；新模式则会标记为“暂不支持”，直到服务了解其取值。

食材链接

当食材列表中的某一行在步骤中逐字出现时，该食材即已链接。

食材列表	步骤	已链接？
1 Zwiebel	1 Zwiebel und 1 Knoblauchzehe in den Mixtopf geben	是
1 Zwiebel	Die Zwiebel in den Mixtopf geben	否

较短的食材行（1 Zwiebel，而不是 1 Zwiebel, halbiert）能让步骤更易阅读。 工具输出会列出哪些食材已链接，哪些未链接。

与 Cookidoo 编辑器一样，服务会在食材和步骤中将 ; 替换为全角分号（；）。

修复已上传的食谱

忘记设置了，或者缺少链接？将食谱 ID（可从上传输出或 Cookidoo 食谱 URL 中获取）以及完整的新步骤列表传入 update_custom_recipe_steps。该操作会替换所有步骤，而其他内容保持不变。

开发

代码位于 mcp_cookidoo 包中。在源代码检出目录中（见上文）运行以下命令，以测试设置、模式、链接和食谱辅助工具：

pytest

fixtures/ 中的文件包含 Cookidoo 编辑器的设置对话框（TM6 和 TM7），以及编辑器本身生成的步骤；测试会检查服务构建的内容是否完全一致。

格式化和 lint 检查：

black .
ruff check .

发布

1. 在 pyproject.toml、mcp_cookidoo/__init__.py、fastmcp.json 和 server.json（两处）中设置新版本。
2. 提交，然后创建标签并推送：git tag v1.0.1 && git push origin v1.0.1。

GitHub Actions 工作流 publish.yml 会运行测试，将包发布到 PyPI，并将服务发布到 MCP Registry。

致谢

本项目最初是 alexandrepa/mcp-cookidoo 的一个分支。该项目由 Alexandre Patelli 创建，他构建了该服务的第一个版本（登录、食谱结构和上传）。在此致谢！

本项目基于 cookidoo-api 构建，该项目提供了用于访问 Cookidoo 平台的 Python 接口。特别感谢其作者让这项集成成为可能！

许可证

MIT，详见 LICENSE。