咖啡机控制服务器

Gaggiuino MCP服务器为改装咖啡机提供标准化接口,实现咖啡机状态监控、咖啡制作数据管理和配置文件控制。

  • by WynnD
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 WynnD/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
    
  2. 安装依赖项:

    npm install
    
  3. 构建项目:

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

许可证

麻省理工学院

致谢