cookbook

The cookbook MCP server exposes two capabilities: get_all_dishes, which retrieves all recipes from the configured cookbook directory, and get_recipe, which fetches the recipe details for a specific dish. This makes it easy to query a local collection of recipes via MCP without needing to run the full application each time. After starting the server, you can use the MCP client to request a list of dishes or to pull the full instructions for a particular dish by name or identifier. The client configuration in the README shows how to point the server to your local cookbook repository and how to run the server using uv with the provided cookbook.py entry point. If you opt into SSE (server-sent events) updates, you can switch the transport in both the server and client configurations to receive real-time updates.

Prerequisites:

• Python (with venv support)
• uv (the MCP CLI) available via Python packaging
• Access to the internet to install dependencies

Installation steps:

1. Create project directory and navigate into it

   • mkdir cookbook
   • cd cookbook

2. Create and activate a virtual environment

   • python -m venv .venv
   • source .venv/bin/activate # on Unix/macOS
   • .venv\Scripts\activate # on Windows

3. Install MCP CLI with the cookbook project dependency

   • uv add "mcp[cli]"

4. Prepare your local cookbook and Python script

   • Place your cookbook.py in a known directory and ensure the COOKBOOK URL path in the script points to your local dishes folder

5. Configure and run the MCP server using the example shown in the README

   • Ensure your paths in the mcp_config section are updated to your environment
   • Start the MCP server according to your environment tooling (as shown in the provided mcp_config example)

Tips and common considerations:

• The server expects a Python script (cookbook.py) that implements the MCP endpoints get_all_dishes and get_recipe against your local cookbook data.
• If you enable SSE transport, update both server and client configurations to use the SSE URL and port as shown, and modify the entry point in cookbook.py to initialize and run mcp with transport='sse'.
• Keep the COOKBOOK_URL or path constants in cookbook.py updated to reflect the actual location of your dishes data.
• Ensure file permissions allow the MCP server process to read the cookbook data directory.
• If you modify paths, remember to restart the MCP server so changes take effect.