gregario/brewers-almanack

gregario/brewers-almanack

от gregario
MCP-сервер для AI-ассистентов с реальными данными по пивоварению: поиск 85 стилей BJCP, ингредиентов, диагностика офф-флейворов, подбор водного профиля и рецептов. Встроенная база выдаёт точные отв...

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

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"]
    }
  }
}
Инструменты были проиндексированы:
calculate_ibu

Вычисляет международные единицы горечи по формуле Тинсета. Принимает объём партии, начальную плотность и список добавок хмеля с весом, содержанием альфа-кислоты в процентах и временем кипячения.

Рассчитывает IBU

Параметры
  • batch_volume_litresnumberобязательный

    Конечный объём партии в литрах

  • hop_additionsobject[]обязательный

    Список добавлений хмеля

  • original_gravitynumberобязательный

    Начальная плотность (например, 1.065)

calculate_water_additions

Вычисляет количество добавляемых минеральных солей, необходимое для корректировки пивоваренной воды от исходного профиля к целевому. Поддерживает именованные профили или пользовательские значения ионов.

Рассчитывает добавление воды.

Параметры
  • source_bicarbonatenumber

    Исходный бикарбонат (ppm)

  • source_calciumnumber

    Исходный кальций (ppm)

  • source_chloridenumber

    Хлорид источника (ppm)

  • source_magnesiumnumber

    Источник магния (ppm)

  • source_profilestring

    Именованный профиль исходной воды (например, 'Обратный осмос', 'Дублин')

  • source_sodiumnumber

    Исходный натрий (ppm)

  • source_sulfatenumber

    Сульфат источника (ppm)

  • target_bicarbonatenumber

    Целевой бикарбонат (ppm)

  • target_calciumnumber

    Целевой кальций (ppm)

  • target_chloridenumber

    Целевой хлорид (ppm)

  • target_magnesiumnumber

    Целевой уровень магния (ppm)

  • target_profilestring

    Именованный целевой профиль воды (например, 'Burton-on-Trent', 'Pilsen')

  • target_sodiumnumber

    Целевая концентрация натрия (ppm)

  • target_sulfatenumber

    Целевое содержание сульфата (ppm)

  • volume_litresnumberобязательный

    Объём воды в литрах.

check_geb_stock

Проверяет GetErBrewed.com custom kit builder инвентарь на наличие и цены ингредиентов. Данные обновляются еженедельно. Если товара нет в наличии, предлагает замену.

Проверяет акции GEB

Параметры
  • categorystring

    Фильтрует по категории (например, 'T90 Hops', 'Base Malt', 'Dried Yeast')

  • querystringобязательный

    Ингредиент для поиска (например, 'Citra', 'Maris Otter', 'US-05')

diagnose_off_flavour

Диагностирует посторонние привкусы пива по описаниям вкуса или аромата. Возвращает вероятное соединение, причины, шаги по предотвращению, порог обнаружения и стили, в которых это может быть приемлемо.

Диагностирует посторонний привкус

Параметры
  • descriptionstringобязательный

    Опишите вкус или аромат постороннего привкуса.

match_water_profile

Находит профили воды для пивоварения по названию города или стилю пива. Возвращает минеральный состав (Ca, Mg, Na, Cl, SO4, HCO3) и рекомендации по стилю.

Сопоставляет водный профиль

Параметры
  • querystringобязательный

    Название города или стиль пива для поиска водного профиля

pairing_guide

Получает предложения по сочетанию пива и еды. Выполняет поиск по стилю пива или названию блюда. Возвращает совпадения сочетаний по принципам дополнения, контраста и очищения.

Руководство по подбору пар

Параметры
  • querystringобязательный

    Стиль пива или название блюда для поиска сочетаний

review_recipe

Проверяет рецепт пива на соответствие руководствам стилей BJCP. Сравнивает OG, FG, IBU, SRM и ABV с ключевыми показателями стиля и возвращает оценочную таблицу.

Проверяет рецепт

Параметры
  • abvnumberобязательный

    Процентное содержание алкоголя по объёму.

  • fgnumberобязательный

    Конечная плотность (например, 1.012)

  • ibunumberобязательный

    Международные единицы горечи

  • ognumberобязательный

    Начальная плотность (например, 1.065)

  • srmnumberобязательный

    Standard Reference Method (цвет)

  • stylestringобязательный

    Целевой стиль пива для проверки (например, 'American IPA', 'Black IPA')

search_ingredients

Ищет ингредиенты для пивоварения (хмель, солод, дрожжи, добавки) по названию, типу или характеристике. Возвращает подробные свойства, такие как альфа-кислоты, цвет, атенюация и вкусовые профили.

Search Brewing Ingredients

Параметры
  • categoryenum

    Категория ингредиента, в которой выполняется поиск

  • querystringобязательный

    Название ингредиента, тип или характеристика для поиска

search_styles

Ищет стили пива BJCP по названию, категории или характеристикам. Возвращает ключевые показатели, общее впечатление, типичные ингредиенты и коммерческие примеры.

