Un servidor del Protocolo de Contexto de Modelo (MCP) que expone Mealie —un gestor de recetas autohospedado— como un conjunto de herramientas invocables por LLM. Permite a Claude Desktop / Claude Code (o cualquier cliente MCP) buscar recetas, obtener detalles, gestionar el plan de comidas y editar listas de la compra en tu propia instancia de Mealie.
Herramienta | Propósito |
| Buscar recetas; devuelve slug, nombre, descripción, etiquetas, categorías |
| JSON completo de la receta para un slug |
| Entradas del plan de comidas entre dos fechas ISO |
| IDs y nombres de todas las listas de la compra |
| Añadir elementos de texto libre a una lista |
| Crear una receta en blanco; devuelve el slug generado |
| Añadir una entrada al plan de comidas |
Related MCP server: Mealie MCP Server
Python 3.11+
Una instancia de Mealie en ejecución (autohospedada; probado con Mealie v2)
Un token de API de Mealie de larga duración (Perfil de usuario → Tokens de API en la interfaz de Mealie)
Copia .env.example a .env y rellena los valores:
cp .env.example .envVariable | Requerido | Por defecto | Descripción |
| sí | — | URL base de tu instancia de Mealie (ej. |
| sí | — | Token de portador de larga duración de Mealie |
| no |
|
|
| no |
| Dirección de enlace para el modo SSE |
| no |
| Puerto de enlace para el modo SSE |
pip install -e .
# stdio mode (for Claude Desktop):
MCP_TRANSPORT=stdio mealie-mcp
# sse/http mode (for docker-compose / remote clients):
MCP_TRANSPORT=sse MCP_PORT=8000 mealie-mcpEl endpoint SSE se sirve en http://<host>:<port>/sse.
Edita el archivo de configuración de Claude Desktop (macOS:
~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"mealie": {
"command": "mealie-mcp",
"env": {
"MEALIE_URL": "http://localhost:9011",
"MEALIE_API_TOKEN": "paste-your-token-here",
"MCP_TRANSPORT": "stdio"
}
}
}
}Si mealie-mcp no está en tu PATH, apunta command a la ruta completa del binario
(ej. /Users/you/.venvs/mealie-mcp/bin/mealie-mcp) o invócalo mediante Python:
{
"mcpServers": {
"mealie": {
"command": "python",
"args": ["-m", "mealie_mcp"],
"env": {
"MEALIE_URL": "http://localhost:9011",
"MEALIE_API_TOKEN": "paste-your-token-here",
"MCP_TRANSPORT": "stdio"
}
}
}
}Reinicia Claude Desktop después de editar la configuración.
Se incluye un Dockerfile. Para ejecutar de forma independiente:
docker build -t mealie-mcp .
docker run --rm -p 8765:8000 \
-e MEALIE_URL=http://host.docker.internal:9011 \
-e MEALIE_API_TOKEN=your-token \
mealie-mcpPara añadir el servidor a una pila de Mealie existente, consulta
docker-compose.snippet.yml:
services:
mealie-mcp:
build:
context: ./mealie-mcp
depends_on:
- mealie
environment:
MEALIE_URL: "http://mealie:9000"
MEALIE_API_TOKEN: "${MEALIE_API_TOKEN}"
MCP_TRANSPORT: "sse"
MCP_HOST: "0.0.0.0"
MCP_PORT: "8000"
ports:
- "8765:8000"Apunta tu cliente MCP a http://<docker-host>:8765/sse.
Con el servidor ejecutándose en modo SSE, confirma que es accesible:
curl -N http://localhost:8000/sseDeberías ver abrirse un flujo de eventos SSE. Para el modo stdio, Claude Desktop gestiona el handshake: no hay endpoint HTTP.
mealie-mcp/
├── pyproject.toml
├── Dockerfile
├── docker-compose.snippet.yml
├── .env.example
├── README.md
└── src/mealie_mcp/
├── __init__.py
├── __main__.py # CLI entry point (loads .env, dispatches transport)
├── server.py # FastMCP server + tool definitions
└── client.py # Async httpx wrapper for the Mealie REST APIMIT
This server cannot be deployed
Scraps Kitchen gives any AI agent a persistent, household-aware kitchen memory. Unlike generic chatbot recall, Scraps maintains structured cooking data: what's in your fridge (with freshness tracking), who you cook for (with allergens, dietary restrictions, and preferences), your recipe collection (with cook notes and per-diner ratings), your shopping list, and your kitchen equipment. 27 tools across 6 domains let agents read kitchen context, suggest meals that respect dietary safety, update the pantry after cooking, and build a history of what works for your household. Every interaction makes the data richer. Cooking history, preference signals, kitchen awareness = better suggestions next time. All tools work via oAuth and a free scraps.kitchen account.
Household-aware cooking brain: pantry, meal suggestions, dietary safety, recipes, shopping lists.
Search structured recipes, scale servings, match pantry ingredients, and build shopping lists.
Search, read, and edit your Halite recipe collection and shopping lists.
