关于 brewers-almanack
brewers-almanack 是为 AI 助手提供酿造参考数据和指导的 MCP 服务。内容涵盖风格、原料、异味诊断、水质、配方和食物搭配，数据内置于本地。
主要功能
- 01搜索 85 种 BJCP 啤酒风格
- 02搜索啤酒花、麦芽、酵母和辅料
- 03诊断异味并提供预防方法
- 04按城市或风格匹配水质
- 05按目标风格生成配方
- 06提供啤酒与食物搭配建议
适用场景
- 01判断黄油味等异味的成因
- 02查找适合某种啤酒风格的原料
- 03拟定包含谷物、酒花、酵母和水质的配方
- 04为啤酒选择食物搭配
MCP 相关
向 MCP 客户端提供六种酿造工具，支持风格和原料搜索、异味诊断、水质匹配、配方建议及搭配指导。酿造数据内置，无需 API 密钥或网络依赖。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
工具
6收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 要搜索的风格名称、类别或特征 |
详细介绍
酿酒师年鉴
酿酒知识 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 | 提供啤酒与食物搭配建议。按啤酒风格或菜名搜索，返回基于互补、对比和清口原则的搭配方案。 |
示例对话
“哪些啤酒花适合比利时双料啤酒？”
搜索适合比利时风格的啤酒花，返回 Styrian Goldings 和 Saaz 等品种，并提供 α 酸范围、香气和替代品。
“我的啤酒有黄油味，出了什么问题？”
诊断双乙酰问题：指出该化合物，解释成因（发酵不完全、过早转桶），并给出预防措施（双乙酰静置、健康酵母接种）。
“为西海岸 IPA 推荐一个配方”
制定完整配方：以淡色麦芽为基础，加入焦香麦芽，安排 Centennial/Cascade 啤酒花投放时间表并添加干投啤酒花，使用美式艾尔酵母，并采用伯顿风格的水质配置。
“世涛适合搭配什么食物？”
提供搭配建议（生蚝、巧克力甜点、烤肉），并说明每种搭配为何合适（互补、对比或清口）。
数据源
| 数据集 | 记录数 | 来源 | 许可 / 依据 |
|---|---|---|---|
| 啤酒风格 | 85 | BJCP 2021 Guidelines 经由 beerjson/bjcp-json | MIT；注明 BJCP 归属 |
| 啤酒花 | 113 | kasperg3/HopDatabase | MIT |
| 麦芽 | 38 | 根据已发布的麦芽制造商规格表汇编 | 事实数据 |
| 酵母 | 33 | 根据已发布的酵母实验室规格表汇编 | 事实数据 |
| 辅料 | 21 | 根据酿造文献汇编 | 事实数据 |
| 水质配置 | 20 | 根据酿造文献汇编 | 事实数据 |
| 异味 | 25 | 根据酿造科学文献汇编 | 事实数据 |
| 食物搭配 | 23 | 根据 Cicerone 课程和搭配指南汇编 | 事实数据 |
路线图
请参阅 ROADMAP.md，了解计划中的功能：酿造计算器、配方智能、BeerXML/BeerJSON 集成和酿造日志。
贡献
欢迎贡献，尤其是数据方面的贡献。增加更多啤酒花品种、酵母菌株、地区水质配置和食物搭配，能让所有人受益于更实用的服务。
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 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。