DIY AI Barista — пусть ваш агент ИИ напрямую контролирует ваш Gaggimate

Я превратил Клода в ИИ-бариста, контролирующего мою эспрессо-машину

Вы уже можете спросить LLM о том, как набрать эспрессо, а такие модели, как Claude, ChatGPT или Gemini, уже могут генерировать профили Gaggimate в формате JSON.

Этот репозиторий предоставляет две вещи:

1. ** Сервер MCP**, который позволяет вашему LLM-агенту напрямую взаимодействовать с вашей машиной Gaggimate — не требуется копирование или загрузка вручную. Ваш агент LLM может прочитать историю ваших снимков, проанализировать извлечения, сохранить обратную связь, загрузить созданные профили и настроить их на основе ваших результатов и пожеланий.

2. ** Инструкции, знания и навыки** для руководства агентом о том, как помочь вам набрать эспрессо - превращение LLM общего назначения в тренера бариста, который понимает теорию извлечения, дегустацию словаря, профилирование давления и систему профиля Gaggimate. Спасибо Чарли Холлу за то, что позволил мне использовать и адаптировать файлы знаний и диагностические шаблоны из его проекта gaggimate-barista.

Таблица содержимого

• Что в этом хранилище? Changelog
• Цифровой поток
• Пример разговоров Инструменты MCP

Gaggimate MCP Server

DIY AI Barista — Let your AI agent directly control your Gaggimate

Blog Post: I Turned Claude Into an AI Barista Controlling My Espresso Machine

You can already ask an LLM for advice on how to dial your espresso, and models like Claude, ChatGPT, or Gemini can already generate Gaggimate profiles in JSON format.

This repository provides two things:

1. An MCP server that allows your LLM agent to directly interact with your Gaggimate machine—no copy-pasting or manually uploading required. Your LLM agent can read your shot history, analyze extractions, store your tasting feedback, upload generated profiles, and adjust them based on your results and wishes.

2. Instructions, knowledge, and skills to guide the agent on how to help you dial your espresso—turning a general-purpose LLM into a barista coach that understands extraction theory, tasting vocabulary, pressure profiling, and Gaggimate’s profile system. Thanks to Charlie Hall for allowing me to use and adapt the knowledge files and diagnostic patterns from his gaggimate-barista project.

Table of Contents

• What’s in this Repository
• Changelog
• The Dialing Flow
• Example Conversations
• MCP Tools
• MCP Resources
• Safety Guardrails
• Requirements
• Quick Start
• Claude Desktop Project Setup (Optional)
• Configuration (Optional)
• Troubleshooting
• How It Works
• Local Data Storage
• Development
• Why a Skill Instead of a Knowledge File?
• Project Structure
• Related
• License

What’s in this Repository

MCP Server — Nine tools and eight resources that give your AI direct access to your machine and local data:

• Read shot data — Temperature curves, pressure readings, flow rates, extraction timing
• Manage profiles — Create, update, and list brewing profiles directly on your device
• Track feedback — Record ratings and tasting notes synced to your Gaggimate
• Browse history — List recent shots with filtering
• Diagnose issues — Automated connection troubleshooting
• Manage coffees — Create and update coffee tracking files with brewing journal
• User setup — Store and retrieve your equipment and preferences
• Grind map — Track successful grind settings across coffees
• Brewing insights — Accumulate cross-coffee patterns and learnings
• Knowledge resources — On-demand access to espresso knowledge files (including subdirectories)