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:latest

Comprobación de salud:

curl http://localhost:8080/health

Punto final MCP:

http://localhost:8080/mcp

Docker 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 -d

Para 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.

Configuración del cliente MCP

HTTP transmitible

Usa este punto final cuando tu cliente soporte HTTP transmitible:

http://localhost:8080/mcp

Dentro de la misma red Docker:

http://mealie-mcp:8080/mcp

Stdio

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 stdio

Cobertura 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 -q

Comprobació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 -q

Ejecutar con HTTP transmitible:

export MEALIE_BASE_URL=http://localhost:9000
export MEALIE_API_TOKEN=your-mealie-api-token
python src/main.py --transport streamable-http

Construir la imagen de Docker:

docker build -t mealie-mcp:local .

Documentación

• Guía de despliegue

• Referencia de herramientas

• Guía de planificación de comidas

• Ejemplos

• Registro de cambios

• Guía de contribución

• Guía de soporte

• Política de seguridad

Notas de seguridad

• Trata MEALIE_API_TOKEN como 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