mealie-mcp

Ein Model Context Protocol-Server, der Mealie – einen selbst gehosteten Rezeptmanager – als eine Reihe von LLM-aufrufbaren Tools bereitstellt. Er ermöglicht es Claude Desktop / Claude Code (oder jedem anderen MCP-Client), Rezepte zu suchen, Details abzurufen, den Essensplan zu verwalten und Einkaufslisten auf Ihrer eigenen Mealie-Instanz zu bearbeiten.

Tools

Related MCP server: Mealie MCP Server

Anforderungen

• Python 3.11+

• Eine laufende Mealie-Instanz (selbst gehostet; getestet mit Mealie v2)

• Ein langlebiges Mealie-API-Token (Benutzerprofil → API-Token in der Mealie-Benutzeroberfläche)

Konfiguration

Kopieren Sie .env.example nach .env und füllen Sie die Werte aus:

cp .env.example .env

Lokal installieren & ausführen

pip install -e .
# stdio mode (for Claude Desktop):
MCP_TRANSPORT=stdio mealie-mcp
# sse/http mode (for docker-compose / remote clients):
MCP_TRANSPORT=sse MCP_PORT=8000 mealie-mcp

Der SSE-Endpunkt wird unter http://<host>:<port>/sse bereitgestellt.

Claude Desktop-Konfiguration

Bearbeiten Sie die Konfigurationsdatei von Claude Desktop (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mealie": {
      "command": "mealie-mcp",
      "env": {
        "MEALIE_URL": "http://localhost:9011",
        "MEALIE_API_TOKEN": "paste-your-token-here",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Wenn mealie-mcp nicht in Ihrem PATH enthalten ist, geben Sie bei command den vollständigen Pfad zur Binärdatei an (z. B. /Users/you/.venvs/mealie-mcp/bin/mealie-mcp) oder führen Sie es über Python aus:

{
  "mcpServers": {
    "mealie": {
      "command": "python",
      "args": ["-m", "mealie_mcp"],
      "env": {
        "MEALIE_URL": "http://localhost:9011",
        "MEALIE_API_TOKEN": "paste-your-token-here",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Bearbeiten der Konfiguration neu.

Docker / docker-compose

Ein Dockerfile ist enthalten. Um es eigenständig auszuführen:

docker build -t mealie-mcp .
docker run --rm -p 8765:8000 \
  -e MEALIE_URL=http://host.docker.internal:9011 \
  -e MEALIE_API_TOKEN=your-token \
  mealie-mcp

Um den Server zu einem bestehenden Mealie-Stack hinzuzufügen, siehe docker-compose.snippet.yml:

services:
  mealie-mcp:
    build:
      context: ./mealie-mcp
    depends_on:
      - mealie
    environment:
      MEALIE_URL: "http://mealie:9000"
      MEALIE_API_TOKEN: "${MEALIE_API_TOKEN}"
      MCP_TRANSPORT: "sse"
      MCP_HOST: "0.0.0.0"
      MCP_PORT: "8000"
    ports:
      - "8765:8000"

Verweisen Sie Ihren MCP-Client auf http://<docker-host>:8765/sse.

Manuelles Testen des Servers

Wenn der Server im SSE-Modus läuft, bestätigen Sie, dass er erreichbar ist:

curl -N http://localhost:8000/sse

Sie sollten sehen, wie sich ein SSE-Event-Stream öffnet. Für den stdio-Modus übernimmt Claude Desktop den Handshake – es gibt keinen HTTP-Endpunkt.

Projektstruktur

mealie-mcp/
├── pyproject.toml
├── Dockerfile
├── docker-compose.snippet.yml
├── .env.example
├── README.md
└── src/mealie_mcp/
    ├── __init__.py
    ├── __main__.py        # CLI entry point (loads .env, dispatches transport)
    ├── server.py          # FastMCP server + tool definitions
    └── client.py          # Async httpx wrapper for the Mealie REST API

Lizenz

MIT