A brewing knowledge MCP server: beer styles, ingredients, off-flavour diagnosis, water chemistry, and recipe guidance for AI assistants.
\n\n\n
\n \n \n \n \n \n \n
\n\n---\n\nAsk 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).\n\n**6 tools. Zero config. Works with every MCP-compatible IDE.**\n\n[](https://glama.ai/mcp/servers/gregario/brewers-almanack)\n\n## Install\n\n```bash\nnpx -y brewers-almanack\n```\n\nNo API keys, no network dependencies. All brewing data is embedded.\n\n### Add to your IDE\n\n\nClaude Code\n\n```bash\nclaude mcp add brewers-almanack -- npx -y brewers-almanack\n```\n\n\n\nClaude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%/Claude/claude_desktop_config.json` (Windows):\n```json\n{\n \"mcpServers\": {\n \"brewers-almanack\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"brewers-almanack\"]\n }\n }\n}\n```\n\n\n\nCursor\n\nAdd to `.cursor/mcp.json`:\n```json\n{\n \"mcpServers\": {\n \"brewers-almanack\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"brewers-almanack\"]\n }\n }\n}\n```\n\n\n\nVS Code (Copilot)\n\nAdd to `.vscode/mcp.json`:\n```json\n{\n \"servers\": {\n \"brewers-almanack\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"brewers-almanack\"]\n }\n }\n}\n```\n\n\n\nWindsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n```json\n{\n \"mcpServers\": {\n \"brewers-almanack\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"brewers-almanack\"]\n }\n }\n}\n```\n\n\n\nZed\n\nAdd to `settings.json`:\n```json\n{\n \"context_servers\": {\n \"brewers-almanack\": {\n \"command\": {\n \"path\": \"npx\",\n \"args\": [\"-y\", \"brewers-almanack\"]\n }\n }\n }\n}\n```\n\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_styles` | Search 85 BJCP beer styles by name, category, or characteristics. Returns vital statistics, overall impression, ingredients, and commercial examples. |\n| `search_ingredients` | Search hops, malts, yeasts, and adjuncts by name, type, or characteristic. Filter by category or search across all. |\n| `diagnose_off_flavour` | Identify off-flavours from taste or aroma descriptions. Returns the likely compound, causes, prevention steps, and styles where it may be acceptable. |\n| `match_water_profile` | Find brewing water profiles by city name or beer style. Returns mineral composition (Ca, Mg, Na, Cl, SO4, HCO3) and style recommendations. |\n| `suggest_recipe` | Generate a recipe for a target beer style. Returns grain bill, hop schedule, yeast selection, water profile, and process parameters. |\n| `pairing_guide` | Beer and food pairing suggestions. Search by beer style or dish name. Returns matches with complement, contrast, and cleanse principles. |\n\n## Example Conversations\n\n**\"What hops work in a Belgian Dubbel?\"**\n> Searches ingredients for hops that complement Belgian styles, returning varieties like Styrian Goldings and Saaz with alpha acid ranges, aromas, and substitutes.\n\n**\"My beer tastes like butter, what went wrong?\"**\n> Diagnoses diacetyl: identifies the compound, explains causes (incomplete fermentation, premature racking), and gives prevention steps (diacetyl rest, healthy yeast pitch).\n\n**\"Suggest a recipe for a West Coast IPA\"**\n> 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.\n\n**\"What food pairs well with a stout?\"**\n> Returns pairing suggestions (oysters, chocolate desserts, grilled meats) with principles explaining why each pairing works (complement, contrast, or cleanse).\n\n## Data Sources\n\n| Dataset | Records | Source | Licence / Basis |\n|---------|---------|--------|-----------------|\n| Beer styles | 85 | [BJCP 2021 Guidelines](https://www.bjcp.org/style/2021/beer/) via [beerjson/bjcp-json](https://github.com/beerjson/bjcp-json) | MIT; BJCP attribution |\n| Hops | 113 | [kasperg3/HopDatabase](https://github.com/kasperg3/HopDatabase) | MIT |\n| Malts | 38 | Compiled from published maltster spec sheets | Factual data |\n| Yeasts | 33 | Compiled from published yeast lab spec sheets | Factual data |\n| Adjuncts | 21 | Compiled from brewing literature | Factual data |\n| Water profiles | 20 | Compiled from brewing literature | Factual data |\n| Off-flavours | 25 | Compiled from brewing science literature | Factual data |\n| Food pairings | 23 | Compiled from Cicerone curriculum and pairing guides | Factual data |\n\n## Roadmap\n\nSee [ROADMAP.md](ROADMAP.md) for planned features: brewing calculators, recipe intelligence, BeerXML/BeerJSON integration, and a brewing journal.\n\n## Contributing\n\nContributions are welcome, especially data contributions. More hop varieties, yeast strains, regional water profiles, and food pairings make the server more useful for everyone.\n\n```bash\ngit clone https://github.com/gregario/brewers-almanack.git\ncd brewers-almanack\nnpm install\nnpm run build\nnpm test # 73 tests\n```\n\n### Running locally\n\n```bash\nclaude mcp add brewers-almanack-dev -- node /path/to/brewers-almanack/dist/index.js\n```\n\nSee [ROADMAP.md](ROADMAP.md) for areas where contributions are most needed.\n\n## Licence\n\n[MIT](LICENSE)",
"bytes": 6692,
"sha": "f7e13f6a8917ca20e9fc6fb08841f29b90841b4348204cfdaf125600ad0d2759",
"repo_slug": "gregario/brewers-almanack",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_gregario_brewers_almanack_fd699846/readme"
}
![\"npm](\"https://img.shields.io/npm/v/brewers-almanack.svg\")
\n ![\"npm](\"https://img.shields.io/npm/dm/brewers-almanack.svg\")
\n ![\"MIT](\"https://img.shields.io/badge/license-MIT-blue.svg\"){kind=icon}
\n ![\"Node.js](\"https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg\"){kind=icon}
\n ![\"MCP](\"https://img.shields.io/badge/MCP-compatible-purple.svg\"){kind=icon}
\n ![\"brewers-almanack](\"https://glama.ai/mcp/servers/gregario/brewers-almanack/badges/score.svg\")
\n