🚀 Gaggiuino MCP 服务器
Gaggiuino MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它为经过 Gaggiuino 修改的意式咖啡机提供标准化接口。借助 MCP 协议，用户能够轻松访问和控制 Gaggia 咖啡机的 API。
🚀 快速开始
本服务器旨在为经过 Gaggiuino 修改的意式咖啡机提供便捷的访问和控制方式。您可以通过以下步骤快速启动服务器。
✨ 主要特性
- 🔍 访问打奶昔数据和历史记录，随时回顾咖啡机的工作情况。
- 📋 查看和管理意式咖啡配方，满足多样化的口味需求。
- 📈 实时监控机器状态，确保咖啡机始终处于最佳工作状态。
- ⬆️ 上传新的打奶昔数据，不断丰富数据资源。
- 🤖 与 AI 助手和其他 MCP 客户端兼容，拓展更多应用场景。
📦 安装指南
先决条件
- Node.js 18 或更高版本
- 可通过 HTTP 访问的 Gaggiuino 修改过的意式咖啡机
- npm 或 yarn
安装步骤
- 克隆此仓库：
git clone https://github.com/yourusername/mcp-server-gaggiuino.git
cd mcp-server-gaggiuino
- 安装依赖项：
npm install
- 构建项目：
npm run build
📚 详细文档
配置
使用环境变量配置服务器：
| 属性 | 详情 |
|---|---|
GAGGIUINO_BASE_URL |
Gaggiuino API 的 URL（默认：http://localhost:3000） |
SERVER_PORT |
HTTP 传输端口（默认：8080） |
MCP_TRANSPORT_TYPE |
传输类型（stdio 或 http，默认：stdio） |
REQUEST_TIMEOUT |
API 请求超时时间（单位：毫秒，默认：5000） |
LOG_LEVEL |
日志级别（默认：info） |
使用方法
启动服务器
npm start
用于开发且带有热重载：
npm run dev
与 MCP 检查器一起使用
npm run inspect
连接到 Claude Desktop
- 在 Claude Desktop 中，转到设置 > MCP 服务器。
- 添加新的服务器，命令为：
node /path/to/mcp-server-gaggiuino/dist/index.js
API 参考
工具
getSystemStatus：获取当前咖啡机状态getLatestShot：获取最近的打奶昔 IDgetShotData：根据 ID 获取特定打奶昔的详细数据getAllProfiles：获取所有可用配方列表selectProfile：通过 ID 选择配方deleteProfile：通过 ID 删除配方uploadShot：上传新的打奶昔数据
📄 许可证
本项目采用 MIT 许可证。