mcpField
B
brewers-almanack

brewers-almanack

ローカル
github.com/gregarioゲーム・エンタメ32 日前に更新

brewers-almanack について

brewers-almanackは、AIアシスタントに醸造の参考データとガイダンスを提供するMCPサーバーです。スタイル、原料、オフフレーバー診断、水質、レシピ、料理とのペアリングを扱い、データをローカルに内蔵しています。

主な機能

  1. 01BJCPのビアスタイル85種を検索
  2. 02ホップ、モルト、酵母、副原料を検索
  3. 03オフフレーバーと予防策を診断
  4. 04都市やスタイルに合う水質を検索
  5. 05指定スタイルのレシピを作成
  6. 06ビールと料理のペアリングを提案

活用シーン

  1. 01バター臭などの原因を特定
  2. 02ビアスタイルに合う原料を検索
  3. 03穀物、ホップ、酵母、水質を含むレシピを作成
  4. 04ビールに合う料理を選定

MCP 対応

スタイル・原料検索、診断、水質マッチング、レシピ提案、ペアリング案内を行う6つの醸造ツールをMCPクライアントに提供します。醸造データは内蔵されており、APIキーやネットワーク依存はありません。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"gregario-brewers-almanack": {
"command": "npx",
"args": [
"-y",
"brewers-almanack"
]
}
}
}
起動コマンドnpx -y brewers-almanack

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmbrewers-almanack0.1.0

ツール

6

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
querystringはい検索するスタイル名、カテゴリー、または特徴

詳細

Brewers Almanack

醸造知識を提供する MCP サーバー:ビアスタイル、原材料、オフフレーバーの診断、水質化学、AI アシスタント向けのレシピガイダンス。

npm のバージョン npm のダウンロード数 MIT ライセンス Node.js 18+ MCP 対応 brewers-almanack MCP サーバー


AI アシスタントにビアスタイルについて質問したり、オフフレーバーを診断したり、レシピを作成したり、水質プロファイルを照合したり、料理とのペアリングを提案したりできます(すべて幻覚ではなく、実際の醸造データに基づいています)。

6 つのツール。設定不要。MCP 対応 IDE で利用できます。

Brewers almanack MCP server

インストール

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のレシピを提案してください」

完全なレシピを作成します。クリスタルモルトを加えたペールモルトのベース、ドライホップを含むセンテニアル/カスケードのホップスケジュール、アメリカンエール酵母、バートンスタイルの水質プロファイルが含まれます。

「スタウトにはどんな料理が合いますか?」

ペアリングの提案(牡蠣、チョコレートデザート、グリルした肉)と、各ペアリングが合う理由(相乗、対比、口直し)を説明する原則を返します。

データソース

データセットレコード数ソースライセンス/根拠
ビールスタイル85BJCP 2021 Guidelines(beerjson/bjcp-json経由)MIT;BJCPの帰属表示
ホップ113kasperg3/HopDatabaseMIT
モルト38公開されているモルト製造業者の仕様書から編集事実データ
酵母33公開されている酵母ラボの仕様書から編集事実データ
副原料21醸造関連文献から編集事実データ
水質プロファイル20醸造関連文献から編集事実データ
オフフレーバー25醸造科学の文献から編集事実データ
料理とのペアリング23Ciceroneのカリキュラムとペアリングガイドから編集事実データ

ロードマップ

予定されている機能(醸造計算ツール、レシピインテリジェンス、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をご覧ください。

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。