# chefkoch-mcp

MCP-Server für Chefkoch.de: Rezepte suchen, Rezeptdetails anzeigen und
Einkaufslisten aus mehreren Rezepten erstellen. Ausschließlich lesend, ohne
Login.

Der Server ist eine dünne Hülle um den Kern der
[`chefkoch-cli`](https://github.com/smlfg/chefkoch-cli): Er importiert
`chefkoch_cli.service` und `chefkoch_cli.client` und ruft dieselben Funktionen
wie `chefkoch suche`, `chefkoch rezept` und `chefkoch einkaufsliste` auf.

## Was es kann

- **Rezepte suchen** mit Filtern für vegetarisch/vegan, maximale Zeit,
  Mindestbewertung, Schwierigkeit, Sortierung und Seite.
- **Rezeptdetails** per ID, Chefkoch-URL oder Suchbegriff, Zutaten auf
  Wunschportionen skaliert.
- **Einkaufsliste** aus mehreren Rezepten, Zutaten nach Name und Einheit
  zusammengefasst.

## Schnellstart

```bash
uvx chefkoch-mcp
```

Der Befehl startet den MCP-Server über stdio. In der Praxis wird er aus dem
MCP-Client heraus gestartet, nicht von Hand.

## In Claude Desktop / Cursor nutzen

```json
{"mcpServers":{"chefkoch":{"command":"uvx","args":["chefkoch-mcp"]}}}
```

## Claude Code

```bash
claude mcp add chefkoch -- uvx chefkoch-mcp
```

## Tools

| Tool | Beschreibung |
|---|---|
| `search_recipes` | Rezepte mit Filtern suchen |
| `get_recipe` | Rezept per ID, URL oder Name anzeigen |
| `shopping_list` | Einkaufsliste aus mehreren Rezepten erstellen |

Alle Tools sind lesend (`readOnlyHint`) und liefern strukturierte Daten plus
lesbaren Text. Fehler kommen als lesbare Meldung mit nächstem Schritt zurück.

## Datenquelle

Die Daten stammen von [chefkoch.de](https://www.chefkoch.de) über die
inoffizielle API. Das Projekt ist nicht mit Chefkoch verbunden, greift nur
lesend zu und benötigt keinen Login. Die API kann sich jederzeit ändern.

## Konfiguration

| Variable | Default | Bedeutung |
|---|---|---|
| `CHEFKOCH_BASE_URL` | `https://api.chefkoch.de` | API-Basis (Test/Fake-Server) |

## Lizenz

MIT, Copyright 2026 smlfg. Siehe `LICENSE`.

<!-- mcp-name: io.github.smlfg/chefkoch-mcp -->