Gaggiuino MCP Server
Description
# 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 -…
About
# 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 -…
Details
- Author
- WynnD
- Downloads
- 155
- Categories
- Other
Jump to
- 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
- HTTP and stdio transport support
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Gaggiuino MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, run npm install and npm run build, then configure environment variables such as GAGGIUINO_BASE_URL (default http://localhost:3000) and MCP_TRANSPORT_TYPE (default stdio). Start the server with npm start. To connect from Claude Desktop, add an MCP server with the command node /path/to/mcp-server-gaggiuino/dist/index.js.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gaggiuino mcp server": {
"gaggiuino-mcp-server": {
"command": "node",
"args": [
"/path/to/mcp-server-gaggiuino/dist/index.js"
],
"env": {
"GAGGIUINO_BASE_URL": "",
"SERVER_PORT": "",
"MCP_TRANSPORT_TYPE": "",
"REQUEST_TIMEOUT": "",
"LOG_LEVEL": ""
}
}
}
}
}McpServers
{
"gaggiuino-mcp-server": {
"command": "node",
"args": [
"/path/to/mcp-server-gaggiuino/dist/index.js"
],
"env": {
"GAGGIUINO_BASE_URL": "",
"SERVER_PORT": "",
"MCP_TRANSPORT_TYPE": "",
"REQUEST_TIMEOUT": "",
"LOG_LEVEL": ""
}
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
