AI导哈

食谱与膳食计划管理服务

一个MCP服务器，用于通过标准Model Context Protocol让AI助手管理和操作Tandoor中的食谱、膳食计划与购物清单，实现餐饮数据的自动化和集成管理。

  • by mc-mario
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 mc-mario/tandoor-mcp

使用说明

Tandoor MCP Server

Model Context Protocol (MCP) server for Tandoor recipe and meal plan management.

Note: This project was partially developed with the assistance of Large Language Models (LLMs).

Features

  • Recipe Management - List, get, create, update, and delete recipes
  • Meal Planning - Create, manage, and auto-generate meal plans
  • Shopping List - Read the current shopping list
  • Reference Data - List foods, units, and keywords (find IDs before creating)
  • Auto-creation - Automatically creates missing ingredients, units, and keywords
  • Auto-pagination - All list tools fetch every page (Tandoor defaults to 25 items/page, which silently truncates larger collections)
  • Compact output - Recipe/meal-plan responses are summarized instead of dumping raw nested JSON, keeping token usage low

Installation

npm install -g tandoor-mcp

Or use with npx:

npx tandoor-mcp

Configuration

  1. Get your API token from Tandoor:

    • Settings → API Tokens → Create new token

  2. Configure MCP client (e.g., Claude Desktop):

{
  "mcpServers": {
    "tandoor": {
      "command": "npx",
      "args": ["tandoor-mcp"],
      "env": {
        "TANDOOR_URL": "https://your-tandoor-instance.com",
        "TANDOOR_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Recipe Tools

  • list_recipes - List ALL recipes (auto-paginated). Filters: query, keywords (IDs), rating_gte, sort_order. Returns compact rows (id, name, keywords, servings)
  • get_recipe - Get recipe details as a compact summary (steps with ingredients as text lines)
  • create_recipe - Add new recipes. Food/unit/keyword names are auto-resolved to existing records when possible (normalized matching incl. Spanish singular/plural variants). Response reports any new records created so the caller can spot duplicates. Recipes are created visible in the UI (internal: false)
  • update_recipe - Update metadata and/or content. Providing steps replaces the whole steps array — include every step
  • delete_recipe - Permanently delete a recipe
  • list_foods - List foods (optional query filter) — use before creating recipes to reuse existing foods
  • list_units - List units (optional query filter)
  • list_keywords - List keywords (optional query filter) — use to find keyword IDs

Meal Planning Tools

  • list_meal_plans - View scheduled meals (auto-paginated). With a date window, only entries starting inside the window are returned (Tandoor's API also returns overlapping entries from other weeks, which are filtered out)
  • get_meal_plan - Get meal plan details
  • create_meal_plan - Schedule a recipe (addshopping: true adds ingredients to the shopping list)
  • update_meal_plan - Update meal plans
  • delete_meal_plan - Remove meal plans
  • auto_meal_plan - Auto-generate meal plans by keywords
  • list_meal_types - List meal types (breakfast, lunch, etc.)
  • get_shopping_list - Current shopping list entries (id, food, amount, unit, checked)

Testing

End-to-end tests exercise every tool against a real Tandoor instance, create a temporary recipe + meal plan, and assert the database is left untouched (food/unit/keyword counts unchanged):

npm run build
TANDOOR_URL=https://your-tandoor-instance.com TANDOOR_TOKEN=your-token node test/e2e.mjs

Development

git clone https://github.com/mc-mario/tandoor-mcp.git
cd tandoor-mcp
npm install
npm run build

License

MIT

相关 MCP