Search Beer Styles

Параметры
  • querystringобязательный

    Название стиля, категория или характеристика для поиска.

suggest_recipe

Предлагает рецепт пива для целевого стиля. Возвращает состав солода, график хмеля, выбор дрожжей и параметры процесса.

Предлагает рецепт

Параметры
  • batch_size_litresnumber

    Размер партии в литрах.

  • stylestringобязательный

    Целевой стиль пива для рецепта

suggest_substitution

Находит заменители для ингредиента пивоварения (хмель, солод или дрожжи). Предлагает альтернативы с похожими характеристиками, показывая ключевые свойства для сравнения.

Предлагает замену ингредиента

Параметры
  • ingredientstringобязательный

    Название ингредиента, для которого нужно найти заменители (например, 'Citra', 'Maris Otter', 'US-05')

  • rolestring

    Роль в рецепте для контекста (например, «горечь», «аромат», «основа», «специальный»)

  • stylestring

    Целевой стиль пива для контекста (например, 'American IPA', 'Stout')

0.2.18основная
0.2.17
0.2.16
0.2.15
0.2.14
0.2.13
0.2.12
0.2.11
0.2.10
0.2.9
0.2.8
0.2.7
0.2.6
0.2.5
0.2.4
0.2.3
0.2.2
0.2.1
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить gregario/brewers-almanack:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "gregario-brewers-almanack-xwl6kdchcw": {
      "command": "npx",
      "args": [
        "-y",
        "brewers-almanack"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "gregario-brewers-almanack-xwl6kdchcw": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "brewers-almanack"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"gregario-brewers-almanack-xwl6kdchcw\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"brewers-almanack\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "gregario-brewers-almanack-xwl6kdchcw": {
      "command": "npx",
      "args": [
        "-y",
        "brewers-almanack"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add gregario-brewers-almanack-xwl6kdchcw -- npx -y brewers-almanack

Либо через JSON-конфиг:

claude mcp add-json gregario-brewers-almanack-xwl6kdchcw "{\"command\":\"npx\",\"args\":[\"-y\",\"brewers-almanack\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add gregario-brewers-almanack-xwl6kdchcw -- npx -y brewers-almanack

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.gregario-brewers-almanack-xwl6kdchcw]
command = "npx"
args = ["-y", "brewers-almanack"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите gregario/brewers-almanack, а в поле команды запуска — строку ниже:
npx -y brewers-almanack

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "gregario-brewers-almanack-xwl6kdchcw": {
      "command": "npx",
      "args": [
        "-y",
        "brewers-almanack"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например gregario-brewers-almanack-xwl6kdchcw.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: gregario-brewers-almanack-xwl6kdchcw
    command: npx
    args:
      - "-y"
      - "brewers-almanack"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "gregario-brewers-almanack-xwl6kdchcw": {
      "command": "npx",
      "args": [
        "-y",
        "brewers-almanack"
      ]
    }
  }
}

Похожие MCP-сервера

topskychen/tilde

topskychen/tilde

от topskychen

MCP-сервер для хранения профиля и памяти AI-агентов. Хранит данные локально, управляет навыками, опытом, резюме и командными стандартами. Избавляет от повторения контекста при смене инструментов.

Python⭐ 4
paladini/mcp-me

paladini/mcp-me

от paladini

MCP-сервер mcp-me — ваша цифровая идентичность для AI. Он собирает профиль (навыки, карьеру, проекты) из GitHub, соцсетей и API, чтобы ассистенты вроде Claude, Copilot или Cursor узнавали вас с первого запроса. Работает локально, приватно, с возможностью расширения через плагины.

TypeScript⭐ 21
gingugu/gingugu

gingugu/gingugu

от gingugu

Локальный MCP-сервер Gingugu дает AI-ассистентам постоянную память на SQLite: контекст между сессиями, проектами и репозиториями. Гибридный поиск, хронология, связи, уровни доверия. Один файл, без ...

Python⭐ 7
Patdolitse/piia-engram

Patdolitse/piia-engram

от patdolitse

Сервер piia-engram хранит ваш единый AI-профиль локально. Все MCP-клиенты (Claude Code, Codex, Cursor) читают одни настройки, стандарты и уроки. Никакого облака — данные принадлежат вам. Не повторя...

Python⭐ 162
memstate-ai/memstate-mcp

memstate-ai/memstate-mcp

от memstate-ai

Сервер версионированной памяти для AI-агентов — хранит факты, отслеживает их изменения и автоматически обнаруживает конфликты. В отличие от RAG, использует точное key-value хранение вместо эмбеддин...

TypeScript⭐ 8
besslframework-stack/project-tessera

besslframework-stack/project-tessera

от besslframework-stack

Tessera — локальная база знаний для Claude Desktop и ChatGPT с поиском по документам и памятью из диалогов. Поддерживает 40+ форматов, автообучение, обнаружение противоречий и HTTP API. Работает бе...

Python⭐ 18
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин