Tandoor MCP Server
A FastMCP server for interacting with Tandoor Recipe Manager via the Model Context Protocol.
Features
- Recipe Management: Search, view details, and create recipes
- Meal Planning: View and create meal plan entries
- Shopping Lists: View, add, update, and remove shopping list items
- Lookups: Search keywords, foods, and units
Tools
| Tool | Description |
|---|---|
get_recipes | Search recipes by name, keywords, foods, or rating |
get_recipe_details | Get full recipe with ingredients and instructions |
create_recipe | Create a new recipe |
get_meal_types | List available meal types |
get_meal_plans | Get meal plan entries |
create_meal_plan | Add a recipe to the meal plan |
get_shopping_list | Get shopping list items |
add_shopping_list_item | Add item to shopping list |
update_shopping_list_item | Update a shopping list item |
remove_shopping_list_item | Remove item from shopping list |
get_keywords | Search recipe keywords/tags |
get_foods | Search foods/ingredients |
get_units | Search measurement units |
Configuration
Set the following environment variables:
| Variable | Description |
|---|---|
TANDOOR_URL | Tandoor instance URL (default: http://web_recipes) |
TANDOOR_API_TOKEN | API token from Tandoor settings |
Running with Docker
services:
mcp_server:
build: .
environment:
- TANDOOR_URL=http://your-tandoor-instance
- TANDOOR_API_TOKEN=your_token_here
ports:
- "8082:8000"
Running Locally
pip install -r requirements.txt
export TANDOOR_URL=http://localhost:8081
export TANDOOR_API_TOKEN=your_token_here
python server.py
MCP Client Configuration
{
"mcpServers": {
"tandoor": {
"url": "http://localhost:8082/mcp/"
}
}
}
License
MIT