Brewfather MCP

Das englische Dokument lesen

Dies ist ein Modellkontext-Protokoll-Dienst, der auf Ihrem persönlichen Computer läuft und über die Brewfather-API v2 und die öffentliche Test-Schnittstelle von Brewfather 3.1 Rezepte lesen, durchsuchen, erstellen und sicher ändern kann.

Der Dienst kommuniziert über lokale Standard-Ein-/Ausgabe. Brewfather-Anmeldedaten werden nur auf dem eigenen Computer des Benutzers gespeichert. Vor dem Erstellen und Ändern von Rezepten muss ein kurzzeitig gültiger Bestätigungstoken für die Vorschau verwendet werden. Dieser Dienst bietet bewusst keine Funktion zum Löschen von Rezepten.

Der einfachste Weg zur Installation: Lassen Sie Ihren KI-Assistenten die Installation durchführen (empfohlen)

Dieses Tool richtet sich hauptsächlich an Hobbybrauer, die mit Terminalbefehlen nicht vertraut sind. Sie können einen KI-Assistenten, der Zugriff auf das lokale Terminal hat und das Modellkontext-Protokoll unterstützt, die Installation durchführen lassen, z. B. Codex, Claude Code, Cursor, den KI-Assistenten in Visual Studio Code oder das Gemini-Befehlszeilentool.

Erstellen Sie einen neuen Chat und kopieren Sie den folgenden Text an den Agenten:

请帮我安装当前项目中的 brewfather-mcp，并注册到我正在使用的agent。

请你：
1. 检查本机是否有 Node.js 20 或更高版本；
2. 在当前项目目录安装依赖、构建项目并安装 brewfather-mcp 命令；
3. 自动识别我正在使用的智能助手，运行对应的 brewfather-mcp install 命令；
4. 如果打开本机授权页面，让我自己在页面中输入 Brewfather 用户编号和应用程序接口密钥。不要让我把密钥发到对话里，也不要输出或读取密钥内容；
5. 等我提交授权页面后，运行 brewfather-mcp doctor，并检查模型上下文协议服务是否已成功注册。

请直接开始执行；只有在必须由我操作授权页面时再提醒我。

3. Der KI-Assistent öffnet eine nur lokal zugängliche Autorisierungsseite. Geben Sie auf der Seite die Brewfather-API-ID und den API-Schlüssel ein und senden Sie sie ab.

4. Starten Sie nach erfolgreicher Installation den KI-Assistenten neu oder erstellen Sie einen neuen Chat und sagen Sie dann einfach:

使用 Brewfather 工具列出我最近的 5 个配方。

Reine Web-KI-Assistenten können in der Regel keine lokalen Dienste installieren, die auf Ihrem Computer ausgeführt werden. Bitte verwenden Sie einen Desktop-KI-Assistenten, einen IDE-KI-Assistenten oder einen Befehlszeilen-KI-Assistenten, der Zugriff auf lokale Projekte und das Terminal hat.

Related MCP server: Tandoor MCP Server

Voraussetzungen

• Node.js 20 oder höher

• Brewfather Premium oder eine gültige Premium-Testversion

• Für das Erstellen oder Ändern von Rezepten ist die Teilnahme am öffentlichen Test von Brewfather 3.1 erforderlich

• Ein Brewfather-API-Schlüssel mit der Berechtigung recipes.read; zum Schreiben von Rezepten ist zusätzlich die Berechtigung recipes.write erforderlich

Installation aus dem Quellcode

cd /path/to/brewfather-mcp
npm install
npm run build
npm link

Öffnen Sie die lokale Anmeldeseite und registrieren Sie den Dienst beim angegebenen KI-Assistenten:

brewfather-mcp install codex

Die Einstellungsseite lauscht nur auf 127.0.0.1 an einem zufälligen Port. Sie überprüft die Anmeldedaten über schreibgeschützte Anfragen, speichert die Anmeldedaten lokal und beendet sich dann automatisch. Generieren Sie den Schlüssel unter „Einstellungen → API" in Brewfather. Es ist nicht erforderlich, die Berechtigung recipes.delete zu erteilen; dieser Dienst verwendet sie nicht.

Speicherort der Anmeldedaten

Die Anmeldedaten werden im JSON-Format im Benutzerkonfigurationsverzeichnis des Betriebssystems gespeichert:

Über BREWFATHER_MCP_CONFIG kann ein anderer Pfad angegeben werden. Auf Unix-ähnlichen Systemen ist die Berechtigung des Konfigurationsverzeichnisses auf 0700 und die der Konfigurationsdatei auf 0600 gesetzt. Die Datei enthält Klartext-Anmeldedaten; synchronisieren, teilen oder committen Sie sie nicht in ein Versionsverwaltungs-Repository. Container- und CI-Umgebungen können gleichzeitig die Umgebungsvariablen BREWFATHER_USER_ID und BREWFATHER_API_KEY verwenden.

Häufige Befehle:

