@tmhs/homelab-mcp 0.1.0 → 0.2.0

package/LICENSE

@@ -1,31 +1,31 @@
-Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International
-
-Copyright (c) 2026 TM Hospitality Strategies
-
-SPDX-License-Identifier: CC-BY-NC-ND-4.0
-
-You are free to:
-
-  Share - copy and redistribute the material in any medium or format.
-
-The licensor cannot revoke these freedoms as long as you follow the
-license terms.
-
-Under the following terms:
-
-  Attribution - You must give appropriate credit, provide a link to
-  the license, and indicate if changes were made. You may do so in
-  any reasonable manner, but not in any way that suggests the licensor
-  endorses you or your use.
-
-  NonCommercial - You may not use the material for commercial purposes.
-
-  NoDerivatives - If you remix, transform, or build upon the material,
-  you may not distribute the modified material.
-
-  No additional restrictions - You may not apply legal terms or
-  technological measures that legally restrict others from doing
-  anything the license permits.
-
-Full license text:
-https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode
+Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International
+
+Copyright (c) 2026 TM Hospitality Strategies
+
+SPDX-License-Identifier: CC-BY-NC-ND-4.0
+
+You are free to:
+
+  Share - copy and redistribute the material in any medium or format.
+
+The licensor cannot revoke these freedoms as long as you follow the
+license terms.
+
+Under the following terms:
+
+  Attribution - You must give appropriate credit, provide a link to
+  the license, and indicate if changes were made. You may do so in
+  any reasonable manner, but not in any way that suggests the licensor
+  endorses you or your use.
+
+  NonCommercial - You may not use the material for commercial purposes.
+
+  NoDerivatives - If you remix, transform, or build upon the material,
+  you may not distribute the modified material.
+
+  No additional restrictions - You may not apply legal terms or
+  technological measures that legally restrict others from doing
+  anything the license permits.
+
+Full license text:
+https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode

package/README.md

