Gaggiuino MCP

gaggiuino-mcp

Servidor MCP de Gaggiuino Este es un servidor ligero de Protocolo de Contexto de Modelo (MCP) construido para Gaggiuino, el controlador de máquina de espresso de código abierto para la Gaggia Classic. Está diseñado para integrarse fácilmente con clientes de IA que quieran mostrar 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:

• Obtener el estado actual de la máquina

• Acceder al ID de la última extracción

• Obtener datos de extracción para un ID especificado

Características

📊 Acceso en tiempo real a la telemetría de extracción

🌐 Diseñado para acceso a red local

Cómo usar

Usando Claude Desktop

{
  "mcpServers": {
      "gaggiuino": {
          "command": "uv",
          "args": [
              "--directory",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/gaggiuino-mcp",
              "run",
              "gaggiuino.py"
          ]
      }
  }
}

Instalación mediante Smithery

Para instalar Gaggiuino Espresso Machine Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @AndrewKlement/gaggiuino-mcp --client claude

Conjuntos de herramientas disponibles

Conjunto de herramientas	Descripción
getLatestShotId	Obtener el ID de la última extracción de espresso
getShotData	Obtener datos de extracción de espresso para un ID. Args: id: ID de extracción
getStatus	Obtener el estado de la máquina de espresso

Ejemplo

Usuario:

analiza los datos de la última extracción de espresso

Claude:

Obtendré y analizaré los datos de la última extracción de espresso para ti. Primero déjame verificar el estado de tu máquina de espresso y luego obtener la información de la última extracción. getStatus Ahora obtendré el ID de la última extracción de espresso: getLatestShotId Déjame recuperar los datos de la extracción #188: getShotData Basándome en los datos recuperados, ahora analizaré tu última extracción de espresso (ID #188). Aquí está mi análisis:

Estado de la máquina y resumen de la extracción Tu máquina está actualmente inactiva a 57.2°C con -0.1 bar de presión. La extracción analizada se realizó 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.1s).

Información del perfil Usaste el perfil "Leva 9 LR v0.5", que es un perfil multifásico con presión decreciente dirigido a 40g de salida. El perfil tiene:

1. Una preinfusión con control de flujo a 7 ml/s
2. Reducción a flujo de 3.5 ml/s
3. Pre-extracción a flujo de 1.5 ml/s con restricción de presión de 3 bar
4. Rampa de presión a 9 bar durante 2 segundos
5. Una serie de pasos de presión gradualmente decreciente (8.8→6.0 bar)

Análisis de la extracción Fases de preinfusión y extracción

• Preinfusión (0-5s): Comenzó con una alta tasa de flujo (6-7 ml/s) con presión mínima (0.3-0.6 bar), permitiendo que el disco se sature.
• Primer aumento de presión (5-10s): La presión aumentó gradualmente a ~2.5 bar mientras el flujo disminuyó a ~1.5 ml/s.
• Fase de perfil de presión (10-15s): La presión se mantuvo alrededor de 3 bar con flujo reducido a ~0.8 ml/s.
• Rampa de presión (15-20s): La presión aumentó de 3 a 8.9 bar durante ~5 segundos siguiendo el perfil programado.
• Fase de presión decreciente (20-26.5s): La presión disminuyó gradualmente de ~8.5 a 6.4 bar siguiendo los pasos del perfil.

Mediciones clave

• Rendimiento final: 38g (según el peso final de la extracción)
• Proporción de preparación: No se puede determinar (dosis de café no proporcionada)
• Estabilidad de temperatura: Excelente - se mantuvo en 92.8-94.1°C durante toda la extracción
• Primeras gotas: Aparecieron alrededor de 11-12 segundos (~75% de la preinfusión)
• Tasa de flujo máxima: 7.2 ml/s (al inicio)
• Presión máxima: 8.9 bar (a ~20 segundos)

Dinámica de extracción

1. Tasa de flujo: Comenzó alta (7 ml/s), se redujo 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.
2. Entrega de agua: El agua total bombeada fue de 87.7 ml, con 38g en la taza, lo que sugiere una retención significativa de agua en el disco.
3. Perfil de presión: La curva de presión muestra una progresión excelente desde la preinfusión hasta la extracción, con una transición suave a presión decreciente.

Evaluación del rendimiento Esta parece ser una extracción técnicamente bien ejecutada 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: Consistente durante la fase principal de extracción
• Salida de peso: Alcanzó 38g (cerca del objetivo de 40g)

¿Te gustaría que proporcione recomendaciones más específicas sobre algún aspecto de esta extracción, o hay algún parámetro en particular que quieras que analice con más detalle?