mcp-server-gaggiuino

🚀 Gaggiuino MCP 服务器

Gaggiuino MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它为经过 Gaggiuino 修改的意式咖啡机提供标准化接口。借助 MCP 协议，用户能够轻松访问和控制 Gaggia 咖啡机的 API。

🚀 快速开始

本服务器旨在为经过 Gaggiuino 修改的意式咖啡机提供便捷的访问和控制方式。您可以通过以下步骤快速启动服务器。

✨ 主要特性

• 🔍 访问打奶昔数据和历史记录，随时回顾咖啡机的工作情况。
• 📋 查看和管理意式咖啡配方，满足多样化的口味需求。
• 📈 实时监控机器状态，确保咖啡机始终处于最佳工作状态。
• ⬆️ 上传新的打奶昔数据，不断丰富数据资源。
• 🤖 与 AI 助手和其他 MCP 客户端兼容，拓展更多应用场景。

📦 安装指南

先决条件

• Node.js 18 或更高版本
• 可通过 HTTP 访问的 Gaggiuino 修改过的意式咖啡机
• npm 或 yarn

安装步骤

1. 克隆此仓库：

git clone https://github.com/yourusername/mcp-server-gaggiuino.git
cd mcp-server-gaggiuino

2. 安装依赖项：

npm install

3. 构建项目：

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

1. 在 Claude Desktop 中，转到设置 > MCP 服务器。
2. 添加新的服务器，命令为：node /path/to/mcp-server-gaggiuino/dist/index.js

API 参考

工具

• getSystemStatus：获取当前咖啡机状态
• getLatestShot：获取最近的打奶昔 ID
• getShotData：根据 ID 获取特定打奶昔的详细数据
• getAllProfiles：获取所有可用配方列表
• selectProfile：通过 ID 选择配方
• deleteProfile：通过 ID 删除配方
• uploadShot：上传新的打奶昔数据

📄 许可证

本项目采用 MIT 许可证。

🙏 致谢

• Gaggiuino 项目
• FastMCP
• Model Context Protocol