Brewfather MCP

Leer el documento en inglés

Este es un servicio de protocolo de contexto de modelo que se ejecuta en tu ordenador personal y que permite leer, buscar, crear y modificar de forma segura recetas de Brewfather a través de la API v2 de Brewfather y la interfaz de pruebas públicas de Brewfather 3.1.

El servicio utiliza comunicación local de entrada/salida estándar. Las credenciales de Brewfather se guardan únicamente en tu propio ordenador; antes de crear o modificar recetas, es obligatorio utilizar un token de confirmación de vista previa de corta duración. Este servicio no ofrece deliberadamente la función de eliminar recetas.

La forma más sencilla de instalarlo: deja que el asistente de IA lo instale por ti (recomendado)

Esta herramienta está pensada principalmente para aficionados a la elaboración de cerveza casera que no están familiarizados con los comandos de terminal. Puedes pedirle a un asistente de IA que tenga acceso a tu terminal local y sea compatible con el protocolo de contexto de modelo que realice la instalación, por ejemplo Codex, Claude Code, Cursor, el asistente de IA de Visual Studio Code o la herramienta de línea de comandos de Gemini.

Abre una conversación nueva, copia el siguiente texto y envíalo al agente:

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

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

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

3. El asistente de IA abrirá una página de autorización accesible únicamente desde tu equipo. Introduce tu ID de API y tu clave de Brewfather en la página y envía la información.

4. Una vez completada la instalación, reinicia el asistente de IA o abre una conversación nueva y di directamente:

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

Los asistentes de IA puramente web normalmente no pueden instalar servicios locales que se ejecutan en tu ordenador. Utiliza la versión de escritorio, el asistente de IA del entorno de desarrollo integrado o el asistente de IA de línea de comandos que tengan acceso a tus proyectos locales y a tu terminal.

Related MCP server: Tandoor MCP Server

Requisitos

• Node.js 20 o superior

• Plan Premium de Brewfather o una prueba Premium activa

• Para crear o modificar recetas, es necesario participar en la prueba pública de Brewfather 3.1

• Clave de API de la aplicación Brewfather con permiso recipes.read; para escribir recetas también se necesita el permiso recipes.write

Instalación desde el código fuente

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

Abre la página de credenciales local y registra el servicio en el asistente de IA especificado:

brewfather-mcp install codex

La página de configuración solo escucha en un puerto aleatorio de 127.0.0.1. Verifica las credenciales mediante una solicitud de solo lectura, guarda las credenciales en tu equipo y se cierra automáticamente. Genera la clave en "Configuración → API" de Brewfather. No es necesario conceder el permiso recipes.delete; este servicio no lo utiliza.

Ubicación de almacenamiento de credenciales

Las credenciales se guardan en formato JSON en el directorio de configuración de usuario del sistema operativo:

Se puede especificar otra ruta mediante BREWFATHER_MCP_CONFIG. En sistemas tipo Unix, los permisos del directorio de configuración se establecen en 0700 y los del archivo de configuración en 0600. El archivo contiene credenciales en texto plano; no lo sincronices, compartas ni lo envíes a un repositorio. En entornos de contenedores e integración continua se pueden utilizar simultáneamente las variables de entorno BREWFATHER_USER_ID y BREWFATHER_API_KEY.

Comandos habituales:

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

Instalación en diferentes asistentes de IA

El instalador es compatible con los siguientes asistentes de IA:

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

El instalador utiliza en la medida de lo posible las herramientas oficiales de línea de comandos de cada asistente de IA:

• 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 genera la configuración JSON estándar de mcpServers para otros clientes compatibles. El comando de registro utiliza la ruta absoluta del ejecutable de Node.js actual y del punto de entrada compilado de este software, por lo que las credenciales de Brewfather no aparecen en la configuración del asistente de IA.

Uso en una conversación nueva

Abre una conversación nueva con el asistente de IA y di:

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

Para modificar una receta, puedes decir:

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

Herramientas disponibles

• 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

Para evitar que Brewfather rechace o modifique silenciosamente los datos al escribir, al generar la vista previa se realizan las siguientes comprobaciones:

• La interfaz de escritura de Brewfather no acepta etiquetas en formato de cadena. A menos que se copie el objeto de etiquetas completo de una receta existente, se debe omitir tags.

• Las unidades de los aditivos se limitan a g, mg, kg, ml, l, tsp, tbsp, pkg, items o drops. Los alias habituales como tablet y dose se convierten automáticamente a items.

• Si la malta solo tiene el color Lovibond y no tiene color, la herramienta calcula automáticamente el EBC para evitar que Brewfather guarde el color como 0.

• Todas las conversiones automáticas se enumeran en normalizations de la vista previa y deben ser confirmadas por el usuario junto con el resto de cambios.

Los tokens de confirmación para crear y modificar recetas caducan a los diez minutos y solo se pueden utilizar una vez. Antes de modificar una receta, el servicio vuelve a leerla; si la receta ha cambiado desde que se generó la vista previa, la escritura se rechazará.

Los objetos anidados en los parámetros de modificación se fusionan en profundidad de forma local. Dado que la interfaz de actualización parcial de recetas de Brewfather solo realiza una fusión superficial de los campos de nivel superior, los arrays se reemplazan por completo. Antes de modificar, se debe leer la receta actual y pasar los arrays completos de fermentables, hops, yeasts o miscs.

Los valores numéricos de Brewfather utilizan de forma uniforme unidades métricas: litros, kilogramos, gramos, grados Celsius y gravedad específica.

Desarrollo

npm run typecheck
npm test
npm run build

Una vez completada la compilación, se puede ejecutar el inspector del protocolo de contexto de modelo:

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

La comunicación del protocolo utiliza la salida estándar. Los diagnósticos de ejecución solo se escriben en el error estándar; los encabezados de autorización y las claves de API no se registran.

Notas sobre la interfaz

• La versión de la ruta de la interfaz REST sigue siendo /v2; la función de escritura de recetas pertenece a la prueba pública de Brewfather 3.1.

• La API utiliza autenticación básica HTTP, con el ID de usuario de Brewfather como nombre de usuario.

• Brewfather limita actualmente cada clave a un máximo de 500 llamadas por hora.

• Este servicio no ofrece funciones de creación de versiones de recetas, bloqueo, restauración, reversión ni eliminación.

Consulta la documentación de la API de Brewfather y las notas de la prueba pública de la versión 3.1.