mcpField
G
Gaggiuino MCP Server

Gaggiuino MCP Server

本地服务
github.com/WynnD游戏娱乐182 周前更新
代码仓库

关于 Gaggiuino MCP Server

Gaggiuino MCP Server 为改装 Gaggiuino 的 Gaggia 咖啡机提供标准化接口，供 MCP 客户端读取机器数据并执行配置操作。它涵盖冲煮记录、咖啡配置和实时状态。

主要功能

  1. 01查看机器实时状态
  2. 02读取最新及历史冲煮数据
  3. 03查看和管理咖啡配置
  4. 04上传冲煮数据

适用场景

  1. 01检查咖啡机当前状态
  2. 02回顾某次萃取的详细数据
  3. 03选择或删除咖啡配置
  4. 04将冲煮记录上传至机器 API

MCP 相关

该 MCP 服务将 Gaggiuino API 操作作为工具提供给 MCP 客户端，包括查询状态和冲煮数据、管理配置及上传数据。

#mcp-server#espresso-machine#gaggiuino

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Gaggiuino MCP 服务

一个适用于 Gaggiuino 改装意式咖啡机的模型上下文协议（MCP）服务。此服务通过 MCP 协议提供标准化接口，用于访问和控制 Gaggia 意式咖啡机的 API。

功能

  • 访问咖啡萃取数据和历史记录
  • 查看和管理意式咖啡配置文件
  • 实时监控咖啡机状态
  • 上传新的咖啡萃取数据
  • 兼容 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 Inspector 测试
npm run inspect
连接到 Claude Desktop
  1. 在 Claude Desktop 中，前往 Settings > MCP Servers
  2. 添加新服务，命令为：node /path/to/mcp-server-gaggiuino/dist/index.js

API 参考

工具
  • getSystemStatus：获取意式咖啡机的当前状态
  • getLatestShot：获取最近一次咖啡萃取的 ID
  • getShotData：按 ID 获取指定咖啡萃取的详细数据
  • getAllProfiles：获取所有可用配置文件的列表
  • selectProfile：按 ID 选择配置文件
  • deleteProfile：按 ID 删除配置文件
  • uploadShot：上传新一次咖啡萃取的数据

许可证

MIT

致谢

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。