grr-gaggiuino-mcp 1.0.0

package/README.md

@@ -0,0 +1,106 @@
+# grr-gaggiuino-mcp
+
+An MCP (Model Context Protocol) server for [Gaggiuino](https://gaggiuino.github.io/)-modified espresso machines.
+
+Monitor your machine, analyze shots, and manage brewing profiles from any MCP-compatible client.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_status` | Real-time machine state: temperature, pressure, weight, water level, active profile, brewing/steaming status |
+| `get_shot` | Shot data with time-series curves (pressure, flow, temp, weight) and profile used. Defaults to latest shot. |
+| `get_profiles` | List all brewing profiles with IDs and selection status |
+| `select_profile` | Activate a brewing profile by ID |
+
+## Installation
+
+### Prerequisites
+
+- Node.js 18+
+- A Gaggiuino-modified espresso machine on your local network
+
+### Setup
+
+```bash
+git clone https://github.com/sgerlach/grr-gaggiuino-mcp.git
+cd grr-gaggiuino-mcp
+npm install
+npm run build
+```
+
+### Claude Desktop Configuration
+
+Add to your Claude Desktop config:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "gaggiuino": {
+      "command": "node",
+      "args": ["/path/to/grr-gaggiuino-mcp/dist/index.js"],
+      "env": {
+        "GAGGIUINO_BASE_URL": "http://YOUR_GAGGIUINO_IP"
+      }
+    }
+  }
+}
+```
+
+> **Note**: If using nvm, specify the full path to Node 18+:
+> ```json
+> "command": "/Users/you/.nvm/versions/node/v20.x.x/bin/node"
+> ```
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `GAGGIUINO_BASE_URL` | `http://192.168.3.248` | Your Gaggiuino's IP or hostname |
+| `REQUEST_TIMEOUT` | `5000` | API timeout in milliseconds |
+
+## Testing
+
+```bash
+# With MCP Inspector
+npm run inspect
+
+# Direct run
+GAGGIUINO_BASE_URL=http://YOUR_IP npm start
+```
+
+## Example Usage
+
+```
+You: "What's my machine doing?"
+→ get_status returns temp, pressure, active profile, etc.
+
+You: "Show me my last shot"
+→ get_shot returns full shot data with time-series curves
+
+You: "That shot was sour and thin, what should I change?"
+→ Analyzes the shot data and recommends grind/profile adjustments
+```
+
+## Unit Conversions
+
+The Gaggiuino API returns values in deci-units. This server converts them to standard units:
+
+| Raw API | Converted |
+|---------|-----------|
+| deciseconds | seconds |
+| decibar | bar |
+| decidegrees | °C |
+| decigrams | grams |
+| deci-ml/s | ml/s |
+
+## API Reference
+
+Based on the [Gaggiuino REST API](https://gaggiuino.github.io/#/rest-api/rest-api).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const GAGGIUINO_BASE_URL = process.env.GAGGIUINO_BASE_URL || "http://192.168.3.248";
+const REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || "5000", 10);
+// ============================================================================
+// API Client - matches official Gaggiuino REST API
+// https://gaggiuino.github.io/#/rest-api/rest-api
+// ============================================================================
+class GaggiuinoClient {
+    baseUrl;
+    timeout;
+    constructor(baseUrl, timeout) {
+        this.baseUrl = baseUrl;
+        this.timeout = timeout;
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+    }
+    async fetch(endpoint, options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const res = await fetch(`${this.baseUrl}${endpoint}`, {
+                ...options,
+                signal: controller.signal,
+            });
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+            return res;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`Request timeout after ${this.timeout}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    // GET /api/system/status - system sensors latest data
+    async getSystemStatus() {
+        const res = await this.fetch("/api/system/status");
+        const raw = await res.json();
+        if (!Array.isArray(raw) || raw.length === 0) {
+            throw new Error("Invalid API response: expected non-empty array from /api/system/status");
+        }
+        const s = raw[0];
+        if (!s || typeof s !== "object") {
+            throw new Error("Invalid API response: missing status data");
+        }
+        return {
+            brewing: s.brewSwitchState === "true",
+            steaming: s.steamSwitchState === "true",
+            profile: { id: parseInt(s.profileId), name: s.profileName },
+            temperature: { current: parseFloat(s.temperature), target: parseFloat(s.targetTemperature) },
+            pressure: parseFloat(s.pressure),
+            weight: parseFloat(s.weight),
+            waterLevel: parseInt(s.waterLevel),
+        };
+    }
+    // GET /api/shots/latest - latest shot identifier
+    async getLatestShotId() {
+        const res = await this.fetch("/api/shots/latest");
+        const raw = await res.json();
+        if (!Array.isArray(raw) || raw.length === 0 || !raw[0]?.lastShotId) {
+            throw new Error("Invalid API response: expected array with lastShotId from /api/shots/latest");
+        }
+        return parseInt(raw[0].lastShotId);
+    }
+    // GET /api/shots/{id} - shot data
+    async getShot(id) {
+        const res = await this.fetch(`/api/shots/${id}`);
+        const raw = await res.json();
+        if (!raw || typeof raw !== "object") {
+            throw new Error(`Invalid API response: expected object from /api/shots/${id}`);
+        }
+        const dp = raw.datapoints;
+        if (!dp || typeof dp !== "object") {
+            throw new Error(`Invalid shot data: missing datapoints for shot ${id}`);
+        }
+        // Convert from deci-units to standard units
+        return {
+            id: raw.id,
+            timestamp: new Date(raw.timestamp * 1000).toISOString(),
+            durationSeconds: raw.duration / 10,
+            profile: raw.profile ? {
+                id: raw.profile.id,
+                name: raw.profile.name,
+                temperatureC: raw.profile.waterTemperature,
+                stopConditions: raw.profile.globalStopConditions ? {
+                    weightG: raw.profile.globalStopConditions.weight,
+                    timeSeconds: raw.profile.globalStopConditions.time ? raw.profile.globalStopConditions.time / 1000 : null,
+                } : null,
+                phases: raw.profile.phases?.map((p) => ({
+                    name: p.name,
+                    type: p.type,
+                    target: { start: p.target.start, end: p.target.end, curve: p.target.curve },
+                    durationSeconds: p.stopConditions?.time ? p.stopConditions.time / 1000 : null,
+                    flowRestriction: p.restriction,
+                })),
+            } : null,
+            datapoints: {
+                timeSeconds: dp.timeInShot.map((t) => t / 10),
+                pressureBar: dp.pressure.map((p) => p / 10),
+                flowMlPerSec: dp.pumpFlow.map((f) => f / 10),
+                weightFlowGPerSec: dp.weightFlow.map((f) => f / 10),
+                temperatureC: dp.temperature.map((t) => t / 10),
+                weightG: dp.shotWeight.map((w) => w / 10),
+                waterPumpedMl: dp.waterPumped.map((w) => w / 10),
+                targets: {
+                    temperatureC: dp.targetTemperature.map((t) => t / 10),
+                    flowMlPerSec: dp.targetPumpFlow.map((f) => f / 10),
+                    pressureBar: dp.targetPressure.map((p) => p / 10),
+                },
+            },
+        };
+    }
+    // GET /api/profiles/all - all profiles
+    async getProfiles() {
+        const res = await this.fetch("/api/profiles/all");
+        const raw = await res.json();
+        if (!Array.isArray(raw)) {
+            throw new Error("Invalid API response: expected array from /api/profiles/all");
+        }
+        return raw.map(p => ({
+            id: p.id,
+            name: p.name,
+            selected: p.selected === "true",
+        }));
+    }
+    // POST /api/profile-select/{id} - select profile
+    async selectProfile(id) {
+        await this.fetch(`/api/profile-select/${id}`, { method: "POST" });
+    }
+}
+const client = new GaggiuinoClient(GAGGIUINO_BASE_URL, REQUEST_TIMEOUT);
+// ============================================================================
+// MCP Tools
+// ============================================================================
+const tools = [
+    {
+        name: "get_status",
+        description: "Get real-time Gaggiuino espresso machine status including: current/target temperature (Celsius), pressure (bar), scale weight (grams), water tank level (%), whether brewing or steaming is active, and the currently selected profile name and ID.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "get_shot",
+        description: "Retrieve detailed shot data with time-series curves for analysis. Returns pressure (bar), flow rate (ml/s), temperature (C), weight (g), and target values over time. Includes the profile used and shot duration. Omit ID to get the most recent shot.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Shot ID for historical data. Omit to get the latest shot." },
+            },
+        },
+    },
+    {
+        name: "get_profiles",
+        description: "List all available brewing profiles stored on the Gaggiuino. Returns profile IDs, names, and which one is currently selected. Use this to see available profiles before selecting one.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "select_profile",
+        description: "Activate a brewing profile by its ID. The machine will use this profile for the next shot. Get available profile IDs using get_profiles first.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Profile ID to activate" },
+            },
+            required: ["id"],
+        },
+    },
+];
+// ============================================================================
+// Server
+// ============================================================================
+const server = new Server({ name: "grr-gaggiuino-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "get_status": {
+                const status = await client.getSystemStatus();
+                return { content: [{ type: "text", text: JSON.stringify(status, null, 2) }] };
+            }
+            case "get_shot": {
+                let id;
+                if (args?.id !== undefined) {
+                    if (typeof args.id !== "number" || !Number.isInteger(args.id) || args.id <= 0) {
+                        throw new Error("Shot ID must be a positive integer");
+                    }
+                    id = args.id;
+                }
+                else {
+                    id = await client.getLatestShotId();
+                }
+                const shot = await client.getShot(id);
+                return { content: [{ type: "text", text: JSON.stringify(shot, null, 2) }] };
+            }
+            case "get_profiles": {
+                const profiles = await client.getProfiles();
+                return { content: [{ type: "text", text: JSON.stringify(profiles, null, 2) }] };
+            }
+            case "select_profile": {
+                if (typeof args?.id !== "number" || !Number.isInteger(args.id)) {
+                    throw new Error("Profile ID must be an integer");
+                }
+                await client.selectProfile(args.id);
+                return { content: [{ type: "text", text: `Profile ${args.id} selected` }] };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`grr-gaggiuino-mcp running (${GAGGIUINO_BASE_URL})`);
+}
+main().catch(e => { console.error(e); process.exit(1); });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/manifest.json

@@ -0,0 +1,78 @@
+{
+  "dxt_version": "0.1",
+  "name": "grr-gaggiuino-mcp",
+  "version": "1.0.0",
+  "display_name": "Gaggiuino Espresso Tools",
+  "description": "MCP server for Gaggiuino-modified espresso machines. Monitor machine status, analyze shot data with time-series curves, and manage brewing profiles.",
+  "long_description": "Connect any MCP client to your Gaggiuino-modified espresso machine. Get real-time machine status (temperature, pressure, weight), retrieve detailed shot data with time-series curves for analysis, list and select brewing profiles. Perfect for shot analysis, dial-in recommendations, and understanding your espresso extraction.",
+  "author": {
+    "name": "Scott Gerlach",
+    "url": "https://github.com/sgerlach"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sgerlach/grr-gaggiuino-mcp"
+  },
+  "homepage": "https://github.com/sgerlach/grr-gaggiuino-mcp",
+  "keywords": [
+    "espresso",
+    "coffee",
+    "gaggiuino",
+    "iot",
+    "smart home"
+  ],
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/dist/index.js"],
+      "env": {
+        "GAGGIUINO_BASE_URL": "${user_config.gaggiuino_url}",
+        "REQUEST_TIMEOUT": "${user_config.request_timeout}"
+      }
+    }
+  },
+  "user_config": {
+    "gaggiuino_url": {
+      "type": "string",
+      "title": "Gaggiuino URL",
+      "description": "The URL of your Gaggiuino machine (e.g., http://192.168.1.100 or http://gaggiuino.local)",
+      "default": "http://192.168.3.248",
+      "required": true
+    },
+    "request_timeout": {
+      "type": "string",
+      "title": "Request Timeout",
+      "description": "API request timeout in milliseconds",
+      "default": "5000",
+      "required": false
+    }
+  },
+  "tools": [
+    {
+      "name": "get_status",
+      "description": "Get real-time Gaggiuino espresso machine status including: current/target temperature (Celsius), pressure (bar), scale weight (grams), water tank level (%), whether brewing or steaming is active, and the currently selected profile name and ID."
+    },
+    {
+      "name": "get_shot",
+      "description": "Retrieve detailed shot data with time-series curves for analysis. Returns pressure (bar), flow rate (ml/s), temperature (C), weight (g), and target values over time. Includes the profile used and shot duration. Omit ID to get the most recent shot, or specify a shot ID for historical data."
+    },
+    {
+      "name": "get_profiles",
+      "description": "List all available brewing profiles stored on the Gaggiuino. Returns profile IDs, names, and which one is currently selected. Use this to see available profiles before selecting one."
+    },
+    {
+      "name": "select_profile",
+      "description": "Activate a brewing profile by its ID. The machine will use this profile for the next shot. Get available profile IDs using get_profiles first."
+    }
+  ],
+  "compatibility": {
+    "claude_desktop": ">=0.10.0",
+    "platforms": ["darwin", "win32"],
+    "runtimes": {
+      "node": ">=18"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "grr-gaggiuino-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Gaggiuino espresso machine monitoring and control - get shot data, machine status, and manage brewing profiles",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "grr-gaggiuino-mcp": "dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sgerlach/grr-gaggiuino-mcp.git"
+  },
+  "homepage": "https://github.com/sgerlach/grr-gaggiuino-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/sgerlach/grr-gaggiuino-mcp/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist",
+    "pack": "npm run build && mcpb pack"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "gaggiuino",
+    "espresso",
+    "coffee",
+    "iot",
+    "smart-home",
+    "brewing",
+    "shot-analysis"
+  ],
+  "author": "Scott Gerlach <sgerlach@github.com>",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@anthropic-ai/mcpb": "^2.1.2",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "manifest.json"
+  ]
+}