brewfather-mcp setup
brewfather-mcp doctor
brewfather-mcp config path
brewfather-mcp auth logout

Installation in verschiedene KI-Assistenten

Das Installationsprogramm unterstützt die folgenden KI-Assistenten:

brewfather-mcp install codex
brewfather-mcp install claude
brewfather-mcp install cursor
brewfather-mcp install vscode
brewfather-mcp install gemini
brewfather-mcp install all
brewfather-mcp install generic

Das Installationsprogramm verwendet nach Möglichkeit die offiziellen Befehlszeilentools der jeweiligen KI-Assistenten:

• Codex: codex mcp add

• Claude Code: claude mcp add --scope user

• Cursor: agent mcp add

• Visual Studio Code: code --add-mcp

• Gemini: gemini mcp add --scope user

generic gibt die standardmäßige mcpServers-JSON-Konfiguration für andere kompatible Clients aus. Der Registrierungsbefehl verwendet den absoluten Pfad der aktuellen Node.js-Ausführungsdatei und des kompilierten Einstiegspunkts dieser Software, sodass in der KI-Assistenten-Konfiguration keine Brewfather-Anmeldedaten erscheinen.

Verwendung in einem neuen Chat

Erstellen Sie einen neuen KI-Assistenten-Chat und sagen Sie:

使用 Brewfather 工具列出我最近的 5 个配方，只读取，不要修改。

Zum Ändern eines Rezepts können Sie sagen:

使用 Brewfather 工具找到“West Coast IPA”，把其中的 Citra 干投增加 20 克。先显示修改预览，等我明确确认后再写入。

Verfügbare Werkzeuge

• brewfather_connection_status

• brewfather_list_recipes

• brewfather_search_recipes

• brewfather_get_recipe

• brewfather_preview_recipe_create

• brewfather_apply_recipe_create

• brewfather_preview_recipe_update

• brewfather_apply_recipe_update

Um zu vermeiden, dass Brewfather Daten beim Schreiben ablehnt oder stillschweigend verändert, werden bei der Erstellung der Vorschau folgende Prüfungen durchgeführt:

• Die Brewfather-Schreibschnittstelle akzeptiert keine String-Tags. Sofern nicht die vollständigen Tag-Objekte aus einem vorhandenen Rezept kopiert werden, sollte tags weggelassen werden.

• Die Einheiten für Zusatzstoffe sind auf g, mg, kg, ml, l, tsp, tbsp, pkg, items oder drops beschränkt. Häufige Aliase wie tablet und dose werden automatisch in items umgewandelt.

• Wenn Malz nur einen Lovibond-Farbwert ohne color hat, berechnet das Werkzeug automatisch den EBC, um zu vermeiden, dass Brewfather den Farbwert als 0 speichert.

• Alle automatischen Umwandlungen werden in den normalizations der Vorschau aufgelistet und sollten zusammen mit anderen Änderungen vom Benutzer bestätigt werden.

Die Bestätigungstoken zum Erstellen und Ändern von Rezepten verfallen nach zehn Minuten und können nur einmal verwendet werden. Vor dem Ändern eines Rezepts liest der Dienst das Rezept erneut; wenn sich das Rezept nach der Erstellung der Vorschau geändert hat, wird dieser Schreibvorgang abgelehnt.

Verschachtelte Objekte in den Änderungsparametern werden lokal tief zusammengeführt. Da die Brewfather-Schnittstelle für partielle Rezeptaktualisierungen nur eine flache Zusammenführung auf oberster Ebene durchführt, werden Arrays vollständig ersetzt. Lesen Sie vor dem Ändern das aktuelle Rezept und übergeben Sie die vollständigen fermentables-, hops-, yeasts- oder miscs-Arrays.

Brewfather-Werte verwenden einheitlich metrische Einheiten: Liter, Kilogramm, Gramm, Grad Celsius und spezifisches Gewicht.

Entwicklung

npm run typecheck
npm test
npm run build

Nach Abschluss des Builds kann der Modellkontext-Protokoll-Inspektor ausgeführt werden:

npx @modelcontextprotocol/inspector node dist/cli.js serve

Die Protokollkommunikation verwendet die Standardausgabe. Diagnose wird nur auf die Standardfehlerausgabe geschrieben; Autorisierungsheader und API-Schlüssel werden nicht protokolliert.

Schnittstellenhinweise

• Der Pfad der REST-Schnittstelle ist weiterhin /v2; die Rezept-Schreibfunktion gehört zum öffentlichen Test von Brewfather 3.1.

• Die API verwendet HTTP-Basisauthentifizierung, wobei die Brewfather-Benutzer-ID als Benutzername dient.

• Brewfather begrenzt derzeit jede Schlüssel auf maximal 500 Aufrufe pro Stunde.

• Dieser Dienst bietet keine Funktionen zum Erstellen, Sperren, Wiederherstellen, Zurücksetzen oder Löschen von Rezeptversionen.

Siehe Brewfather-API-Dokumentation und Hinweise zum öffentlichen Test von Version 3.1.