Brewfather MCP

영문 문서 읽기

이것은 개인 컴퓨터에서 실행되는 모델 컨텍스트 프로토콜 서비스로, Brewfather API v2 및 Brewfather 3.1 공개 베타 인터페이스를 통해 Brewfather 레시피를 읽고, 검색하고, 생성하고, 안전하게 수정할 수 있습니다.

서비스는 로컬 표준 입력/출력 통신을 사용합니다. Brewfather 자격 증명은 사용자 자신의 컴퓨터에만 저장됩니다. 레시피를 생성하거나 수정하기 전에 단기 유효한 미리보기 확인 토큰을 사용해야 합니다. 이 서비스는 의도적으로 레시피 삭제 기능을 제공하지 않습니다.

가장 간단한 설치 방법: AI 어시스턴트에게 설치를 맡기기 (권장)

이 도구는 주로 터미널 명령에 익숙하지 않은 홈브루 애호가를 대상으로 합니다. 로컬 터미널에 접근할 수 있고 모델 컨텍스트 프로토콜을 지원하는 AI 어시스턴트(예: Codex, Claude Code, Cursor, Visual Studio Code의 AI 어시스턴트 또는 Gemini CLI 도구)에게 설치를 맡길 수 있습니다.

새 대화를 시작하고 아래 내용을 복사하여 에이전트에게 보내세요:

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

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

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

3. AI 어시스턴트가 로컬에서만 접근 가능한 인증 페이지를 엽니다. 페이지에 Brewfather API ID와 API 키를 입력하고 제출하세요.

4. 설치가 완료되면 AI 어시스턴트를 재시작하거나 새 대화를 시작한 후 다음과 같이 말하세요:

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

순수 웹 AI 어시스턴트는 일반적으로 사용자 컴퓨터에서 실행되는 로컬 서비스를 설치할 수 없습니다. 로컬 프로젝트와 터미널에 접근할 수 있는 데스크톱 버전, IDE AI 어시스턴트 또는 CLI AI 어시스턴트를 사용하세요.

Related MCP server: Tandoor MCP Server

사용 조건

• Node.js 20 이상

• Brewfather 프리미엄 또는 유효한 프리미엄 체험판

• 레시피 생성 또는 수정 시 Brewfather 3.1 공개 베타 참여 필요

• recipes.read 권한이 있는 Brewfather API 키, 레시피 쓰기에는 recipes.write 권한도 필요

소스 코드에서 설치

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

로컬 자격 증명 페이지를 열고 서비스를 지정된 AI 어시스턴트에 등록하세요:

brewfather-mcp install codex

설정 페이지는 127.0.0.1의 임의 포트만 수신합니다. 읽기 전용 요청으로 자격 증명을 검증하고, 자격 증명을 로컬에 저장한 후 자동으로 종료됩니다. Brewfather의 "설정 → API"에서 키를 생성하세요. recipes.delete 권한은 부여할 필요가 없습니다. 이 서비스는 해당 권한을 사용하지 않습니다.

자격 증명 저장 위치

자격 증명은 운영 체제의 사용자 구성 디렉터리에 JSON 형식으로 저장됩니다:

BREWFATHER_MCP_CONFIG를 통해 다른 경로를 지정할 수 있습니다. Unix 계열 시스템에서 구성 디렉터리 권한은 0700, 구성 파일 권한은 0600으로 설정됩니다. 파일에는 평문 자격 증명이 포함되어 있으므로 동기화, 공유 또는 버전 관리 저장소에 커밋하지 마세요. 컨테이너 및 CI 환경에서는 BREWFATHER_USER_ID 및 BREWFATHER_API_KEY 환경 변수를 함께 사용할 수 있습니다.

일반적인 명령:

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

다양한 AI 어시스턴트에 설치

설치 프로그램은 다음 AI 어시스턴트를 지원합니다:

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

설치 프로그램은 각 AI 어시스턴트의 공식 CLI 도구를 사용합니다:

• 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은 다른 호환 클라이언트에서 사용할 수 있는 표준 mcpServers JSON 구성을 출력합니다. 등록 명령은 현재 Node.js 실행 파일과 이 소프트웨어 컴파일 진입점의 절대 경로를 사용하므로 AI 어시스턴트 구성에 Brewfather 자격 증명이 나타나지 않습니다.

새 대화에서 사용

새 AI 어시스턴트 대화를 시작한 후 다음과 같이 말하세요:

使用 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 쓰기 API는 문자열 태그를 허용하지 않습니다. 기존 레시피에서 전체 태그 객체를 복사하지 않는 한 tags는 생략해야 합니다.

• 첨가물 단위는 g, mg, kg, ml, l, tsp, tbsp, pkg, items 또는 drops로 제한됩니다. tablet 및 dose와 같은 일반적인 별칭은 자동으로 items로 변환됩니다.

• 맥아에 Lovibond 색도만 있고 color가 없는 경우, 도구가 자동으로 EBC를 계산하여 Brewfather가 색도를 0으로 저장하지 않도록 합니다.

• 모든 자동 변환은 미리보기의 normalizations에 나열되며, 다른 변경 사항과 함께 사용자 확인을 받아야 합니다.

레시피 생성 및 수정 확인 토큰은 10분 후에 만료되며 한 번만 사용할 수 있습니다. 레시피를 수정하기 전에 서비스가 레시피를 다시 읽습니다. 미리보기 생성 후 레시피가 변경된 경우 이번 쓰기는 거부됩니다.

수정 매개변수의 중첩 객체는 로컬에서 깊은 병합이 수행됩니다. Brewfather의 레시피 부분 업데이트 API는 최상위 필드에 대해서만 얕은 병합을 수행하므로 배열은 전체가 교체됩니다. 수정 전에 현재 레시피를 먼저 읽고 완전한 fermentables, hops, yeasts 또는 miscs 배열을 전달하세요.

Brewfather 수치는 모두 미터법 단위를 사용합니다: 리터, 킬로그램, 그램, 섭씨 및 비중.

개발

npm run typecheck
npm test
npm run build

빌드가 완료되면 모델 컨텍스트 프로토콜 검사기를 실행할 수 있습니다:

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

프로토콜 통신은 표준 출력을 사용합니다. 실행 진단은 표준 오류에만 기록되며 인증 헤더와 API 키는 기록되지 않습니다.

API 설명

• REST API 경로 버전은 여전히 /v2입니다. 레시피 쓰기 기능은 Brewfather 3.1 공개 베타에 속합니다.

• API는 HTTP 기본 인증을 사용하며 Brewfather 사용자 ID가 사용자 이름입니다.

• Brewfather는 현재 키당 시간당 최대 500회 호출로 제한합니다.

• 이 서비스는 레시피 버전 생성, 잠금, 복원, 롤백 또는 삭제 기능을 제공하지 않습니다.

Brewfather API 문서 및 버전 3.1 공개 베타 설명을 참조하세요.