recipal-mcp-unofficial

Ein MCP-Server für die ReciPal-Nährwertkennzeichnungs-API. Er ermöglicht einem KI-Assistenten, Ihre Rezepte, Zutaten und Unterrezepte direkt zu lesen und zu bearbeiten – einschließlich Massenoperationen, die in der Weboberfläche Stunden dauern würden.

Inoffiziell. Nicht mit ReciPal verbunden, von ReciPal unterstützt oder befürwortet. Von Nutzern des Produkts gegen seine öffentliche API erstellt.

Interimsprojekt – dieses Repository wird archiviert. ReciPal arbeitet an einem offiziellen MCP-Server. Wenn dieser erscheint, wird dieses Projekt aktualisiert, um darauf zu verweisen, und dann schreibgeschützt archiviert. Bauen Sie nichts Tragendes darauf auf. Siehe SUNSET.md.

Sie benötigen ein aktives kostenpflichtiges ReciPal-Abonnement. Der API-Zugriff ist eine kostenpflichtige Funktion; der Schlüssel stammt aus Ihren Kontoeinstellungen unter API access. Ohne einen solchen kann dieser Server nichts tun.

Wofür es gedacht ist

Die Weboberfläche von ReciPal ist gut zum Bearbeiten eines einzelnen Rezepts. Es wird mühsam, wenn Sie dasselbe mit vierzig Rezepten tun müssen – eine Portionsgröße im gesamten Katalog korrigieren, Zutaten umbenennen, die mit (copy)-Suffixen hereinkamen, oder eine Familie von Produktvarianten aufbauen, die sich nur in einer Zutat unterscheiden. Dieser Server stellt die API bereit, damit ein Assistent diese Arbeit in einer Schleife erledigen kann, mit einem Probelauf zuerst.

Das Werkzeug, das sich bezahlt macht, ist bulk_clone_and_swap: Nehmen Sie ein vollständig konfiguriertes Rezept als Vorlage, klonen Sie es N-mal und tauschen Sie in jedem Klon eine einzelne Zutat aus. Etikett-Einstellungen, Tags und Portionsgrößen werden übernommen, sodass die Klone konsistent herauskommen.

Related MCP server: cookwith-mcp

Umfang und Verbreitung

Bewusst eng gefasst, und das wird auch so bleiben:

• Quellcode, den Sie klonen und bauen. Es gibt kein Ein-Klick-Plugin-Bündel, kein npx-Paket und keine Auflistung in einem MCP-Verzeichnis oder Marktplatz. Das ist eine Verpflichtung gegenüber ReciPal, kein Versehen oder ein offener Punkt.

• Nicht auf npm veröffentlicht. Die package.json ist absichtlich als private markiert.

• Benannt recipal-mcp-unofficial auf Wunsch von ReciPal, damit es nicht mit ihrem offiziellen Server verwechselt werden kann.

Pull-Requests, die eine verpackte Distribution, Marktplatz-Einreichungen oder einen benutzerfreundlicheren Installationspfad für Endnutzer hinzufügen, werden abgelehnt. Siehe CONTRIBUTING.md für das, was willkommen ist.

Installation

Erfordert Node.js 18 oder neuer.

git clone https://github.com/BlackBlack/recipal-mcp-unofficial.git
cd recipal-mcp-unofficial
npm install
npm run build

Registrieren Sie es dann bei Ihrem MCP-Client. Für Claude Code:

claude mcp add --transport stdio recipal-mcp-unofficial \
  --env RECIPAL_API_KEY=your_key_here \
  -- node /absolute/path/to/recipal-mcp-unofficial/build/index.js

Für Claude Desktop fügen Sie zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "recipal-mcp-unofficial": {
      "command": "node",
      "args": ["/absolute/path/to/recipal-mcp-unofficial/build/index.js"],
      "env": { "RECIPAL_API_KEY": "your_key_here" }
    }
  }
}

Starten Sie den Client neu und bitten Sie ihn dann, Ihre Rezepte aufzulisten. Sie sollten 19 verfügbare Tools sehen. Eine vollständige Anleitung finden Sie in docs/SETUP.md.

⚠️ Lesen Sie dies, bevor Sie es auf einen Katalog richten, der Ihnen wichtig ist

Die Schutzmechanismen confirm: true und dry_run werden vom Modell bereitgestellt, nicht von Ihnen. Sie verhindern, dass eine vage formulierte Eingabe Schaden anrichtet. Sie stoppen nicht einen entschlossenen oder verwirrten Agenten – ein Assistent, der beschließt, ein Rezept zu löschen, wird confirm: true im selben Aufruf übergeben. ReciPal hat keine Rückgängig-Funktion.

Aus diesem Grund sind die wirklich destruktiven Tools standardmäßig deaktiviert. Sie zu aktivieren ist eine bewusste Handlung der Person, die den Server betreibt, nicht etwas, das ein Gespräch tun kann:

