Brewfather MCP

英語版ドキュメントを読む

これは個人のPC上で動作するModel Context Protocolサービスで、Brewfather API v2およびBrewfather 3.1公開ベータAPIを通じて、Brewfatherのレシピを読み取り、検索、作成、安全に変更できます。

このサービスはローカルの標準入出力で通信します。Brewfatherの認証情報はユーザー自身のPCにのみ保存されます。レシピの作成・変更前には、短時間有効なプレビュー確認トークンが必要です。このサービスは意図的にレシピ削除機能を提供していません。

最も簡単なインストール方法：AIアシスタントにインストールしてもらう（推奨）

このツールは主にターミナルコマンドに不慣れなホームブルワーを対象としています。ローカルターミナルにアクセスでき、Model Context ProtocolをサポートするAIアシスタント（Codex、Claude Code、Cursor、Visual Studio CodeのAIアシスタント、Gemini CLIなど）にインストールを任せることができます。

新しい会話を開始し、以下の文章をコピーしてエージェントに送信してください：

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

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

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

3. AIアシスタントが、このマシンからのみアクセス可能な認証ページを開きます。ページでBrewfatherのAPI IDとAPIキーを入力し、送信します。

4. インストールが完了したら、AIアシスタントを再起動するか新しい会話を開始し、次のように直接伝えます：

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

純粋なWebベースのAIアシスタントは、通常、あなたのコンピュータ上で動作するローカルサービスをインストールできません。ローカルプロジェクトとターミナルにアクセスできるデスクトップ版、IDE統合AIアシスタント、またはCLIベースのAIアシスタントを使用してください。

Related MCP server: Tandoor MCP Server

使用条件

• Node.js 20以降

• Brewfatherプレミアム、または有効なプレミアムトライアル

• レシピの作成・変更には、Brewfather 3.1公開ベータへの参加が必要

• recipes.read権限を持つBrewfather APIキー。レシピの書き込みにはrecipes.write権限も必要

ソースコードからのインストール

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

ローカル認証ページを開き、指定されたAIアシスタントにサービスを登録します：

brewfather-mcp install codex

設定ページは127.0.0.1のランダムなポートのみをリッスンします。読み取り専用リクエストで認証情報を検証し、認証情報をローカルに保存して自動的に終了します。Brewfatherの「設定 → API」でキーを生成してください。recipes.delete権限を付与する必要はありません。このサービスはその権限を使用しません。

認証情報の保存場所

認証情報はJSON形式で、OSのユーザー設定ディレクトリに保存されます：

BREWFATHER_MCP_CONFIGで別のパスを指定できます。Unix系OSでは、設定ディレクトリの権限は0700、設定ファイルの権限は0600に設定されます。ファイルには平文の認証情報が含まれているため、同期、共有、リポジトリへのコミットはしないでください。コンテナやCI環境では、BREWFATHER_USER_IDとBREWFATHER_API_KEYの環境変数を併用できます。

よく使うコマンド：

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

さまざまなAIアシスタントへのインストール

インストーラーは以下のAIアシスタントをサポートしています：

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

インストーラーは各AIアシスタントの公式CLIツールを使用します：

• 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は、他の互換クライアントで使用できる標準のmcpServers JSON設定を出力します。登録コマンドは現在のNode.js実行ファイルと本ソフトウェアのコンパイル済みエントリポイントの絶対パスを使用するため、AIアシスタントの設定にBrewfatherの認証情報が含まれることはありません。

新しい会話での使用

新しいAIアシスタントの会話を開始し、次のように伝えます：

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

レシピを変更する場合は、次のように伝えます：

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

利用可能なツール

• 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

Brewfatherが書き込み時にデータを拒否したり静かに変更したりするのを防ぐため、プレビュー生成時に以下のチェックが実行されます：

• Brewfatherの書き込みAPIは文字列のタグを受け付けません。既存のレシピから完全なタグオブジェクトをコピーする場合を除き、tagsは省略してください。

• 添加物の単位はg、mg、kg、ml、l、tsp、tbsp、pkg、items、dropsに限定されます。tabletやdoseなどの一般的な別名は自動的にitemsに変換されます。

• 麦芽にLovibond色度がありcolorがない場合、ツールは自動的にEBCを計算し、Brewfatherが色度を0として保存するのを防ぎます。

• すべての自動変換はプレビューのnormalizationsに一覧表示され、他の変更とともにユーザーの確認が必要です。

レシピ作成・変更用の確認トークンは10分で失効し、一度しか使用できません。レシピを変更する前に、サービスはレシピを再度読み取ります。プレビュー生成後にレシピが変更されていた場合、書き込みは拒否されます。

変更パラメータ内のネストされたオブジェクトはローカルでディープマージされます。Brewfatherのレシピ部分更新APIはトップレベルのフィールドのみをシャローマージするため、配列は完全に置き換えられます。変更前に現在のレシピを読み取り、完全なfermentables、hops、yeasts、miscs配列を渡してください。

Brewfatherの数値はすべてメートル法単位（リットル、キログラム、グラム、摂氏度、比重）を使用します。

開発

npm run typecheck
npm test
npm run build

ビルド完了後、Model Context Protocolインスペクターを実行できます：

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

プロトコル通信は標準出力を使用します。診断は標準エラーにのみ書き込まれ、認証ヘッダーとAPIキーはログに記録されません。

API仕様

• REST APIパスのバージョンは引き続き/v2です。レシピ書き込み機能はBrewfather 3.1公開ベータに属します。

• APIはHTTP基本認証を使用し、BrewfatherユーザーIDがユーザー名として使用されます。

• Brewfatherは現在、各キーにつき1時間あたり最大500回の呼び出しに制限しています。

• このサービスはレシピバージョンの作成、ロック、復元、ロールバック、削除機能を提供しません。

Brewfather APIドキュメントおよびバージョン3.1公開ベータの説明を参照してください。