Gaggiuino MCP

🚀 一键上手的Gaggiuino MCP服务器

本项目是Gaggia经典咖啡机轻量级MCP协议服务器，专为Gaggiuino这一开源的意式浓缩咖啡机控制器打造。该服务器旨在轻松集成实时AI客户端，用于显示或分析Gaggia系统数据，为意式浓缩咖啡制作提供便利。

我在文章中详细介绍了这个项目：通过MCP服务器优化意式浓缩

🚀 快速开始

连接客户端可实现的功能

• 获取当前机器状态
• 查看最新的浓缩咖啡ID
• 根据指定ID获取咖啡数据

✨ 主要特性

• 📊 实时访问萃取数据
• 🌐 专为局域网设计

📦 安装指南

在Claude Desktop中的配置

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

💻 使用示例

可用工具集

基础用法

用户需求

分析最近一次的意式浓缩咖啡数据

Claude响应

让我为您分析最新的意式浓缩咖啡数据。首先，我需要获取咖啡机的当前状态：

>>> 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
    }
  }
}

接着，我需要查看最新的萃取数据：

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

基于这些数据，我可以得出以下分析：

这个萃取过程持续了29.1秒，最终得到了38.5克的咖啡。温度和压力都保持在理想范围内，显示出良好的稳定性和控制能力。

结合温度曲线和压力曲线，可以看出机器在整个萃取过程中表现优异：
- 温度从开始到结束一直维持在93°C左右，波动极小。
- 压力则平稳地从8.5bar上升至最高点后缓慢下降，符合标准操作规范。

总体来说，这次萃取是一次成功的尝试。您是否希望我对特定参数进行更详细的分析，或提供更多具体信息？

通过这些工具集的调用，AI助手能够提供专业的数据解读和优化建议，帮助提升您的意式浓缩咖啡制作水平。