MealCP MCP

Offizieller Model Context Protocol Server für MealCP — die Datenebene für Lebensmittel und Ernährung für KI-Agenten.

Stellt zwei Tools über die öffentliche MealCP-API bereit:

• search_products — durchsucht den Lebensmittelproduktkatalog nach Stichwort mit Facettenfilterung (Land, Einzelhändler, Kette, Marke, Tag, Kategorie, Stadt, Preisbereich, Sortierung, Paginierung).

• get_price_history — aggregierte Preisverlaufsstatistiken (min/max/avg/erster/letzter, Nettoveränderung) für ein Produkt über einen Zeitraum.

Voraussetzungen

• Python 3.10+

• Ein API-Schlüssel von MealCP (jeder Tool-Aufruf verbraucht 1 Credit)

Related MCP server: Swissgroceries MCP

Verwendung

Direkt mit uv ausführen:

uvx mealcp-mcp

Oder installieren:

pip install mealcp-mcp
mealcp-mcp

Der Server spricht MCP über stdio; jeder MCP-Host (Claude Desktop, opencode, Cursor, …) kann ihn starten.

Claude Desktop

{
  "mcpServers": {
    "mealcp": {
      "command": "uvx",
      "args": ["mealcp-mcp"],
      "env": {
        "MEALCP_API_URL": "https://api.mealcp.com",
        "MEALCP_API_KEY": "mcp_live_your_key_here"
      }
    }
  }
}

opencode

{
  "mcp": {
    "mealcp": {
      "type": "local",
      "command": ["uvx", "mealcp-mcp"],
      "enabled": true,
      "environment": {
        "MEALCP_API_URL": "https://api.mealcp.com",
        "MEALCP_API_KEY": "mcp_live_your_key_here"
      }
    }
  }
}

Konfiguration

Fehler

Tool-Fehler zeigen die stabilen Fehlertokens der API, formatiert als <code>: <message> (z. B. not_found: Product not found). Verzweigen Sie auf den Code, niemals auf die Nachricht.

Vertrag

Antwortmodelle werden aus der OpenAPI-Spezifikation der API generiert (contract/openapi.json, derzeit Version 0.1.0). Aktualisieren mit:

uvx --from datamodel-code-generator datamodel-codegen \
  --input contract/openapi.json \
  --output src/mealcp_mcp/models.py \
  --output-model-type pydantic_v2.BaseModel \
  --target-python-version 3.10 --disable-timestamp

Entwicklung

uv sync
uv run pytest
uv run ruff check .

Lizenz

MIT