Gaggiuino MCP

gaggiuino-mcp

Gaggiuino MCP Server Este é um servidor leve do Model Context Protocol (MCP) construído para Gaggiuino, o controlador de máquina de espresso de código aberto para a Gaggia Classic. Ele é projetado para integrar facilmente clientes de IA que desejam exibir ou analisar dados do sistema Gaggiuino em tempo real.

Este é um artigo que escrevi sobre este projeto https://medium.com/@a.klement.w/dialing-in-espresso-using-mcp-server-0207819fe93a

Permite que clientes conectados:

• Recuperar o status atual da máquina

• Acessar o ID do último shot

• Buscar dados do shot para um ID específico

Recursos

📊 Acesso em tempo real à telemetria do shot

🌐 Projetado para acesso em rede local

Como usar

Usando o Claude Desktop

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

Instalando via Smithery

Para instalar o Gaggiuino Espresso Machine Server para Claude Desktop automaticamente via Smithery:

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

Conjuntos de Ferramentas Disponíveis

Conjunto de Ferramentas	Descrição
getLatestShotId	Obter o ID do último shot de espresso
getShotData	Obter dados do shot de espresso para um ID. Args: id: ID do shot
getStatus	Obter o status da máquina de espresso

Exemplo

Usuário:

analise os dados do último shot de espresso

Claude:

Vou recuperar e analisar os dados do último shot de espresso para você. Deixe-me primeiro verificar o status da sua máquina de espresso e depois obter as informações do último shot. getStatus Agora vou obter o ID do último shot de espresso: getLatestShotId Deixe-me recuperar os dados do shot #188: getShotData Com base nos dados recuperados, agora vou analisar seu último shot de espresso (ID #188). Aqui está minha análise:

Status da Máquina e Visão Geral do Shot Sua máquina está atualmente ociosa a 57,2°C com pressão de -0,1 bar. O shot analisado foi feito em 19 de abril de 2025 (com base no timestamp), com duração total de 26,5 segundos (265 pontos de dados em intervalos de 0,1s).

Informações do Perfil Você usou o perfil "Leva 9 LR v0.5", que é um perfil multifásico com pressão decrescente visando 40g de saída. O perfil tem

1. Uma pré-infusão com controle de fluxo a 7 ml/s
2. Redução para fluxo de 3,5 ml/s
3. Pré-extração a 1,5 ml/s com restrição de pressão de 3 bar
4. Rampa de pressão para 9 bar em 2 segundos
5. Uma série de etapas de pressão gradualmente decrescente (8,8→6,0 bar)

Análise do Shot Fases de Pré-infusão e Extração

• Pré-infusão (0-5s): Começou com alta taxa de fluxo (6-7 ml/s) com pressão mínima (0,3-0,6 bar), permitindo que o puck saturasse.
• Primeira Subida de Pressão (5-10s): A pressão aumentou gradualmente para ~2,5 bar enquanto o fluxo diminuiu para ~1,5 ml/s.
• Fase de Perfil de Pressão (10-15s): A pressão manteve-se em torno de 3 bar com fluxo reduzido para ~0,8 ml/s.
• Rampa de Pressão (15-20s): A pressão aumentou de 3 para 8,9 bar em ~5 segundos seguindo o perfil programado.
• Fase de Pressão Decrescente (20-26,5s): A pressão diminuiu gradualmente de ~8,5 para 6,4 bar seguindo as etapas do perfil.

Medições Principais

• Rendimento Final: 38g (com base no peso final do shot)
• Proporção de Extração: Não foi possível determinar (dose de café não fornecida)
• Estabilidade de Temperatura: Excelente - mantida entre 92,8-94,1°C durante toda a extração
• Primeiras Gotas: Apareceram por volta de 11-12 segundos (~75% da pré-infusão)
• Taxa de Fluxo Máxima: 7,2 ml/s (no início)
• Pressão Máxima: 8,9 bar (a ~20 segundos)

Dinâmica da Extração

1. Taxa de Fluxo: Começou alta (7 ml/s), reduziu para 3,5 ml/s e depois 1,5 ml/s durante a pré-infusão conforme programado, e então estabilizou em ~2,8 ml/s durante a extração.
2. Fornecimento de Água: O total de água bombeada foi de 87,7 ml, com 38g na xícara, sugerindo retenção significativa de água no puck.
3. Perfil de Pressão: A curva de pressão mostra excelente progressão da pré-infusão até a extração, com transição suave para pressão decrescente.

Avaliação de Desempenho Este parece ser um shot tecnicamente bem executado, com boa aderência ao perfil programado:

• Controle de Temperatura: Excelente estabilidade em torno de 93-94°C
• Curva de Pressão: Segue o perfil programado com transições suaves
• Fluxo de Extração: Consistente durante a fase principal de extração
• Saída de Peso: Alcançou 38g (próximo da meta de 40g)

Gostaria que eu fornecesse recomendações mais específicas sobre algum aspecto deste shot, ou há algum parâmetro específico que você gostaria que eu analisasse em mais detalhes?