Brewfather MCP

Читать на английском

Это сервис протокола контекста модели, работающий на персональном компьютере. Он позволяет читать, искать, создавать и безопасно изменять рецепты Brewfather через API Brewfather v2 и публичный бета-интерфейс Brewfather 3.1.

Сервис использует локальный ввод-вывод через стандартные потоки. Учётные данные Brewfather хранятся только на компьютере пользователя; перед созданием и изменением рецептов необходимо использовать кратковременный подтверждающий токен предпросмотра. Сервис намеренно не предоставляет функцию удаления рецептов.

Самый простой способ установки: попросите ИИ-ассистента установить за вас (рекомендуется)

Этот инструмент в первую очередь предназначен для домашних пивоваров, не знакомых с командами терминала. Вы можете поручить установку ИИ-ассистенту, имеющему доступ к локальному терминалу и поддерживающему протокол контекста модели, например Codex, Claude Code, Cursor, ассистенту в Visual Studio Code или инструменту командной строки Gemini.

Откройте новый диалог, скопируйте и отправьте агенту следующий текст:

请帮我安装当前项目中的 brewfather-mcp，并注册到我正在使用的agent。

请你：
1. 检查本机是否有 Node.js 20 或更高版本；
2. 在当前项目目录安装依赖、构建项目并安装 brewfather-mcp 命令；
3. 自动识别我正在使用的智能助手，运行对应的 brewfather-mcp install 命令；
4. 如果打开本机授权页面，让我自己在页面中输入 Brewfather 用户编号和应用程序接口密钥。不要让我把密钥发到对话里，也不要输出或读取密钥内容；
5. 等我提交授权页面后，运行 brewfather-mcp doctor，并检查模型上下文协议服务是否已成功注册。

请直接开始执行；只有在必须由我操作授权页面时再提醒我。

3. ИИ-ассистент откроет страницу авторизации, доступную только с этого компьютера. Введите API ID и ключ Brewfather на странице и нажмите «Отправить».

4. После успешной установки перезапустите ИИ-ассистента или начните новый диалог, а затем просто скажите:

使用 Brewfather 工具列出我最近的 5 个配方。

Обычные веб-ИИ-ассистенты обычно не могут установить локальный сервис, работающий на вашем компьютере. Используйте настольную версию, ассистента в интегрированной среде разработки или ассистента командной строки, имеющих доступ к локальным проектам и терминалу.

Related MCP server: Tandoor MCP Server

Требования

• Node.js 20 или новее

• Премиум-подписка Brewfather или действующая премиум-пробная версия

• Для создания или изменения рецептов необходимо участвовать в публичном бета-тестировании Brewfather 3.1

• Ключ API приложения Brewfather с разрешением recipes.read; для записи рецептов также требуется разрешение recipes.write

Установка из исходного кода

cd /path/to/brewfather-mcp
npm install
npm run build
npm link

Откройте страницу локальных учётных данных и зарегистрируйте сервис в указанном ИИ-ассистенте:

brewfather-mcp install codex

Страница настройки прослушивает случайный порт на 127.0.0.1. Она проверяет учётные данные с помощью запросов только на чтение, сохраняет их локально и автоматически завершает работу. Создайте ключ в разделе «Настройки → API» Brewfather. Нет необходимости предоставлять разрешение recipes.delete — сервис его не использует.

Где хранятся учётные данные

Учётные данные сохраняются в формате JSON в каталоге конфигурации пользователя операционной системы:

Другой путь можно указать через BREWFATHER_MCP_CONFIG. В Unix-подобных системах права на каталог конфигурации — 0700, на файл конфигурации — 0600. Файл содержит учётные данные в открытом виде: не синхронизируйте, не публикуйте и не помещайте его в систему контроля версий. В контейнерах и средах непрерывной интеграции можно одновременно использовать переменные окружения BREWFATHER_USER_ID и BREWFATHER_API_KEY.

