Gaggiuino MCP Server
2025.04.01
0
TypeScript咖啡机控制智能家居其它
Gaggiuino MCP Server 是一个为经过Gaggiuino改装的意式咖啡机设计的Model Context Protocol (MCP)服务器。它提供了一个标准化的接口，通过MCP协议访问和控制Gaggia咖啡机的API。该服务器支持访问咖啡制作数据、管理咖啡制作配置文件、实时监控咖啡机状态以及上传新的咖啡制作数据等功能。
View on GitHub
Overview
基本能力
产品定位
Gaggiuino MCP Server 是一个为Gaggiuino改装的意式咖啡机设计的MCP服务器，提供标准化的API接口。
核心功能
- 访问咖啡制作数据和历史记录
- 查看和管理意式咖啡制作配置文件
- 实时监控咖啡机状态
- 上传新的咖啡制作数据
- 兼容AI助手和其他MCP客户端
适用场景
- 咖啡爱好者远程监控和控制咖啡机
- 咖啡店管理多台咖啡机的状态和数据
- 开发者集成咖啡机控制到智能家居系统
工具列表
getSystemStatus: 获取咖啡机当前状态getLatestShot: 获取最近一次咖啡制作的IDgetShotData: 通过ID获取特定咖啡制作的详细数据getAllProfiles: 获取所有可用配置文件的列表selectProfile: 通过ID选择配置文件deleteProfile: 通过ID删除配置文件uploadShot: 上传新的咖啡制作数据
常见问题解答
文档中未提供具体常见问题解答。
使用教程
使用依赖
- Node.js 18或更高版本
- 可通过HTTP访问的Gaggiuino改装咖啡机
- npm或yarn
安装教程
-
克隆仓库:
bash git clone https://github.com/yourusername/mcp-server-gaggiuino.git cd mcp-server-gaggiuino -
安装依赖:
bash npm install -
构建项目:
bash 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请求超时时间(ms,默认:5000)
- LOG_LEVEL: 日志级别(默认:info)
调试方式
启动服务器:
npm start
开发模式下启动(带热重载):
npm run dev
使用MCP Inspector测试:
npm run inspect
连接到Claude Desktop:
1. 在Claude Desktop中,转到Settings > MCP Servers
2. 添加新服务器,命令为:node /path/to/mcp-server-gaggiuino/dist/index.js