mealie-mcp-server

Ein Model Context Protocol (MCP)-Server für die Rezeptverwaltung Mealie. Stellt 53 Tools und 1 Prompt für KI-Assistenten bereit, um Rezepte, Essenspläne, Einkaufslisten, Kategorien, Tags und Lebensmittel zu durchsuchen, zu erstellen und zu verwalten.

Funktionen

• Rezeptverwaltung — Rezepte suchen, erstellen, patchen, duplizieren und löschen. Mehrere Rezepte mit begrenzter Parallelität stapelweise abrufen.

• Rezeptsuche nach Zutaten — find_recipes_for_ingredients löst menschenlesbare Zutatennamen (niemals Mealie-Food-UUIDs) gegen die Lebensmittel-Taxonomie von Mealie auf und findet passende Rezepte über den Mealie-Recipe-Finder. Falls keine exakte Lebensmittelübereinstimmung vorliegt, wird auf die normale Rezeptsuche zurückgegriffen – nützlich für die Suche nach dem Prinzip „Was kann ich mit X kochen?“, einschließlich Zutaten, die Mealie nicht unter diesem exakten Namen kennt (das aufrufende LLM erweitert die Suche mit Ersatzbegriffen; der MCP selbst rät nie zu Ersetzungen). Siehe Rezepte nach Zutat finden in Workflows.

• Rezeptkategorien- und Tag-Zuweisung — Kategorien und Tags bestehenden Rezepten mit Merge/Replace-Semantik zuweisen, Namens-/Slug-/ID-Auflösung und optionaler automatischer Erstellung fehlender Werte, ohne Zutaten, Anleitungen, Nährwerte oder andere Rezeptfelder zu beeinträchtigen. Verfügbar über patch_recipe, update_recipe_taxonomy und update_recipe_taxonomy_batch. Siehe Kategorien & Tags zuweisen in Workflows.

• Essensplanung — Essenspläne anzeigen, erstellen und massenhaft erstellen. Ein zusammengesetztes Tool ruft Essenspläne mit eingebetteten Rezeptdetails (einschließlich Nährwerten) über gleichzeitige Batch-Anfragen ab und eliminiert so N+1-Abfragen.

• Einkaufslisten — Vollständige CRUD-Operationen für Listen und Artikel, Massenoperationen und Rezept-zu-Liste-Integration.

• Kategorien & Tags — Vollständige CRUD-Operationen zur Organisation von Rezepten, einschließlich Erkennung leerer Kategorien/Tags.

• Lebensmittel — Vollständige CRUD-Operationen für die Lebensmittel-Taxonomie (wiederverwendbare strukturierte Zutateneinheiten), einschließlich Alias-Verwaltung und Lebensmittel-Label-Zuweisung. Siehe Ein Lebensmittel auflösen oder erstellen in Workflows.

• Strukturierte Zutaten schreiben — update_recipe_ingredients ersetzt die vollständige strukturierte Zutatenkollektion eines Rezepts unter Verwendung bereits aufgelöster Lebensmittel-/Einheiten-Referenzen, ohne andere Rezeptfelder zu beeinträchtigen. Siehe Strukturierte Rezeptzutaten aktualisieren in Workflows.

• Batch- und zusammengesetzte Tools — get_recipes_batch und get_recipes_detailed_batch für Rezeptabruf mit begrenzter Parallelität, get_mealplan_with_recipes für Essenspläne mit eingebetteten Rezeptdaten und clientseitiger Datumsfilterung, update_recipe_taxonomy_batch für Kategorie-/Tag-Aktualisierungen mit begrenzter Parallelität über viele Rezepte hinweg.

• Rezeptklassifizierungs-Feed — get_recipes_for_classification ist ein kompakter, paginierter, schreibgeschützter Feed, der speziell für die KI-gesteuerte Kategorie-/Tag-Zuweisung entwickelt wurde. Er vermeidet die Zeitüberschreitungen, die Batch-/Detail-Tools bei großen Rezeptmengen erreichen können, indem er mit dem kostengünstigen Listen-Endpunkt filtert, nur für Treffer volle Details mit derselben begrenzten Parallelität wie oben abruft und mit einem stabilen Cursor paginiert, der gleichzeitige Taxonomie-Änderungen übersteht. Siehe Rezeptklassifizierungs-Workflow in Workflows.

• Keine Laufzeitabhängigkeiten außer dem SDK — Verwendet natives fetch, kein axios oder httpx.