Часто используемые команды:

brewfather-mcp setup
brewfather-mcp doctor
brewfather-mcp config path
brewfather-mcp auth logout

Установка в различные ИИ-ассистенты

Программа установки поддерживает следующие ИИ-ассистенты:

brewfather-mcp install codex
brewfather-mcp install claude
brewfather-mcp install cursor
brewfather-mcp install vscode
brewfather-mcp install gemini
brewfather-mcp install all
brewfather-mcp install generic

Программа установки по возможности использует официальные инструменты командной строки каждого ассистента:

• Codex: codex mcp add

• Claude Code: claude mcp add --scope user

• Cursor: agent mcp add

• Visual Studio Code: code --add-mcp

• Gemini: gemini mcp add --scope user

generic выводит стандартную JSON-конфигурацию mcpServers для других совместимых клиентов. Команда регистрации использует абсолютные пути к текущему исполняемому файлу Node.js и точке входа компиляции данного программного обеспечения, поэтому учётные данные Brewfather не появляются в конфигурации ИИ-ассистента.

Использование в новом диалоге

Начните новый диалог с ИИ-ассистентом и скажите:

使用 Brewfather 工具列出我最近的 5 个配方，只读取，不要修改。

Чтобы изменить рецепт, можно сказать:

使用 Brewfather 工具找到“West Coast IPA”，把其中的 Citra 干投增加 20 克。先显示修改预览，等我明确确认后再写入。

Доступные инструменты

• brewfather_connection_status

• brewfather_list_recipes

• brewfather_search_recipes

• brewfather_get_recipe

• brewfather_preview_recipe_create

• brewfather_apply_recipe_create

• brewfather_preview_recipe_update

• brewfather_apply_recipe_update

Чтобы Brewfather не отклонял или молча не изменял данные при записи, при создании предпросмотра выполняются следующие проверки:

• Интерфейс записи Brewfather не принимает строковые теги. Если не копировать полный объект тегов из существующего рецепта, поле tags следует опускать.

• Единицы добавок ограничены: g, mg, kg, ml, l, tsp, tbsp, pkg, items или drops. Часто используемые синонимы, такие как tablet и dose, автоматически преобразуются в items.

• Если у солода указан только цвет по Ловибонду, а поле color отсутствует, инструмент автоматически вычисляет EBC, чтобы Brewfather не сохранил цветность как 0.

• Все автоматические преобразования перечисляются в поле normalizations предпросмотра и должны быть подтверждены пользователем вместе с остальными изменениями.

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

Вложенные объекты в параметрах изменения объединяются локально по глубине. Поскольку интерфейс частичного обновления рецепта Brewfather выполняет поверхностное объединение только для полей верхнего уровня, массивы заменяются целиком. Перед изменением следует сначала прочитать текущий рецепт и передать полные массивы fermentables, hops, yeasts или miscs.

Числовые значения Brewfather используют метрические единицы: литры, килограммы, граммы, градусы Цельсия и удельную плотность.

Разработка

npm run typecheck
npm test
npm run build

После сборки можно запустить инспектор протокола контекста модели:

npx @modelcontextprotocol/inspector node dist/cli.js serve

Связь по протоколу осуществляется через стандартный вывод. Диагностика записывается только в стандартный поток ошибок; заголовки авторизации и ключи API не регистрируются.

Примечания к интерфейсу

• Версия пути REST-интерфейса по-прежнему /v2; функция записи рецептов относится к публичному бета-тестированию Brewfather 3.1.

• API использует базовую HTTP-аутентификацию, где имя пользователя — это идентификатор пользователя Brewfather.

• В настоящее время Brewfather ограничивает каждый ключ 500 вызовами в час.

• Сервис не предоставляет функций создания версий рецептов, их блокировки, восстановления, отката или удаления.

См. документацию API Brewfather и описание публичного бета-тестирования версии 3.1.