cooklang-mcp-server

Ein kleiner FastMCP-Server, der den CookCLI-Rezeptserver (cook server, wie in ghcr.io/cooklang/cookcli entalten) einem Coding-Agenten als MCP-Tools bereitellt. Damit kann ein Agent Cooklang-Rezepte über die CookCLI-HTTP-API durchsuchen, lesen, schreiben, löschen und suchen.

Brauchst du das?

Verwende dieen Server, wenn die Rezepte über HTTP ereicht werden: ein cook server, der auf einem anderen Rechner oder einem NAS läuft, oder ein MCP-Client wie Claude Desktop, der keinen Shell-Zugriff hat.

Wenn deine Rezepte lokale Dateien sind und der Agent Befehle ausführen kann (Claude Code, Codex), ist das offizielle cooklang-skills-Plugin die bessere Wahl. Es steuert die cook-CLI direkt und deckt mehr ab: Essenplanung, Vorratsverfolgung, nach Regalen gruppierte Einkaufslisten, Exporte.

Related MCP server: Nextcloud Cookbook MCP Server

So funktioniert es

Jedes MCP-Tool bildet 1:1 auf einen CookCLI-HTTP-Endpunkt ab (read_recipe -> GET /api/recipes/{path}, usw.). Dieser Server ist ein zustandsloser Adapter: Er speichert keine Daten, fürt kein Parsing durch und erfordert einen separaten cook server-Prozess, der läuft (siehe Voraussetzungen). Alle Rezepte liegen im Rezeptverzeichnis von CookCLI.

Tools

path ist relativ zum Rezeptverzeichnis des CookCLI-Servers, z. B. Dolci/bunet-piemontese (die .cook-Endung ist optional). write_recipe setzt voraus, dass der übergeordnete Ordner bereits existiert, und schreibt atomar (temporäre Datei + Umbenennung). Titelbilder sind über HTTP nicht schreibbar: Lege sie neben die .cook-Datei im Rezeptverzeichnis (oder Docker-Volume).

Voraussetzungen

• Python >= 3.10 und uv

• Ein laufender CookCLI-Server, z. B.:

  docker run -d --name cooklang-cookcli-1 -p 9080:9080 \
    -v cooklang_recipes:/recipes \
    ghcr.io/cooklang/cookcli server --host 0.0.0.0 /recipes

  oder, mit lokal installiertem CookCLI, cook server ./my-recipes.

Registrierung bei Claude Code

Kein Klonen erforderlich. uvx holt, baut und cached den Server direkt aus diesem Repository:

claude mcp add cooklang \
  --env COOKLANG_SERVER_URL=http://localhost:9080 \
  -- uvx --from git+https://github.com/alessmar/cooklang-mcp-server cooklang-mcp-server

Oder in .mcp.json / ~/.claude.json:

{
  "mcpServers": {
    "cooklang": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/alessmar/cooklang-mcp-server",
               "cooklang-mcp-server"],
      "env": { "COOKLANG_SERVER_URL": "http://localhost:9080" }
    }
  }
}

COOKLANG_SERVER_URL ist standardmäßig http://localhost:9080. Lege eine Version fest, indem du @<tag> an die Git-URL anhängst, z. B. ...cooklang-mcp-server@v0.1.0.

Lokale Entwicklung

git clone https://github.com/alessmar/cooklang-mcp-server
cd cooklang-mcp-server
uv sync
COOKLANG_SERVER_URL=http://localhost:9080 uv run cooklang-mcp-server

Hinweise

• Der CookCLI-Server hat keine Authentifizierung und offenes CORS: Halte ihn auf localhost oder einem vertrauenswürdigen LAN.

• /api/reload ist bei aktuellem CookCLI ein No-op: Der Server liest bei jeder Anfrage von der Festplatte, sodass Änderungen an Dateien außerhalb der API sofort übernommen werden.

Lizenz

MIT. Siehe LICENSE.