Alles andere – alle Lesevorgänge und die normalen Erstellungs-/Aktualisierungswerkzeuge – funktioniert sofort. Die Massenwerkzeuge sind immer verfügbar, standardmäßig jedoch auf dry_run: true gesetzt und weigern sich auszuführen, es sei denn, der Aufrufer übergibt sowohl dry_run: false als auch confirm: true.

Unabhängig davon empfohlene Vorgehensweise: Arbeiten Sie zuerst mit einem Wegwerf-Rezept. Mehrere Endpunkte verhalten sich anders als in der Dokumentation beschrieben (siehe Bekannte Einschränkungen).

Konfiguration

Siehe .env.example.

Tools

Insgesamt 22 Tools, 19 standardmäßig verfügbar. Generierte Referenz mit jedem Parameter: docs/TOOLS.md.

† standardmäßig deaktiviert.

Schreibwerkzeuge verwenden ein offenes fields-Objekt anstelle einer festen Parameterliste. Die veröffentlichten ReciPal-Dokumente brechen vor der vollständigen Rezeptattributliste ab, daher hätte das Hartkodieren von Feldnamen Raten bedeutet; stattdessen wird fields direkt durchgereicht, Rails-artig form-encodiert (recipe[name]=...). Nicht dokumentierte Attribute funktionieren ohne Codeänderung. Setzen Sie as_json: true, wenn ein Endpunkt JSON bevorzugt.

Lesen Sie ein echtes Rezept, bevor Sie eines schreiben. get_recipe auf einem vorhandenen Rezept zeigt die genauen Attributnamen, die Ihr Konto verwendet.

Bekannte Einschränkungen

Diese sind real, gegen die Live-API verifiziert und wissenswert, bevor Sie darauf aufbauen:

• create_recipe_shortcut funktioniert nicht. Es gibt für jedes getestete Zutaten-Array-Format HTTP 422 zurück. Die ReciPal-Dokumentation bricht vor der Parameterliste ab, daher ist die korrekte Form unbekannt. Verwenden Sie create_recipe + create_recipe_ingredient oder scale_recipe, um eine konfigurierte Vorlage zu klonen. Das Tool bleibt vorhanden, damit die Form entdeckt werden kann – wenn Sie es herausfinden, eröffnen Sie bitte einen PR.

• PUT /recipe_ingredients/{id} ignoriert ingredient_id stillschweigend. Es gibt HTTP 200 zurück, wobei die ursprüngliche Zutat weiterhin angehängt ist. Das Austauschen einer Zutat gegen eine andere muss als Löschen-dann-Erstellen erfolgen, was bulk_clone_and_swap intern tut.

• ReciPal doppelt umhüllt fast jede Antwort – {recipe: {recipe_ingredients: [{recipe_ingredient: {…}}]}}. Das Lesen von Feldern aus der äußeren Hülle ergibt undefined ohne Fehler. Wenn Sie diesen Server erweitern, verwenden Sie die vorhandenen Hilfsfunktionen unwrap() / extractRecords().

• Parameternamen für scale_recipe und create_subrecipe sind nicht veröffentlicht. Sie funktionieren über durchgereichte fields, aber führen Sie sie jeweils einmal gegen ein Wegwerf-Rezept aus und lesen Sie die Antwort, bevor Sie Schleifen ausführen.

• Die Dokumentation listet /recipes/{id}/scale als PUT; POST ist das, was tatsächlich funktioniert. "Korrigieren" Sie das nicht ohne Tests.

• Kein Paginierungs-Helfer. list_recipes begrenzt auf 100 pro Seite; durchlaufen Sie die Seiten selbst.

Ratenbegrenzungen

ReciPal dokumentiert ungefähr 175.000 Anfragen pro Woche, 1.000 pro Minute (darüber hinaus HTTP 429) und maximal 5 gleichzeitige Etiketten-Renderings. Dieser Server respektiert 429 mit Retry-After und exponentiellem Backoff, warnt auf stderr, wenn weniger als 100 Anfragen verbleiben, und führt jede Massenschleife strikt sequenziell mit einer konfigurierbaren Verzögerung aus. Parallelisieren Sie keine Etiketten-Renderings.

Entwicklung

npm run typecheck   # tsc --noEmit
npm run build       # -> build/index.js
npm test            # offline smoke tests, no API key or network needed
npm run gen:docs    # regenerate docs/TOOLS.md from the running server
npm run verify      # all of the above

docs/TOOLS.md wird generiert, indem der gebaute Server gestartet und nach seiner eigenen Werkzeugliste gefragt wird, sodass die Referenz nicht vom Code abweichen kann. CI schlägt fehl, wenn sie veraltet ist. Wenn Sie ein Tool hinzufügen oder ändern, führen Sie npm run build && npm run gen:docs aus und committen Sie das Ergebnis.

Beiträge sind im oben genannten Rahmen willkommen – beginnen Sie mit CONTRIBUTING.md, dann docs/TESTING.md für die Verifizierung von Änderungen gegen ein Live-Konto und docs/DESIGN.md für das Zusammenspiel der Teile.

Lizenz

Apache-2.0.

"ReciPal" ist eine Marke ihres Inhabers und wird hier nur verwendet, um zu beschreiben, womit diese Software spricht.