@@ -1,71 +1,71 @@
-# Home Lab MCP Server
-
-MCP (Model Context Protocol) server for home lab operations. Connects to a Raspberry Pi via SSH and provides 15 tools for system management, Docker Compose stacks, service monitoring, networking, and backups.
-
-## Tools
-
-| Category | Tool | Description |
-|----------|------|-------------|
-| System | `homelab_piStatus` | CPU temp, memory, disk, uptime, throttle state |
-| System | `homelab_piReboot` | Safe reboot with pre-checks |
-| System | `homelab_diskUsage` | Disk usage breakdown by directory |
-| System | `homelab_aptUpdate` | Run apt update, list upgradable packages |
-| Containers | `homelab_serviceHealth` | Docker container health status |
-| Containers | `homelab_serviceLogs` | Tail container logs |
-| Containers | `homelab_serviceRestart` | Restart a container |
-| Compose | `homelab_composeUp` | Start compose stacks |
-| Compose | `homelab_composeDown` | Stop compose stacks |
-| Compose | `homelab_composePull` | Pull latest images |
-| Compose | `homelab_composePs` | List running containers |
-| Network | `homelab_networkInfo` | IP addresses, DNS, Tailscale status |
-| Backup | `homelab_backupStatus` | Check latest restic snapshots |
-| Backup | `homelab_backupRun` | Trigger restic backup |
-| SSH | `homelab_sshTest` | Test SSH connectivity |
-
-## Setup
-
-```bash
-cd mcp-server
-npm install
-npm run build
-```
-
-## Configuration
-
-Set environment variables:
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `HOMELAB_PI_HOST` | `raspi5.local` | Pi hostname or IP |
-| `HOMELAB_PI_USER` | `tmhs` | SSH username |
-| `HOMELAB_PI_KEY_PATH` | (empty) | Path to SSH private key |
-| `HOMELAB_COMPOSE_DIR` | `/opt/homelab/docker` | Compose project directory on Pi |
-| `HOMELAB_BACKUP_REPO` | `/mnt/backup/restic` | Restic backup repo path on Pi |
-
-## Usage with Cursor
-
-Add to `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "homelab": {
-      "command": "node",
-      "args": ["path/to/Home-Lab-Developer-Tools/mcp-server/dist/index.js"],
-      "env": {
-        "HOMELAB_PI_HOST": "raspi5.local",
-        "HOMELAB_PI_USER": "tmhs",
-        "HOMELAB_PI_KEY_PATH": "~/.ssh/id_ed25519_pi"
-      }
-    }
-  }
-}
-```
-
-## Development
-
-```bash
-npm run dev    # Watch mode with tsx
-npm test       # Run Vitest tests
-npm run build  # Compile TypeScript
-```
+# Home Lab MCP Server
+
+MCP (Model Context Protocol) server for home lab operations. Connects to a Raspberry Pi via SSH and provides 15 tools for system management, Docker Compose stacks, service monitoring, networking, and backups.
+
+## Tools
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| System | `homelab_piStatus` | CPU temp, memory, disk, uptime, throttle state |
+| System | `homelab_piReboot` | Safe reboot with pre-checks |
+| System | `homelab_diskUsage` | Disk usage breakdown by directory |
+| System | `homelab_aptUpdate` | Run apt update, list upgradable packages |
+| Containers | `homelab_serviceHealth` | Docker container health status |
+| Containers | `homelab_serviceLogs` | Tail container logs |
+| Containers | `homelab_serviceRestart` | Restart a container |
+| Compose | `homelab_composeUp` | Start compose stacks |
+| Compose | `homelab_composeDown` | Stop compose stacks |
+| Compose | `homelab_composePull` | Pull latest images |
+| Compose | `homelab_composePs` | List running containers |
+| Network | `homelab_networkInfo` | IP addresses, DNS, Tailscale status |
+| Backup | `homelab_backupStatus` | Check latest restic snapshots |
+| Backup | `homelab_backupRun` | Trigger restic backup |
+| SSH | `homelab_sshTest` | Test SSH connectivity |
+
+## Setup
+
+```bash
+cd mcp-server
+npm install
+npm run build
+```
+
+## Configuration
+
+Set environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `HOMELAB_PI_HOST` | `raspi5.local` | Pi hostname or IP |
+| `HOMELAB_PI_USER` | `tmhs` | SSH username |
+| `HOMELAB_PI_KEY_PATH` | (empty) | Path to SSH private key |
+| `HOMELAB_COMPOSE_DIR` | `/opt/homelab/docker` | Compose project directory on Pi |
+| `HOMELAB_BACKUP_REPO` | `/mnt/backup/restic` | Restic backup repo path on Pi |
+
+## Usage with Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "homelab": {
+      "command": "node",
+      "args": ["path/to/Home-Lab-Developer-Tools/mcp-server/dist/index.js"],
+      "env": {
+        "HOMELAB_PI_HOST": "raspi5.local",
+        "HOMELAB_PI_USER": "tmhs",
+        "HOMELAB_PI_KEY_PATH": "~/.ssh/id_ed25519_pi"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+npm run dev    # Watch mode with tsx
+npm test       # Run Vitest tests
+npm run build  # Compile TypeScript
+```

package/dist/index.js

@@ -16,9 +16,14 @@ import { register as registerBackupStatus } from "./tools/backupStatus.js";
 import { register as registerBackupRun } from "./tools/backupRun.js";
 import { register as registerAptUpdate } from "./tools/aptUpdate.js";
 import { register as registerSshTest } from "./tools/sshTest.js";
+import { register as registerPrometheusQuery } from "./tools/prometheusQuery.js";
+import { register as registerGrafanaSnapshot } from "./tools/grafanaSnapshot.js";
+import { register as registerUptimeKumaStatus } from "./tools/uptimeKumaStatus.js";
+import { register as registerAlertList } from "./tools/alertList.js";
+import { register as registerSpeedtestResults } from "./tools/speedtestResults.js";
 const server = new McpServer({
     name: "homelab-mcp",
-    version: "0.1.0",
+    version: "0.2.0",
 });
 registerPiStatus(server);
 registerPiReboot(server);
@@ -35,6 +40,11 @@ registerBackupStatus(server);
 registerBackupRun(server);
 registerAptUpdate(server);
 registerSshTest(server);
+registerPrometheusQuery(server);
+registerGrafanaSnapshot(server);
+registerUptimeKumaStatus(server);
+registerAlertList(server);
+registerSpeedtestResults(server);
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AAExB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/alertList.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=alertList.d.ts.map

package/dist/tools/alertList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alertList.d.ts","sourceRoot":"","sources":["../../src/tools/alertList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkBhD"}

package/dist/tools/alertList.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    state: z
+        .enum(["active", "suppressed", "unprocessed"])
+        .optional()
+        .describe("Filter alerts by state. Returns all states if omitted"),
+};
+export function register(server) {
+    server.tool("homelab_alertList", "List alerts from Alertmanager, optionally filtered by state", inputSchema, async (args) => {
+        try {
+            const stateParam = args.state ? `?state=${args.state}` : "";
+            const output = await execSSH(`curl -sf 'http://localhost:9093/api/v2/alerts${stateParam}'`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=alertList.js.map

package/dist/tools/alertList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alertList.js","sourceRoot":"","sources":["../../src/tools/alertList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;SAC7C,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;CACrE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,6DAA6D,EAC7D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,gDAAgD,UAAU,GAAG,CAC9D,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/grafanaSnapshot.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=grafanaSnapshot.d.ts.map

package/dist/tools/grafanaSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafanaSnapshot.d.ts","sourceRoot":"","sources":["../../src/tools/grafanaSnapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiBhD"}

package/dist/tools/grafanaSnapshot.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    dashboard: z.string().min(1).describe("Dashboard UID to export"),
+};
+export function register(server) {
+    server.tool("homelab_grafanaSnapshot", "Export a Grafana dashboard configuration by UID", inputSchema, async (args) => {
+        try {
+            const output = await execSSH(`curl -sf 'http://localhost:3000/api/dashboards/uid/${args.dashboard}'`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=grafanaSnapshot.js.map

package/dist/tools/grafanaSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafanaSnapshot.js","sourceRoot":"","sources":["../../src/tools/grafanaSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,GAAG;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACjE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,iDAAiD,EACjD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,sDAAsD,IAAI,CAAC,SAAS,GAAG,CACxE,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/prometheusQuery.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=prometheusQuery.d.ts.map

package/dist/tools/prometheusQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheusQuery.d.ts","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBhD"}

package/dist/tools/prometheusQuery.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    query: z.string().min(1).describe("PromQL expression to evaluate"),
+    time: z
+        .string()
+        .optional()
+        .describe("Evaluation timestamp (RFC3339 or Unix). Defaults to current time"),
+};
+export function register(server) {
+    server.tool("homelab_prometheusQuery", "Run a PromQL query against Prometheus and return the result", inputSchema, async (args) => {
+        try {
+            const encoded = encodeURIComponent(args.query);
+            const timeParam = args.time ? `&time=${encodeURIComponent(args.time)}` : "";
+            const output = await execSSH(`curl -sf 'http://localhost:9090/api/v1/query?query=${encoded}${timeParam}'`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=prometheusQuery.js.map

package/dist/tools/prometheusQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheusQuery.js","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAClE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,6DAA6D,EAC7D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,sDAAsD,OAAO,GAAG,SAAS,GAAG,CAC7E,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/speedtestResults.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=speedtestResults.d.ts.map

package/dist/tools/speedtestResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speedtestResults.d.ts","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiBhD"}

package/dist/tools/speedtestResults.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    count: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(5)
+        .describe("Number of recent speedtest results to return"),
+};
+export function register(server) {
+    server.tool("homelab_speedtestResults", "Get recent speedtest results from Speedtest Tracker", inputSchema, async (args) => {
+        try {
+            const output = await execSSH(`curl -sf 'http://localhost:8765/api/speedtest/latest?limit=${args.count}'`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=speedtestResults.js.map

package/dist/tools/speedtestResults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speedtestResults.js","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,qDAAqD,EACrD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8DAA8D,IAAI,CAAC,KAAK,GAAG,CAC5E,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/uptimeKumaStatus.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=uptimeKumaStatus.d.ts.map

package/dist/tools/uptimeKumaStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptimeKumaStatus.d.ts","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiBhD"}

package/dist/tools/uptimeKumaStatus.js

@@ -0,0 +1,13 @@
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+export function register(server) {
+    server.tool("homelab_uptimeKumaStatus", "Get the status of all Uptime Kuma monitors", {}, async () => {
+        try {
+            const output = await execSSH(`curl -sf 'http://localhost:3001/api/status-page/heartbeat/default'`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=uptimeKumaStatus.js.map

package/dist/tools/uptimeKumaStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptimeKumaStatus.js","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,4CAA4C,EAC5C,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,oEAAoE,CACrE,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,49 +1,49 @@
-{
-  "name": "@tmhs/homelab-mcp",
-  "version": "0.1.0",
-  "description": "MCP server for home lab operations via SSH - 15 tools for system status, Docker Compose management, service health, networking, backups, and administration on a Raspberry Pi.",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "homelab-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">= 20.0.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/index.ts",
-    "start": "node dist/index.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "ssh2": "^1.16.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/node": "^25.5.2",
-    "@types/ssh2": "^1.15.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.7.0",
-    "vitest": "^4.1.2"
-  },
-  "license": "CC-BY-NC-ND-4.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/TMHSDigital/Home-Lab-Developer-Tools.git",
-    "directory": "mcp-server"
-  },
-  "homepage": "https://github.com/TMHSDigital/Home-Lab-Developer-Tools",
-  "bugs": {
-    "url": "https://github.com/TMHSDigital/Home-Lab-Developer-Tools/issues"
-  },
-  "author": "TMHSDigital"
-}
+{
+  "name": "@tmhs/homelab-mcp",
+  "version": "0.2.0",
+  "description": "MCP server for home lab operations via SSH - 20 tools for system status, Docker Compose management, service health, monitoring, networking, backups, and administration on a Raspberry Pi.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "homelab-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">= 20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "ssh2": "^1.16.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "@types/ssh2": "^1.15.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.2"
+  },
+  "license": "CC-BY-NC-ND-4.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TMHSDigital/Home-Lab-Developer-Tools.git",
+    "directory": "mcp-server"
+  },
+  "homepage": "https://github.com/TMHSDigital/Home-Lab-Developer-Tools",
+  "bugs": {
+    "url": "https://github.com/TMHSDigital/Home-Lab-Developer-Tools/issues"
+  },
+  "author": "TMHSDigital"
+}