Gaggiuino MCP

🚀 One-Click Gaggiuino MCP Server

A lightweight MCP protocol server for Gaggia classic coffee machines, specifically designed for Gaggiuino, an open-source espresso machine controller. This server is intended to easily integrate real-time AI clients for displaying or analyzing Gaggia system data.

I've detailed this project in the article: Dialing in Espresso Using MCP Server

🚀 Quick Start

Features Achievable by Connecting Clients:

• Get the current machine status
• View the latest espresso ID
• Retrieve coffee data based on the specified ID

✨ Features

📊 Real-time access to extraction data
🌐 Designed specifically for local area networks

📦 Installation

Configuration in Claude Desktop:

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

💻 Usage Examples

Available Toolset

Example

User:

Analyze the data of the most recent espresso shot

Claude:

Let me analyze the data of the latest espresso shot for you. First, I need to get the current status of the coffee machine:

>>> import gaggiano_mcp_client as gmc
>>> shot_id = "latest"
>>> gmc.get_shot_info(shot_id)
{
  "status": "complete",
  "timestamp": "2023-10-05T14:30:45Z",
  "parameters": {
    "temperature": {
      "target": 93,
      "actual": 93.2
    },
    "pressure": {
      "target": 8.5,
      "actual": 8.6
    }
  }
}

Next, I need to view the latest extraction data:

>>> gmc.get_shot_data(shot_id)
{
  "id": "latest",
  "duration": 29.1,
  "weight": {
    "target": 40,
    "actual": 38.5
  },
  "temperature_curve": [ ... ],
  "pressure_curve": [ ... ]
}

Based on this data, I can draw the following analysis:

This extraction process lasted 29.1 seconds, resulting in 38.5 grams of coffee. Both the temperature and pressure remained within the ideal range, indicating good stability and control.

Combining the temperature curve and pressure curve, it can be seen that the machine performed excellently throughout the extraction process:
- The temperature remained around 93°C from start to finish, with minimal fluctuations.
- The pressure steadily rose from 8.5 bar to its peak and then slowly decreased, in line with standard operating procedures.

Overall, this extraction was a successful attempt. Do you want me to conduct a more detailed analysis of specific parameters or provide more specific information?

Through the invocation of these toolkits, the AI assistant can provide professional data interpretation and optimization suggestions to help improve your espresso-making skills.