Mealie MCP Server
Servidor MCP de Mealie
Servidor del Protocolo de Contexto de Modelo (MCP) listo para la comunidad para Mealie.
Expone recetas, planes de comidas, listas de la compra, alimentos, unidades, etiquetas, categorías y herramientas de recetas de Mealie a clientes MCP a través de HTTP transmitible o stdio.
Características
Búsqueda, creación, parcheo, actualización, duplicación, importación por URL/HTML/ZIP/imagen, activos, imágenes, eventos de línea de tiempo, comentarios, exportaciones, sugerencias y actualizaciones de última elaboración de recetas
Entradas de planes de comidas del hogar, comidas de hoy, entradas de comidas aleatorias y reglas de planes de comidas
Listas de la compra del hogar de Mealie v3, CRUD de artículos de compra, cambios masivos de artículos, operaciones de receta a lista y configuración de etiquetas
Datos maestros de alimentos y unidades, incluyendo alias, nombres en plural, fusión de alimentos duplicados y fusión de unidades duplicadas
Etiquetas, categorías, herramientas/utensilios de cocina, libros de cocina, comentarios, enlaces compartidos, analizador, medios, usuarios, grupos, hogares, puntos finales de exploración y puntos finales de administración
Despliegue centrado en Docker con un punto final de salud y usuario de contenedor no root
Related MCP server: Mealie MCP Server
Requisitos
Mealie v3.x
Un token de API de Mealie
Docker, Docker Compose o Python 3.12+
Un cliente MCP que soporte HTTP transmitible o stdio
Inicio rápido con Docker
docker run -d \
--name mealie-mcp \
--restart unless-stopped \
-p 8080:8080 \
--add-host=host.docker.internal:host-gateway \
-e MEALIE_BASE_URL=http://your-mealie-instance:9000 \
-e MEALIE_API_TOKEN=your-mealie-api-token \
ghcr.io/nikopol666/mealie-mcp:latestComprobación de salud:
curl http://localhost:8080/healthPunto final MCP:
http://localhost:8080/mcpDocker Compose
Copia el archivo de entorno de ejemplo, rellena tu URL de Mealie y tu token de API, luego inicia el servicio:
cp .env.example .env
docker compose up -dPara el ejemplo predeterminado de un solo servicio, consulta docker-compose.yml.
Para conectarte a una red Docker de Mealie existente, consulta docker-compose.integration.yml.
services:
mealie-mcp:
image: ghcr.io/nikopol666/mealie-mcp:latest
restart: unless-stopped
ports:
- "${MCP_HTTP_PORT:-8080}:8080"
environment:
MEALIE_BASE_URL: ${MEALIE_BASE_URL:?Set MEALIE_BASE_URL in .env}
MEALIE_API_TOKEN: ${MEALIE_API_TOKEN:?Set MEALIE_API_TOKEN in .env}Configuración
Copia .env.example a .env y rellena tu URL de Mealie y tu token de API.
Variable | Requerido | Predeterminado | Descripción |
| Sí | ninguno | URL base para tu API de Mealie. Usa |
| Sí | ninguno | Token de API de Mealie desde la configuración del perfil del usuario. |
| No |
| Puerto del host utilizado por los archivos de ejemplo de Docker Compose. |
| No |
| Nombre para mostrar anunciado a los clientes MCP. |
| No |
| Host/interfaz para HTTP transmitible. |
| No |
| Puerto interno del servidor. |
| No |
| Nivel de registro de Python. |
| No |
| Tiempo de espera de solicitud de la API de Mealie en segundos. |
| No |
| Intentos de reintento para fallos transitorios de GET y comprobaciones de inicio. |
Configuración del cliente MCP
HTTP transmitible
Usa este punto final cuando tu cliente soporte HTTP transmitible:
http://localhost:8080/mcpDentro de la misma red Docker:
http://mealie-mcp:8080/mcpStdio
Para clientes que inician servidores MCP como procesos locales:
git clone https://github.com/nikopol666/mealie-mcp.git
cd mealie-mcp
python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
export MEALIE_BASE_URL=http://localhost:9000
export MEALIE_API_TOKEN=your-mealie-api-token
python src/main.py --transport stdioCobertura de herramientas
Consulta docs/TOOL_REFERENCE.md para obtener la lista completa de herramientas y notas sobre la carga útil.
Grupos de alto nivel:
Salud
Recetas
Planes de comidas
Listas de la compra
Alimentos y unidades
Etiquetas, categorías y herramientas de recetas
Libros de cocina, comentarios, enlaces compartidos, analizador, medios, usuarios, grupos, hogares, exploración y herramientas de administración
Desarrollo
git clone https://github.com/nikopol666/mealie-mcp.git
cd mealie-mcp
python -m venv .venv
. .venv/bin/activate
pip install -r requirements-dev.txt
PYTHONPATH=src MEALIE_API_TOKEN=test-token pytest -qComprobación de humo opcional de solo lectura contra una instancia real de Mealie:
export MEALIE_LIVE_SMOKE=1
export MEALIE_BASE_URL=http://localhost:9000
export MEALIE_API_TOKEN=your-mealie-api-token
PYTHONPATH=src pytest tests/test_live_smoke.py -qEjecutar con HTTP transmitible:
export MEALIE_BASE_URL=http://localhost:9000
export MEALIE_API_TOKEN=your-mealie-api-token
python src/main.py --transport streamable-httpConstruir la imagen de Docker:
docker build -t mealie-mcp:local .Documentación
Notas de seguridad
Trata
MEALIE_API_TOKENcomo un secreto.Ejecuta el contenedor solo en redes de confianza o detrás de autenticación.
El servidor MCP puede crear, actualizar y eliminar datos de Mealie utilizando los privilegios del token de Mealie configurado.
Utiliza un token de API de Mealie dedicado para este servicio cuando sea posible. Consulta SECURITY.md para obtener orientación sobre divulgación y despliegue.
Compatibilidad
Este proyecto apunta a las APIs actuales de Mealie v3. Mealie ha movido algunos recursos entre ámbitos de grupo y hogar con el tiempo; si una herramienta falla después de una actualización de Mealie, compara el punto final que falla con el /openapi.json de tu instancia.
Licencia
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Recipes MCP — wraps TheMealDB API (free tier, no auth)
Control Ration inventory, meals, meal plans, shopping lists, and credits from an MCP client.
Unofficial API Ninjas MCP — wraps the multi-endpoint API Ninjas data API (api-ninjas.com)
Unofficial AniList MCP — wraps AniList GraphQL API (free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with Mealie recipe databases through MCP clients like Claude Desktop.164MIT
- AlicenseNot gradedqualityDmaintenanceConnects MCP clients like Claude to your Mealie recipe manager, enabling natural language search, creation, import, and updates of recipes.140 npmMIT
- AlicenseCqualityBmaintenanceExposes every endpoint of the Mealie REST API as MCP tools, enabling LLMs to manage recipes, meal plans, shopping lists, and more.211209 npm4MIT
- AlicenseBqualityDmaintenanceExposes a self-hosted Mealie instance to MCP clients, enabling management of recipes, meal plans, shopping lists, and organizers through natural language.21Eclipse Public 2.0