gaggiuino-mcp

Gaggiuino MCP 服务器
这是一个为 Gaggiuino 构建的轻量级模型上下文协议 (MCP) 服务器，Gaggiuino 是 Gaggia Classic 的开源意式咖啡机控制器。它旨在轻松集成希望实时显示或分析 Gaggiuino 系统数据的 AI 客户端。

MCP 服务器提供了一个简单的 HTTP API，允许连接的客户端：

• 获取当前机器状态

• 访问最新的冲泡 ID

• 获取指定 ID 的冲泡数据

特性

📊 实时访问冲泡遥测数据

🌐 专为本地网络访问设计

如何使用

使用 Claude Desktop

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

可用工具集

示例

用户:

分析最新的浓缩咖啡冲泡数据

Claude:

我将为您检索并分析最新的浓缩咖啡冲泡数据。首先让我检查您的浓缩咖啡机的状态，然后获取最新的冲泡信息。
getStatus
现在我将获取最新浓缩咖啡冲泡的 ID：
getLatestShotId
让我检索 #188 次冲泡的数据：
getShotData
根据检索到的数据，我现在将分析您最新的浓缩咖啡冲泡（ID #188）。以下是分析结果：

机器状态和冲泡概览
您的机器当前处于空闲状态，温度为 57.2°C，压力为 -0.1 bar。分析的冲泡是在 2025 年 4 月 19 日进行的（基于时间戳），总持续时间为 26.5 秒（265 个数据点，每 0.1 秒一个）。

配置文件信息
您使用了 "Leva 9 LR v0.5" 配置文件，这是一个多阶段配置文件，目标是 40 克输出，并且压力逐渐下降。该配置文件包括：

1. 流量控制预浸阶段，流速为 7 ml/s
2. 逐步降低至 3.5 ml/s 的流速
3. 带有 3 bar 压力限制的 1.5 ml/s 流速预提取阶段
4. 在 2 秒内将压力升至 9 bar
5. 一系列逐渐下降的压力步骤（8.8→6.0 bar）

冲泡分析
预浸和提取阶段

• 预浸阶段（0-5秒）：以高流速（6-7 ml/s）和最小压力（0.3-0.6 bar）开始，使咖啡饼充分饱和。
• 第一次压力上升（5-10秒）：压力逐渐增加到约 2.5 bar，同时流速降至约 1.5 ml/s。
• 压力保持阶段（10-15秒）：压力保持在约 3 bar，流速减少到约 0.8 ml/s。
• 压力上升阶段（15-20秒）：压力从 3 bar 上升到 8.9 bar，耗时约 5 秒，按照编程的配置文件进行。
• 压力下降阶段（20-26.5秒）：压力从约 8.5 bar 逐渐下降到 6.4 bar，遵循配置文件中的步骤。

关键测量值

• 最终产量：38克（基于最终出液重量）
• 咖啡粉水比：无法确定（未提供咖啡粉量）
• 温度稳定性：非常好 - 在整个萃取过程中保持在92.8-94.1°C
• 第一滴出现时间：大约在11-12秒时出现（预浸泡过程约75%处）
• 最大流速：7.2毫升/秒（在开始时）
• 最高压力：8.9巴（约在20秒时）

萃取动态

1. 流速：开始时较高（7毫升/秒），按程序设定逐步降至3.5毫升/秒，然后是1.5毫升/秒，在预浸泡阶段结束后稳定在约2.8毫升/秒。
2. 水输送量：总共泵送了87.7毫升的水，杯中有38克液体，表明咖啡饼中保留了大量的水分。
3. 压力曲线：从预浸泡到萃取过程中，压力曲线显示出了极好的进展，并且平滑过渡到了下降压力阶段。

性能评估
这似乎是一个技术上执行得很好的萃取，很好地遵循了预定的程序：

• 温度控制：在93-94°C左右表现出色的稳定性
• 压力曲线：按照预定程序平稳过渡
• 萃取流量：在主萃取阶段保持一致
• 产出重量：达到了38克（接近40克的目标）

您希望我针对这次萃取的某个特定方面提供更多具体的建议吗？或者是否有某个参数您想要我更详细地分析一下？