Mealie MCP-Server

Community-bereiter Model Context Protocol (MCP)-Server für Mealie.

Er stellt Mealie-Rezepte, Essenspläne, Einkaufslisten, Lebensmittel, Einheiten, Tags, Kategorien und Rezept-Tools für MCP-Clients entweder über streamfähiges HTTP oder stdio bereit.

Funktionen

• Rezeptsuche, Erstellen, Patch, Update, Duplizieren, URL/HTML/ZIP/Bild-Import, Assets, Bilder, Zeitlinienereignisse, Kommentare, Exporte, Vorschläge und Updates zum zuletzt gekochten Gericht

• Haushalts-Essensplaneinträge, Mahlzeiten für heute, zufällige Mahlzeiteneinträge und Essensplanregeln

• Mealie v3 Haushalts-Einkaufslisten, CRUD für Einkaufsartikel, Massenänderungen an Artikeln, Rezept-zu-Liste-Operationen und Label-Einstellungen

• Stammdaten für Lebensmittel und Einheiten, einschließlich Aliase, Pluralnamen, Zusammenführung doppelter Lebensmittel und Zusammenführung doppelter Einheiten

• Tags, Kategorien, Rezept-Tools/Utensilien, Kochbücher, Kommentare, geteilte Links, Parser, Medien, Benutzer, Gruppen, Haushalte, Explore-Endpunkte und Admin-Endpunkte

• Docker-First-Bereitstellung mit einem Health-Endpunkt und einem Non-Root-Container-Benutzer

Related MCP server: Mealie MCP Server

Anforderungen

• Mealie v3.x

• Ein Mealie-API-Token

• Docker, Docker Compose oder Python 3.12+

• Ein MCP-Client, der streamfähiges HTTP oder stdio unterstützt

Schnellstart mit 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

Health-Check:

curl http://localhost:8080/health

MCP-Endpunkt:

http://localhost:8080/mcp

Docker Compose

Kopieren Sie die Beispiel-Umgebungsdatei, tragen Sie Ihre Mealie-URL und Ihr API-Token ein und starten Sie dann den Dienst:

cp .env.example .env
docker compose up -d

Für das Standard-Beispiel mit einem einzelnen Dienst siehe docker-compose.yml.

Für die Anbindung an ein bestehendes Mealie-Docker-Netzwerk siehe 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}

Konfiguration

Kopieren Sie .env.example nach .env und tragen Sie Ihre Mealie-URL und Ihr API-Token ein.

MCP-Client-Einrichtung

Streamfähiges HTTP

Verwenden Sie diesen Endpunkt, wenn Ihr Client streamfähiges HTTP unterstützt:

http://localhost:8080/mcp

Innerhalb desselben Docker-Netzwerks:

http://mealie-mcp:8080/mcp

Stdio

Für Clients, die MCP-Server als lokale Prozesse starten:

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

Tool-Abdeckung

Siehe docs/TOOL_REFERENCE.md für die vollständige Tool-Liste und Payload-Hinweise.

Gruppen auf hoher Ebene:

• Health

• Rezepte

• Essenspläne

• Einkaufslisten

• Lebensmittel und Einheiten

• Tags, Kategorien und Rezept-Tools

• Kochbücher, Kommentare, geteilte Links, Parser, Medien, Benutzer, Gruppen, Haushalte, Explore- und Admin-Tools

Entwicklung

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

Optionaler Read-Only-Smoke-Test gegen eine echte Mealie-Instanz:

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

Ausführen mit streamfähigem HTTP:

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

Docker-Image bauen:

docker build -t mealie-mcp:local .

Dokumentation

• Bereitstellungsanleitung

• Tool-Referenz

• Anleitung zur Essensplanung

• Beispiele

• Changelog

• Beitragsanleitung

• Support-Anleitung

• Sicherheitsrichtlinie

Sicherheitshinweise

• Behandeln Sie MEALIE_API_TOKEN als Geheimnis.

• Betreiben Sie den Container nur in vertrauenswürdigen Netzwerken oder hinter einer Authentifizierung.

• Der MCP-Server kann Mealie-Daten mit den Berechtigungen des konfigurierten Mealie-Tokens erstellen, aktualisieren und löschen.

• Verwenden Sie nach Möglichkeit ein dediziertes Mealie-API-Token für diesen Dienst. Siehe SECURITY.md für Offenlegungs- und Bereitstellungsrichtlinien.

Kompatibilität

Dieses Projekt zielt auf aktuelle Mealie v3-APIs ab. Mealie hat im Laufe der Zeit einige Ressourcen zwischen Gruppen- und Haushaltsbereichen verschoben; wenn ein Tool nach einem Mealie-Upgrade fehlschlägt, vergleichen Sie den fehlerhaften Endpunkt mit der /openapi.json Ihrer Instanz.

Lizenz

MIT