mealie-mcp
Server MCP para Mealie (gestor de recetas self-hosted) que expone 53 herramientas curadas sobre su REST API. Permite a modelos LLM interactuar con recetas, planificar comidas y gestionar listas de compra mediante stdio o HTTP vía mcp-hub.
Ficha actualizada 22 sept 2026, 15:10 · upstream 22 sept 2026, 15:08 · release v0.4.0
Qué es mealie-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este servidor MCP conecta clientes como Claude Code/Desktop con Mealie, el gestor de recetas self-hosted. Expone 53 herramientas seleccionadas de las 259 operaciones API disponibles en Mealie v3.25.0, cubriendo tareas comunes: búsqueda y lectura de recetas, importación desde URLs, gestión de etiquetas/categorías, planificación de comidas, listas de compra y gestión de libretas de cocina.
La arquitectura utiliza Node.js 22+ con Next.js, conectándose vía HTTPS a la API REST de Mealie. Implementa seguridad por defecto: no expone rutas admin, no permite minting de tokens ni webhooks outbound. Soporta configuración mediante variables de entorno (MEALIE_URL, MEALIE_API_TOKEN) y ofrece modo read-only opcional con 18 herramientas solo lectura.
El servidor valida cada resultado contra su schema antes de exponerlo, asegurando consistencia estructural. Las herramientas declaran outputSchema y responden con structuredContent para facilitar el consumo por clientes. Incluye soporte para recetas direccionables por slug o UUID.
- Búsqueda y lectura de recetas con ingredientes y pasos detallados
- Importación automática de recetas desde sitios web mediante preview_recipe_url
- Planificación semanal de comidas integrada con create_mealplan_entry
- Generación de listas de compra a partir de planes de comida
- Gestión de categorías, etiquetas y libretas de cocina
- Registro de lo cocinado (set_recipe_last_made) y ratings de recetas
- 53 herramientas curadas vs 259 API operations disponibles en Mealie v3.25.0
- Seguridad por defecto: sin rutas admin, sin minting de tokens, sin webhooks outbound
- Modo read-only opcional con solo 8 herramientas esenciales (MEALIE_ALLOW_TOOLS=essential)
- Validación estricta contra schema antes de exponer resultados mediante SDK
- Compatible con mcp-hub para clientes que no pueden spawn procesos locales
- Soporte para recetas direccionables por slug o UUID en todas las operaciones
- Requiere Node.js 22+ (no compatible con versiones antiguas)
- Necesita instancia Mealie existente con token API configurado en Settings → API Tokens
- Algunas herramientas requieren aprobación interactiva del usuario mediante elicitation MCP
- No soporta Dockerfile ni compose, solo imagen containerizada ghcr.io/ni-c/mealie-mcp
- Limitado a Mealie v3.25.0 para verificación de schemas de API
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Usar MEALIE_ALLOW_TOOLS=essential para producción. Configurar MEALIE_INSECURE_TLS=false en entornos con certificados válidos. Para clientes que no pueden spawn procesos, usar mcp-hub con OAuth 2.1. Verificar startup logs en stderr para confirmar herramientas registradas. Token API eliminado del entorno tras lectura inicial. Evitar MEALIE_READ_ONLY=true si se necesitan operaciones de escritura.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.