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

致谢

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