🚀 一键上手的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"
]
}
}
}
💻 使用示例
可用工具集
| 属性 | 详情 |
|---|---|
getLatestShotId |
获取最新意式浓缩咖啡ID |
getShotData |
根据指定ID获取意式浓缩咖啡数据。参数：id: 咖啡ID |
getStatus |
获取咖啡机状态信息 |
基础用法
用户需求
分析最近一次的意式浓缩咖啡数据
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助手能够提供专业的数据解读和优化建议，帮助提升您的意式浓缩咖啡制作水平。