# Tandoor MCP Server

A FastMCP server for interacting with [Tandoor Recipe Manager](https://tandoor.dev/) via the Model Context Protocol.

## Features

- **Recipe Management**: Search, view, create, and import recipes from URLs
- **Cooking History**: Track what you've cooked with ratings and notes
- **Recipe Suggestions**: Get recipe ideas based on pantry inventory
- **Meal Planning**: Plan meals with bulk scheduling support
- **Shopping Lists**: Manage shopping with bulk add/remove/check operations
- **Pantry Tracking**: Track on-hand ingredients for smarter suggestions
- **Lookups**: Search keywords, foods, and units

## Tools (4 Consolidated Tools)

### `tandoor_recipes`
| Operation | Description | Bulk Support |
|-----------|-------------|--------------|
| `list` | Search recipes by name, keywords, foods, or rating | - |
| `get` | Get full recipe with ingredients and instructions | - |
| `create` | Create a new recipe | - |
| `import` | Import recipe from URL | `urls` list |
| `history` | Get cooking history with date filtering | - |
| `log` | Log a cooked recipe with rating/notes | `logs` list |
| `suggest` | Get recipe suggestions based on pantry | - |

### `tandoor_meal_plan`
| Operation | Description | Bulk Support |
|-----------|-------------|--------------|
| `types` | List available meal types | - |
| `list` | Get meal plan entries with date filtering | - |
| `create` | Add recipe to meal plan | `meals` list |
| `create_type` | Create a new meal type | - |
| `delete` | Delete a meal plan entry | `meal_plan_ids` list |

### `tandoor_shopping_list`
| Operation | Description | Bulk Support |
|-----------|-------------|--------------|
| `list` | Get shopping list items | - |
| `add` | Add item to shopping list | `add_items` list |
| `update` | Update a shopping list item | - |
| `remove` | Remove item from shopping list | `item_ids` list |
| `check` | Check/uncheck items | `item_ids` or `items` list |
| `clear` | Clear checked items and sync to pantry | - |

### `tandoor_lookup`
| Type | Description | Bulk Support |
|------|-------------|--------------|
| `keywords` | Search recipe keywords/tags | - |
| `foods` | Search foods/ingredients | - |
| `units` | Search measurement units | - |
| `pantry` | View/update pantry inventory | `pantry_items` list |

## Bulk Operations Examples

### Plan a week of meals
```python
tandoor_meal_plan(
    operation="create",
    meals=[
        {"recipe": "Pasta Carbonara", "date": "2025-01-27", "meal_type": 3, "servings": 4},
        {"recipe": "Chicken Curry", "date": "2025-01-28", "meal_type": 3, "servings": 4},
        {"recipe": "Beef Tacos", "date": "2025-01-29", "meal_type": 3, "servings": 4},
    ]
)
```

### Add multiple items to shopping list
```python
tandoor_shopping_list(
    operation="add",
    add_items=[
        {"food": "Milk", "amount": 1, "unit": "gallon"},
        {"food": "Eggs", "amount": 12},
        {"food": "Bread", "amount": 1, "unit": "loaf"},
    ]
)
```

### Update pantry inventory
```python
tandoor_lookup(
    type="pantry",
    action="update",
    pantry_items=[
        {"food_name": "salt", "on_hand": True},
        {"food_name": "pepper", "on_hand": True},
        {"food_id": 123, "on_hand": False},
    ]
)
```

### Log multiple cooked recipes
```python
tandoor_recipes(
    operation="log",
    logs=[
        {"recipe_id": "45", "servings": 4, "rating": 5, "comment": "Perfect!"},
        {"recipe_id": "32", "servings": 2, "rating": 4},
    ]
)
```

## Configuration

Set the following environment variables:

| Variable | Description |
|----------|-------------|
| `TANDOOR_URL` | Tandoor instance URL (default: `http://web_recipes`) |
| `TANDOOR_PUBLIC_URL` | Public URL for recipe links (optional) |
| `TANDOOR_API_TOKEN` | API token from Tandoor settings |

## Running with Docker

```yaml
services:
  mcp_server:
    build: .
    environment:
      - TANDOOR_URL=http://your-tandoor-instance
      - TANDOOR_PUBLIC_URL=https://recipes.example.com
      - TANDOOR_API_TOKEN=your_token_here
    ports:
      - "8089:8000"
```

## Running Locally

```bash
pip install -r requirements.txt
export TANDOOR_URL=http://localhost:8081
export TANDOOR_API_TOKEN=your_token_here
python server.py
```

## MCP Client Configuration

```json
{
  "mcpServers": {
    "tandoor": {
      "url": "http://localhost:8089/mcp/"
    }
  }
}
```

## License

MIT