Gaggiuino MCP Server
gaggiuino-mcp
Servidor MCP de Gaggiuino. Este es un servidor ligero de Protocolo de Contexto de Modelo (MCP) diseñado para Gaggiuino , el controlador de código abierto para la máquina de café expreso Gaggia Classic. Está diseñado para integrar fácilmente clientes de IA que deseen visualizar o analizar datos del sistema Gaggiuino en tiempo real.
Este es un artículo que escribí sobre este proyecto https://medium.com/@a.klement.w/dialing-in-espresso-using-mcp-server-0207819fe93a
Permite a los clientes conectados:
Recuperar el estado actual de la máquina
Acceda a la última identificación de la toma
Obtener datos de disparos para una identificación específica
Related MCP server: meticulous-mcp
Características
📊 Acceso en tiempo real a la telemetría de disparos
🌐 Diseñado para acceso a red local
Cómo utilizar
Uso de Claude Desktop
{
"mcpServers": {
"gaggiuino": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/gaggiuino-mcp",
"run",
"gaggiuino.py"
]
}
}
}Conjuntos de herramientas disponibles
Conjunto de herramientas | Descripción |
| Obtenga la identificación de la última toma de espresso |
| Obtener datos de la dosis de espresso para un ID. Argumentos: ID: ID de la dosis |
| Obtener el estado de la máquina de espresso |
Ejemplo
Usuario:
Analizar los últimos datos de la toma de espresso
Claude:
Recuperaré y analizaré los datos de la última dosis de espresso. Primero, comprobaré el estado de su máquina de espresso y luego obtendré la información de la última dosis. getStatus Ahora obtendré el ID de la última dosis de espresso: getLatestShotId Recuperaré los datos de la dosis n.° 188: getShotData Con base en los datos recuperados, analizaré su última dosis de espresso (ID n.° 188). Este es mi análisis:
Estado de la máquina y resumen de la toma. Su máquina está actualmente inactiva a 57,2 °C con una presión de -0,1 bar. La toma analizada se tomó el 19 de abril de 2025 (según la marca de tiempo), con una duración total de 26,5 segundos (265 puntos de datos a intervalos de 0,1 s).
Información del perfil: Utilizaste el perfil "Leva 9 LR v0.5", un perfil multifásico con presión decreciente que busca una salida de 40 g. El perfil tiene
Una preinfusión con control de flujo a 7 ml/s
Reducir el flujo a 3,5 ml/s
Preextracción a un flujo de 1,5 ml/s con restricción de presión de 3 bar
Rampa de presión a 9 bar durante 2 segundos
Una serie de pasos de presión que disminuyen gradualmente (8,8→6,0 bar)
Análisis de la inyección: fases de preinfusión y extracción
Preinfusión (0-5 s): se inicia con un caudal alto (6-7 ml/s) con una presión mínima (0,3-0,6 bar), lo que permite que el disco se sature.
Primer aumento de presión (5-10 s): la presión aumentó gradualmente hasta ~2,5 bar mientras el flujo disminuía a ~1,5 ml/s.
Fase de perfil de presión (10-15 s): presión mantenida alrededor de 3 bar con flujo reducido a ~0,8 ml/s.
Rampa de presión (15-20 s): la presión aumentó de 3 a 8,9 bar durante ~5 segundos siguiendo el perfil programado.
Fase de presión descendente (20-26,5 s): la presión disminuyó gradualmente de ~8,5 a 6,4 bar siguiendo los pasos del perfil.
Medidas clave
Rendimiento final: 38 g (según el peso del disparo final)
Relación de preparación: No se puede determinar (no se proporciona la dosis de café)
Estabilidad de temperatura: Excelente: se mantiene a 92,8-94,1 °C durante toda la extracción.
Primeras gotas: aparecieron alrededor de los 11-12 segundos (aproximadamente el 75 % de la preinfusión).
Caudal máximo: 7,2 ml/s (al inicio)
Presión máxima: 8,9 bar (a ~20 segundos)
Dinámica de extracción
Caudal: comenzó alto (7 ml/s), disminuyó a 3,5 ml/s y luego a 1,5 ml/s durante la preinfusión según lo programado, luego se estabilizó en ~2,8 ml/s durante la extracción.
Suministro de agua: El agua total bombeada fue de 87,7 ml, con 38 g en la taza, lo que sugiere una retención de agua significativa en el disco.
Perfil de presión: La curva de presión muestra una excelente progresión desde la preinfusión hasta la extracción, con una transición suave hacia una presión decreciente.
Evaluación del rendimiento Este parece ser un tiro técnicamente bien ejecutado con buena adherencia al perfil programado:
Control de temperatura: Excelente estabilidad alrededor de 93-94°C
Curva de presión: sigue el perfil programado con transiciones suaves
Flujo de extracción: constante durante la fase de extracción principal
Peso de salida: Se lograron 38 g (cerca del objetivo de 40 g)
¿Te gustaría que te dé recomendaciones más específicas sobre algún aspecto de esta toma, o hay algún parámetro en particular que te gustaría que analice con más detalle?
Available Tools
3 toolsgetLatestShotIdB
Get latest espresso shot id.
Inputs: no named parameters.
getShotDataC
Get espresso shot data for an id.
Args:
id: Shot id
Inputs: id (required).
getStatusB
Get espresso machine status.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: getLatestShotId retrieves the most recent shot identifier, getShotData fetches detailed data for a specific shot ID, and getStatus provides machine status information. There is no overlap or ambiguity between these functions.
All three tools follow a consistent verb_noun pattern with camelCase naming (getLatestShotId, getShotData, getStatus). The naming is predictable and uniform throughout the set.
With only 3 tools, the set feels thin for an espresso machine control server. There are obvious gaps in functionality, such as tools to start/stop shots, adjust settings, or manage profiles, which limits the server's utility for comprehensive machine interaction.
The tool surface is severely incomplete for an espresso machine domain. It only provides read-only operations (getLatestShotId, getShotData, getStatus) with no ability to control the machine (e.g., start_shot, set_temperature), update configurations, or manage other critical aspects like brewing profiles or maintenance.
Maintenance
Related MCP Connectors
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Real-time planetary signal engine and Model Context Protocol (MCP) server for autonomous AI agents.
MCP server exposing klokin time-tracking operations (employees, time entries, stores) to AI clients.
MCP server for the Z1N Protocol - on-chain identity for AI agents on Polygon
Related MCP Servers
- AlicenseBqualityBmaintenanceLocal-first MCP server that connects AI agents to your Withings body, sleep, activity and heart data.23168 npm6MIT
- AlicenseAqualityDmaintenanceMCP server for controlling Meticulous espresso machines via Claude and other AI clients.22105 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server for Gaggiuino-modified espresso machines, enabling monitoring, shot analysis, and profile management.411 npm1MIT
- AlicenseNot gradedqualityBmaintenanceA remote MCP server for integrating Gaggiuino espresso machines with AI tools. It enables checking machine status, analyzing shot data, managing profiles, and receiving dial-in guidance.1MIT