English Français العربية

io.github.gregario/brewers-almanack

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package brewers-almanack
Claude Code 
claude mcp add brewers-almanack -- npx -y brewers-almanack@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "brewers-almanack": {
            "command": "npx",
            "args": [
                "-y",
                "brewers-almanack@0.1.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Brewers Almanack
  2. Install
  3. Tools
  4. Example Conversations
  5. Data Sources
  6. Roadmap
  7. Contributing
  8. Licence

Brewers Almanack

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

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.

Install

npx -y brewers-almanack

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

Add to your IDE

Claude Code

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):

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

Cursor

Add to .cursor/mcp.json:

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

VS Code (Copilot)

Add to .vscode/mcp.json:

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

Windsurf

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

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

Zed

Add to settings.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.

git clone https://github.com/gregario/brewers-almanack.git
cd brewers-almanack
npm install
npm run build
npm test        # 73 tests
Running locally
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

الأسئلة الشائعة

ما هو io.github.gregario/brewers-almanack؟

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

كيف أثبّت io.github.gregario/brewers-almanack؟

يعمل على جهازك. في Claude Code: claude mcp add brewers-almanack -- npx -y brewers-almanack@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.gregario/brewers-almanack إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.gregario/brewers-almanack مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.gregario/brewers-almanack؟

ينشره gregario. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.