MCP Server Gaggiuino

MCP 服务器

Gaggiuino改进型意式浓缩咖啡机的模型上下文协议（MCP）服务器。该服务器提供了一个标准化接口，通过MCP协议访问和控制Gaggia浓缩咖啡机的API。

特性

• 访问拍摄数据和历史记录
• 查看和管理浓缩咖啡档案
• 实时监控机器状态
• 上传新的拍摄数据
• 与AI助手和其他MCP客户端兼容

先决条件

• Node.js 18或更高版本
• 通过HTTP访问的Gaggiuino修改的咖啡机
• npm或纱线

安装

1. 克隆此存储库：

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

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

配置

使用环境变量配置服务器：

• GAGGIUINO_BASE_URL您的 Gaggiuino API 的网址 (默认: 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

连接到克劳德桌面

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：上传新镜头的数据

许可证

麻省理工学院

致谢

• Gaggiuino 项目
• FastMCP
• 模型上下文协议