——让你的AI代理直接控制你的Gaggimate
概览
——让你的AI代理直接控制你的Gaggimate 我把克劳德变成了一个AI咖啡师，控制着我的浓缩咖啡机 你已经可以向大型语言模型（LLM）请教如何调度意式咖啡，像Claude、ChatGPT或Gemini这样的模型也能生成JSON格式的Gaggimate配置文件。 1. 允许您的LLM代理直接与Gaggimate机器交互——无需复制粘贴或手动上传。您的LLM代理可以读取您的萃取历史，分析萃取，存储品鉴反馈，上传生成的配置文件，并根据您的结果和需求进行调整。 2. 指导客服如何帮助你调校意式浓缩——将一个通用的大型语言模型转变为理解萃取理论、品尝词汇、压力分析和Gaggimate配置文件系统的咖啡师教练。感谢Charlie Hall允许我使用并调整他gaggimate咖啡师项目中的知识文件和诊断模式。
概述（AI 翻译）
DIY AI 咖啡师 — 让你的 AI 代理直接控制你的 Gaggimate
博客文章： 我把克劳德变成了控制我意式咖啡机的AI咖啡师
你已经可以向大型语言模型（LLM）请教如何调度意式咖啡，像Claude、ChatGPT或Gemini这样的模型也能生成JSON格式的Gaggimate配置文件。
这个仓库提供了两点：
-
一个MCP服务器，允许你的LLM代理直接与你的Gaggimate机器交互——无需复制粘贴或手动上传。你的LLM代理可以读取你的萃取历史，分析萃取，存储你的品鉴反馈，上传生成的配置文件，并根据你的结果和意愿进行调整。
-
指导、知识和技能，指导代理如何帮助你调度浓缩咖啡——将通用的大型语言模型转变为理解萃取理论、品尝词汇、压力曲线和Gaggimate配置文件系统的咖啡师教练。 感谢查理·霍尔允许我使用并改编他“gaggimate-barista”项目中的知识文件和诊断模式。
目录
- 这个仓库里有什么
- 更新日志
- 拨号流程
- 示例对话
- MCP 工具
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
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:
-
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.
-
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)
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"gaggimate": {
"command": "/opt/homebrew/bin/uv",
"args": [
"--directory",
"/Users/yourname/code/gaggimate-mcp",
"run",
"mcp",
"run",
"src/gaggimate_mcp/server.py"
]
}
}
}