Related MCP server: mcp-mealie

Anforderungen

• Node.js >= 22

• Eine laufende Mealie-Instanz mit einem API-Schlüssel

Installation

Schnellstart (npx)

MEALIE_BASE_URL=https://your-mealie-instance.com \
MEALIE_API_KEY=your-api-key \
npx mealie-mcp-server

opencode-Konfiguration

Fügen Sie zu Ihrer opencode.json hinzu:

{
  "mcp": {
    "mealie-mcp-server": {
      "type": "local",
      "command": ["npx", "mealie-mcp-server"],
      "enabled": true,
      "environment": {
        "MEALIE_BASE_URL": "https://your-mealie-instance.com",
        "MEALIE_API_KEY": "your-api-key"
      }
    }
  }
}

Docker

Führen Sie den MCP-Server in einem Container aus:

docker run -d \
  --name mealie-mcp-server \
  -e MEALIE_BASE_URL=https://your-mealie-instance.com \
  -e MEALIE_API_KEY=your-api-key \
  ghcr.io/timo-reymann/mealie-mcp-server:main

Oder mit Docker Compose:

version: '3.8'
services:
  mealie-mcp-server:
    image: ghcr.io/timo-reymann/mealie-mcp-server:main
    environment:
      MEALIE_BASE_URL: https://your-mealie-instance.com
      MEALIE_API_KEY: your-api-key
    restart: unless-stopped

Lokale Entwicklung

git clone https://github.com/timo-reymann/mealie-mcp-server.git
cd mealie-mcp-server
corepack enable
yarn install
cp .env.template .env
# Edit .env with your MEALIE_BASE_URL and MEALIE_API_KEY
yarn dev

Stellen Sie sicher, dass MEALIE_BASE_URL und MEALIE_API_KEY in Ihrer Umgebung oder opencode-Konfiguration gesetzt sind.

Dokumentation

• API-Abdeckung — jedes Tool, das seinem zugrunde liegenden Mealie-API-Endpunkt zugeordnet ist.

• Workflows — Nutzungsanleitungen und Beispiel-Payloads für die komplexeren Tools: Zutatensuche, Taxonomie-Zuweisung, Lebensmittel, strukturierte Zutaten schreiben und der Rezeptklassifizierungs-Feed.

• Architektur — interne Designhinweise für Mitwirkende: Begründung für begrenzte Parallelität, Paginierungs-/Cursor-Design und bekannte Mealie-API-Eigenheiten.

Mitwirkende

Ich freue mich über Ihren Beitrag! Bitte lesen Sie die Beitragsrichtlinien, um loszulegen.

Möchten Sie in der Liste der Mitwirkenden erscheinen?

Beginnen Sie mit dem Lesen der Beitragsrichtlinien

Entwicklung

Anforderungen

• Node.js >= 22

• Yarn (über Corepack: corepack enable)

• Eine Mealie-Instanz für Integrationstests (oder mocken Sie die Fetch-Schicht)

Test

yarn test

Typprüfung

yarn typecheck

Build

yarn build

Lint

yarn lint

Verfügbare Tools (insgesamt 53)

Rezepte (16)

get_recipes, find_recipes_for_ingredients, get_recipe_detailed, get_recipe_concise, get_recipes_batch, get_recipes_detailed_batch, get_recipes_for_classification, create_recipe, patch_recipe, update_recipe_ingredients, update_recipe_taxonomy, update_recipe_taxonomy_batch, duplicate_recipe, mark_recipe_last_made, set_recipe_image_from_url, delete_recipe

Essenspläne (5)

get_all_mealplans, get_mealplan_with_recipes, create_mealplan, create_mealplan_bulk, get_todays_mealplan

Kategorien (7)

get_categories, get_empty_categories, create_category, get_category, get_category_by_slug, update_category, delete_category

Tags (7)

get_tags, get_empty_tags, create_tag, get_tag, get_tag_by_slug, update_tag, delete_tag

Einkaufslisten (13)

get_shopping_lists, create_shopping_list, get_shopping_list, update_shopping_list, delete_shopping_list, add_recipe_to_shopping_list, remove_recipe_from_shopping_list, get_shopping_list_items, create_shopping_list_item, create_shopping_list_items_bulk, update_shopping_list_item, delete_shopping_list_item, delete_shopping_list_items_bulk

Lebensmittel (5)

get_foods, get_food, create_food, update_food, delete_food

Lizenz

MIT