Brewers Almanack

io.github.gregario由 GitHub 帳號 gregario 發布v0.1.0更新於 Oct 24, 2026

Brewing knowledge MCP — beer styles, ingredients, off-flavours, water chemistry, recipes

發布方自己的服務：Almanack

已驗證STDIO僅桌面位置與生活知識與記憶

概覽

AI 產生的概覽

一個本機 MCP 伺服器，為 AI 助理提供內建的釀造知識：啤酒風格、原料、異味診斷、水質設定、配方與餐酒搭配。

可以做什麼
依名稱、類別或特徵檢索 85 種 BJCP 啤酒風格，回傳關鍵參數與商業範例。依名稱、類型或特徵查詢啤酒花、麥芽、酵母與輔料。依味道或香氣描述診斷異味，給出可能化合物、成因與預防措施。依城市或啤酒風格比對釀造水質設定及礦物組成。為目標風格產生配方，含穀物配比、酒花投放、酵母與水質。依風格或菜色推薦啤酒與食物搭配。
適用情境
適合自釀愛好者與啤酒愛好者，讓助理依據固定的內建資料集而非模型泛化知識回答風格、原料、水質、配方與搭配問題。也適合依味道或香氣描述判斷某批酒出了什麼狀況。
執行需求
透過 npx 以本機程序執行（需要 Node.js）。不需 API 金鑰、環境變數或網路存取，所有資料皆已內建。需在所用用戶端的 MCP 設定中配置。
安裝前請注意
僅提供唯讀參考查詢，不涉及帳號、憑證或付款。配方與診斷來自彙編的釀造文獻，屬一般性建議，不能取代實際測量或安全建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Brewers Almanack，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Brewers Almanack

A brewing knowledge MCP server: beer styles, ingredients, off-flavour diagnosis, water chemistry, and recipe guidance for AI assistants.

[npm version] [npm downloads] [MIT Licence] [Node.js 18+] [MCP Compatible] [brewers-almanack MCP server]

Ask your AI assistant about beer styles, diagnose off-flavours, build recipes, match water profiles, and pair food (all backed by real brewing data, not hallucinations).

6 tools. Zero config. Works with every MCP-compatible IDE.

[Brewers almanack MCP server]

Install

bash
npx -y brewers-almanack

No API keys, no network dependencies. All brewing data is embedded.

Add to your IDE

Claude Code
bash
claude mcp add brewers-almanack -- npx -y brewers-almanack
Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "brewers-almanack": {      "command": "npx",      "args": ["-y", "brewers-almanack"]    }  }}
Cursor

Add to .cursor/mcp.json:

json
{  "mcpServers": {    "brewers-almanack": {      "command": "npx",      "args": ["-y", "brewers-almanack"]    }  }}
VS Code (Copilot)

Add to .vscode/mcp.json:

json
{  "servers": {    "brewers-almanack": {      "command": "npx",      "args": ["-y", "brewers-almanack"]    }  }}
Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "brewers-almanack": {      "command": "npx",      "args": ["-y", "brewers-almanack"]    }  }}
Zed

Add to settings.json:

json
{  "context_servers": {    "brewers-almanack": {      "command": {        "path": "npx",        "args": ["-y", "brewers-almanack"]      }    }  }}

Tools

ToolDescription
search_stylesSearch 85 BJCP beer styles by name, category, or characteristics. Returns vital statistics, overall impression, ingredients, and commercial examples.
search_ingredientsSearch hops, malts, yeasts, and adjuncts by name, type, or characteristic. Filter by category or search across all.
diagnose_off_flavourIdentify off-flavours from taste or aroma descriptions. Returns the likely compound, causes, prevention steps, and styles where it may be acceptable.
match_water_profileFind brewing water profiles by city name or beer style. Returns mineral composition (Ca, Mg, Na, Cl, SO4, HCO3) and style recommendations.
suggest_recipeGenerate a recipe for a target beer style. Returns grain bill, hop schedule, yeast selection, water profile, and process parameters.
pairing_guideBeer and food pairing suggestions. Search by beer style or dish name. Returns matches with complement, contrast, and cleanse principles.

Example Conversations

"What hops work in a Belgian Dubbel?"

Searches ingredients for hops that complement Belgian styles, returning varieties like Styrian Goldings and Saaz with alpha acid ranges, aromas, and substitutes.

"My beer tastes like butter, what went wrong?"

Diagnoses diacetyl: identifies the compound, explains causes (incomplete fermentation, premature racking), and gives prevention steps (diacetyl rest, healthy yeast pitch).

"Suggest a recipe for a West Coast IPA"

Builds a complete recipe: pale malt base with crystal malt, Centennial/Cascade hop schedule with dry hop additions, American ale yeast, and a Burton-style water profile.

"What food pairs well with a stout?"

Returns pairing suggestions (oysters, chocolate desserts, grilled meats) with principles explaining why each pairing works (complement, contrast, or cleanse).

Data Sources

DatasetRecordsSourceLicence / Basis
Beer styles85BJCP 2021 Guidelines via beerjson/bjcp-jsonMIT; BJCP attribution
Hops113kasperg3/HopDatabaseMIT
Malts38Compiled from published maltster spec sheetsFactual data
Yeasts33Compiled from published yeast lab spec sheetsFactual data
Adjuncts21Compiled from brewing literatureFactual data
Water profiles20Compiled from brewing literatureFactual data
Off-flavours25Compiled from brewing science literatureFactual data
Food pairings23Compiled from Cicerone curriculum and pairing guidesFactual data

Roadmap

See ROADMAP.md for planned features: brewing calculators, recipe intelligence, BeerXML/BeerJSON integration, and a brewing journal.

Contributing

Contributions are welcome, especially data contributions. More hop varieties, yeast strains, regional water profiles, and food pairings make the server more useful for everyone.

bash
git clone https://github.com/gregario/brewers-almanack.gitcd brewers-almanacknpm installnpm run buildnpm test        # 73 tests

Running locally

bash
claude mcp add brewers-almanack-dev -- node /path/to/brewers-almanack/dist/index.js

See ROADMAP.md for areas where contributions are most needed.

Licence

MIT

來源：README.md，提交 cc12713

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Almanack 整合

Almanack

dev.almanack官方發布者

讓助理對虛構或自訂曆法進行精確日期運算，並渲染 SVG 日曆。

Streamable HTTP可網頁執行
效率與工作流尚未收錄Oct 24, 2026