mcp-server-gaggiuino

mcp-server-gaggiuino

0

Gaggiuino MCP Server is a protocol server designed for modified Gaggia espresso machines, enabling users to access and control the machine through a standardized API. It supports real-time monitoring, profile management, and compatibility with AI assistants.

Gaggiuino MCP Server

A Model Context Protocol (MCP) server for Gaggiuino-modified espresso machines. This server provides a standardized interface to access and control your Gaggia espresso machine's API through the MCP protocol.

Features

  • Access shot data and history
  • View and manage espresso profiles
  • Monitor machine status in real-time
  • Upload new shot data
  • Compatible with AI assistants and other MCP clients

Prerequisites

  • Node.js 18 or later
  • A Gaggiuino-modified espresso machine accessible via HTTP
  • npm or yarn

Usage

Starting the Server

For development with hot reloading, run npm run dev. Connect to Claude Desktop by adding a new server through MCP Servers configuration.

API Reference

Tools

  • getSystemStatus: Get the current status of the espresso machine
  • getLatestShot: Get the ID of the most recent shot
  • getShotData: Get detailed data for a specific shot by ID
  • getAllProfiles: Get a list of all available profiles
  • selectProfile: Select a profile by ID
  • deleteProfile: Delete a profile by ID
  • uploadShot: Upload data for a new shot.