mcpField
G
Gaggiuino MCP Server

Gaggiuino MCP Server

Local
github.com/WynnDGames & Entertainment1Updated 82w ago
Repository

About Gaggiuino MCP Server

Gaggiuino MCP Server connects MCP clients to the API of Gaggia machines modified with Gaggiuino. It provides tools for shot records, espresso profiles, and live machine status.

Key features

  1. 01View live machine status
  2. 02Read latest and historical shots
  3. 03View and manage espresso profiles
  4. 04Upload shot data

Use cases

  1. 01Check the machine's current state
  2. 02Review detailed data for a shot
  3. 03Select or delete an espresso profile
  4. 04Upload shot records to the machine API

MCP support

The MCP server exposes Gaggiuino API operations as tools for MCP clients, including status and shot queries, profile management, and data uploads.

#mcp-server#espresso-machine#gaggiuino

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Installation

  1. Clone this repository:

    git clone https://github.com/yourusername/mcp-server-gaggiuino.git
cd mcp-server-gaggiuino

  2. Install dependencies:

    npm install

  3. Build the project:

    npm run build

Configuration

Configure the server using environment variables:

  • GAGGIUINO_BASE_URL: URL of your Gaggiuino API (default: http://localhost:3000)
  • SERVER_PORT: Port for HTTP transport (default: 8080)
  • MCP_TRANSPORT_TYPE: Transport type (stdio or http, default: stdio)
  • REQUEST_TIMEOUT: API request timeout in ms (default: 5000)
  • LOG_LEVEL: Logging level (default: info)

Usage

Starting the Server
npm start

For development with hot reloading:

npm run dev
Testing with MCP Inspector
npm run inspect
Connecting to Claude Desktop
  1. In Claude Desktop, go to Settings > MCP Servers
  2. Add a new server with the command: node /path/to/mcp-server-gaggiuino/dist/index.js

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

License

MIT

Acknowledgements

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.