tandoor

This MCP server provides a bridge to a Tandoor Recipe Manager instance. It exposes a set of actions for managing recipes, meal plans, and shopping lists within Tandoor, such as creating recipes, adding them to meal plans, querying available foods, keywords, and units, and managing shopping list items. You can invoke these actions through your MCP client, and the server will translate the requests into corresponding Tandoor API calls using the provided URL and API token. Typical use cases include creating a new recipe with ingredients and instructions, assembling a meal plan for a specific date and meal type, searching for recipes by keywords or foods, and updating or removing items from the shopping list.

Prerequisites:

• Node.js (>= 14) and npm/yarn installed
• Access to a running Tandoor Recipe Manager instance with a valid API token

Installation steps:

1. Clone or download the MCP server repository for Tandoor.
2. Install dependencies:

   npm install
   

3. Build the server (if a build step exists):

   npm run build
   

4. Configure MCP settings with your Tandoor URL and API token (see mcp_config example below).
5. Start the MCP server or integrate it into your MCP manager using the provided configuration.

Note: Ensure your environment has network access to your Tandoor instance and that the API token has the necessary permissions for the requested actions.

Environment variables:

• TANDOOR_URL: Base URL of your Tandoor instance (e.g., https://your-tandoor-instance.com)
• TANDOOR_API_TOKEN: API token for authenticating with Tandoor

Configuration tips:

• You can selectively enable actions by using autoApprove to automatically approve certain MCP actions.
• If you use autoApprove, list all actions you want to pre-approve in the array.
• Keep the TANDOOR_URL and TANDOOR_API_TOKEN secure and avoid committing them to version control.

Common issues:

• 401/403 from Tandoor: verify the API token has the required permissions and that the URL is correct.
• Network or CORS errors: ensure the MCP server can reach the Tandoor URL from its hosting environment.