brewers-almanack について
brewers-almanackは、AIアシスタントに醸造の参考データとガイダンスを提供するMCPサーバーです。スタイル、原料、オフフレーバー診断、水質、レシピ、料理とのペアリングを扱い、データをローカルに内蔵しています。
主な機能
- 01BJCPのビアスタイル85種を検索
- 02ホップ、モルト、酵母、副原料を検索
- 03オフフレーバーと予防策を診断
- 04都市やスタイルに合う水質を検索
- 05指定スタイルのレシピを作成
- 06ビールと料理のペアリングを提案
活用シーン
- 01バター臭などの原因を特定
- 02ビアスタイルに合う原料を検索
- 03穀物、ホップ、酵母、水質を含むレシピを作成
- 04ビールに合う料理を選定
MCP 対応
スタイル・原料検索、診断、水質マッチング、レシピ提案、ペアリング案内を行う6つの醸造ツールをMCPクライアントに提供します。醸造データは内蔵されており、APIキーやネットワーク依存はありません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
6掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| query | string | はい | 検索するスタイル名、カテゴリー、または特徴 |
詳細
Brewers Almanack
醸造知識を提供する MCP サーバー:ビアスタイル、原材料、オフフレーバーの診断、水質化学、AI アシスタント向けのレシピガイダンス。
AI アシスタントにビアスタイルについて質問したり、オフフレーバーを診断したり、レシピを作成したり、水質プロファイルを照合したり、料理とのペアリングを提案したりできます(すべて幻覚ではなく、実際の醸造データに基づいています)。
6 つのツール。設定不要。MCP 対応 IDE で利用できます。
インストール
npx -y brewers-almanack
API キーもネットワーク依存関係も不要です。すべての醸造データが組み込まれています。
IDE に追加する
Claude Code
claude mcp add brewers-almanack -- npx -y brewers-almanack
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json(macOS)または %APPDATA%/Claude/claude_desktop_config.json(Windows)に追加します。
{
"mcpServers": {
"brewers-almanack": {
"command": "npx",
"args": ["-y", "brewers-almanack"]
}
}
}
Cursor
.cursor/mcp.json に追加します。
{
"mcpServers": {
"brewers-almanack": {
"command": "npx",
"args": ["-y", "brewers-almanack"]
}
}
}
VS Code (Copilot)
.vscode/mcp.json に追加します。
{
"servers": {
"brewers-almanack": {
"command": "npx",
"args": ["-y", "brewers-almanack"]
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json に追加します。
{
"mcpServers": {
"brewers-almanack": {
"command": "npx",
"args": ["-y", "brewers-almanack"]
}
}
}
Zed
settings.json に追加します。
{
"context_servers": {
"brewers-almanack": {
"command": {
"path": "npx",
"args": ["-y", "brewers-almanack"]
}
}
}
}
ツール
| ツール | 説明 |
|---|---|
search_styles | 名前、カテゴリー、特徴から 85 種類の BJCP ビアスタイルを検索します。主要な統計値、全体的な印象、原材料、市販品の例を返します。 |
search_ingredients | 名前、種類、特徴からホップ、モルト、酵母、副原料を検索します。カテゴリーで絞り込むことも、すべてを対象に検索することもできます。 |
diagnose_off_flavour | 味や香りの説明からオフフレーバーを特定します。原因となる可能性の高い化合物、原因、予防手順、許容される場合があるスタイルを返します。 |
match_water_profile | 都市名またはビアスタイルから醸造用水のプロファイルを検索します。ミネラル組成(Ca、Mg、Na、Cl、SO4、HCO3)とスタイルの推奨を返します。 |
suggest_recipe | 目標とするビアスタイルのレシピを生成します。穀物の配合、ホップの投入スケジュール、酵母の選択、水質プロファイル、工程パラメーターを返します。 |
pairing_guide | ビールと料理のペアリングを提案します。ビアスタイルまたは料理名から検索し、調和、対比、口直しの原則に基づいた組み合わせを返します。 |
会話例
「ベルジャン・デュベルにはどのホップが合いますか?」
ベルジャンスタイルに合うホップを原料データから検索し、スティリアン・ゴールディングスやザーツなどの品種について、アルファ酸の範囲、香り、代替品を返します。
「ビールがバターのような味です。何が原因でしょうか?」
ジアセチルが原因だと診断します。化合物を特定し、原因(発酵の未完了、早すぎる移送)を説明し、予防策(ジアセチルレスト、健全な酵母の投入)を提示します。
「ウエストコーストIPAのレシピを提案してください」
完全なレシピを作成します。クリスタルモルトを加えたペールモルトのベース、ドライホップを含むセンテニアル/カスケードのホップスケジュール、アメリカンエール酵母、バートンスタイルの水質プロファイルが含まれます。
「スタウトにはどんな料理が合いますか?」
ペアリングの提案(牡蠣、チョコレートデザート、グリルした肉)と、各ペアリングが合う理由(相乗、対比、口直し)を説明する原則を返します。
データソース
| データセット | レコード数 | ソース | ライセンス/根拠 |
|---|---|---|---|
| ビールスタイル | 85 | BJCP 2021 Guidelines(beerjson/bjcp-json経由) | MIT;BJCPの帰属表示 |
| ホップ | 113 | kasperg3/HopDatabase | MIT |
| モルト | 38 | 公開されているモルト製造業者の仕様書から編集 | 事実データ |
| 酵母 | 33 | 公開されている酵母ラボの仕様書から編集 | 事実データ |
| 副原料 | 21 | 醸造関連文献から編集 | 事実データ |
| 水質プロファイル | 20 | 醸造関連文献から編集 | 事実データ |
| オフフレーバー | 25 | 醸造科学の文献から編集 | 事実データ |
| 料理とのペアリング | 23 | Ciceroneのカリキュラムとペアリングガイドから編集 | 事実データ |
ロードマップ
予定されている機能(醸造計算ツール、レシピインテリジェンス、BeerXML/BeerJSON連携、醸造ジャーナル)については、ROADMAP.mdをご覧ください。
貢献
貢献を歓迎します。特にデータの提供を歓迎します。ホップの品種、酵母株、地域ごとの水質プロファイル、料理とのペアリングが増えるほど、このサーバーは誰にとっても便利になります。
git clone https://github.com/gregario/brewers-almanack.git
cd brewers-almanack
npm install
npm run build
npm test # 73 tests
ローカルでの実行
claude mcp add brewers-almanack-dev -- node /path/to/brewers-almanack/dist/index.js
特に貢献が必要な分野については、ROADMAP.mdをご覧ください。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。