@tmhs/homelab-mcp 0.1.0

package/LICENSE

@@ -0,0 +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

package/README.md

@@ -0,0 +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
+```

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,46 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { register as registerPiStatus } from "./tools/piStatus.js";
+import { register as registerPiReboot } from "./tools/piReboot.js";
+import { register as registerServiceHealth } from "./tools/serviceHealth.js";
+import { register as registerServiceLogs } from "./tools/serviceLogs.js";
+import { register as registerServiceRestart } from "./tools/serviceRestart.js";
+import { register as registerComposeUp } from "./tools/composeUp.js";
+import { register as registerComposeDown } from "./tools/composeDown.js";
+import { register as registerComposePull } from "./tools/composePull.js";
+import { register as registerComposePs } from "./tools/composePs.js";
+import { register as registerNetworkInfo } from "./tools/networkInfo.js";
+import { register as registerDiskUsage } from "./tools/diskUsage.js";
+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";
+const server = new McpServer({
+    name: "homelab-mcp",
+    version: "0.1.0",
+});
+registerPiStatus(server);
+registerPiReboot(server);
+registerServiceHealth(server);
+registerServiceLogs(server);
+registerServiceRestart(server);
+registerComposeUp(server);
+registerComposeDown(server);
+registerComposePull(server);
+registerComposePs(server);
+registerNetworkInfo(server);
+registerDiskUsage(server);
+registerBackupStatus(server);
+registerBackupRun(server);
+registerAptUpdate(server);
+registerSshTest(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    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":";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"}

package/dist/tools/aptUpdate.d.ts

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

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

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

package/dist/tools/aptUpdate.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    upgrade: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Also run apt upgrade after update (default: false, just lists upgradable)"),
+};
+export function register(server) {
+    server.tool("homelab_aptUpdate", "Run apt update on the Pi and list upgradable packages", inputSchema, async (args) => {
+        try {
+            let cmd = "sudo apt-get update -qq 2>&1 && apt list --upgradable 2>/dev/null";
+            if (args.upgrade) {
+                cmd += " && sudo apt-get upgrade -y 2>&1";
+            }
+            const output = await execSSH(cmd);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=aptUpdate.js.map

package/dist/tools/aptUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aptUpdate.js","sourceRoot":"","sources":["../../src/tools/aptUpdate.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,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,2EAA2E,CAAC;CACzF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,uDAAuD,EACvD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,GAAG,GAAG,mEAAmE,CAAC;YAC9E,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,GAAG,IAAI,kCAAkC,CAAC;YAC5C,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAElC,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/backupRun.d.ts

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

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

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

package/dist/tools/backupRun.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    confirm: z
+        .boolean()
+        .describe("Must be true to trigger a backup. Safety check."),
+};
+export function register(server) {
+    server.tool("homelab_backupRun", "Trigger a restic backup on the Pi", inputSchema, async (args) => {
+        try {
+            if (!args.confirm) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "Backup cancelled. Set confirm=true to proceed.",
+                        }],
+                };
+            }
+            const output = await execSSH("sudo /opt/backup/backup.sh 2>&1 || echo 'Backup script not found at /opt/backup/backup.sh'");
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=backupRun.js.map

package/dist/tools/backupRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupRun.js","sourceRoot":"","sources":["../../src/tools/backupRun.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,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,CAAC,iDAAiD,CAAC;CAC/D,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,mCAAmC,EACnC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,gDAAgD;yBACvD,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,4FAA4F,CAC7F,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/backupStatus.d.ts

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

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

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

package/dist/tools/backupStatus.js

@@ -0,0 +1,24 @@
+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 snapshots to show"),
+};
+export function register(server) {
+    server.tool("homelab_backupStatus", "Check the latest restic backup snapshots on the Pi", inputSchema, async (args) => {
+        try {
+            const repo = process.env.HOMELAB_BACKUP_REPO || "/mnt/backup/restic";
+            const output = await execSSH(`sudo restic -r ${repo} snapshots --latest ${args.count} 2>/dev/null || echo "No backup repo found at ${repo} or restic not configured"`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=backupStatus.js.map

package/dist/tools/backupStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupStatus.js","sourceRoot":"","sources":["../../src/tools/backupStatus.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,oCAAoC,CAAC;CAClD,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,oDAAoD,EACpD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,oBAAoB,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,uBAAuB,IAAI,CAAC,KAAK,iDAAiD,IAAI,4BAA4B,CACzI,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/composeDown.d.ts

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

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

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

package/dist/tools/composeDown.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const COMPOSE_DIR = process.env.HOMELAB_COMPOSE_DIR || "/opt/homelab/docker";
+const inputSchema = {
+    stacks: z
+        .array(z.string())
+        .optional()
+        .describe("Specific compose files to stop. Omit for all."),
+    removeVolumes: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Also remove named volumes declared in compose file"),
+};
+export function register(server) {
+    server.tool("homelab_composeDown", "Stop Docker Compose stacks on the Pi", inputSchema, async (args) => {
+        try {
+            let files = "-f compose.base.yml";
+            if (args.stacks && args.stacks.length > 0) {
+                files += " " + args.stacks.map((s) => `-f ${s}`).join(" ");
+            }
+            else {
+                files += " -f compose.monitoring.yml -f compose.network.yml -f compose.apps.yml -f compose.security.yml -f compose.storage.yml -f compose.tools.yml";
+            }
+            const volFlag = args.removeVolumes ? " -v" : "";
+            const output = await execSSH(`cd ${COMPOSE_DIR} && docker compose ${files} down${volFlag} 2>&1`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=composeDown.js.map

package/dist/tools/composeDown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeDown.js","sourceRoot":"","sources":["../../src/tools/composeDown.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,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,qBAAqB,CAAC;AAE7E,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,sCAAsC,EACtC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,KAAK,GAAG,qBAAqB,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,2IAA2I,CAAC;YACvJ,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,MAAM,WAAW,sBAAsB,KAAK,QAAQ,OAAO,OAAO,CACnE,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/composePs.d.ts

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

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

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

package/dist/tools/composePs.js

@@ -0,0 +1,19 @@
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const COMPOSE_DIR = process.env.HOMELAB_COMPOSE_DIR || "/opt/homelab/docker";
+export function register(server) {
+    server.tool("homelab_composePs", "List running Docker Compose containers on the Pi", {}, async () => {
+        try {
+            const output = await execSSH(`cd ${COMPOSE_DIR} && docker compose -f compose.base.yml -f compose.monitoring.yml -f compose.network.yml -f compose.apps.yml -f compose.security.yml -f compose.storage.yml -f compose.tools.yml ps --format "table {{.Name}}\\t{{.Status}}\\t{{.Ports}}" 2>&1`);
+            return {
+                content: [{
+                        type: "text",
+                        text: output || "No compose containers running.",
+                    }],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=composePs.js.map

package/dist/tools/composePs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composePs.js","sourceRoot":"","sources":["../../src/tools/composePs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,qBAAqB,CAAC;AAE7E,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,kDAAkD,EAClD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,MAAM,WAAW,+OAA+O,CACjQ,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,IAAI,gCAAgC;qBACjD,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/composePull.d.ts

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

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

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

package/dist/tools/composePull.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const COMPOSE_DIR = process.env.HOMELAB_COMPOSE_DIR || "/opt/homelab/docker";
+const inputSchema = {
+    stacks: z
+        .array(z.string())
+        .optional()
+        .describe("Specific compose files to pull images for. Omit for all."),
+};
+export function register(server) {
+    server.tool("homelab_composePull", "Pull latest Docker images for compose stacks on the Pi", inputSchema, async (args) => {
+        try {
+            let files = "-f compose.base.yml";
+            if (args.stacks && args.stacks.length > 0) {
+                files += " " + args.stacks.map((s) => `-f ${s}`).join(" ");
+            }
+            else {
+                files += " -f compose.monitoring.yml -f compose.network.yml -f compose.apps.yml -f compose.security.yml -f compose.storage.yml -f compose.tools.yml";
+            }
+            const output = await execSSH(`cd ${COMPOSE_DIR} && docker compose ${files} pull 2>&1`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=composePull.js.map

package/dist/tools/composePull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composePull.js","sourceRoot":"","sources":["../../src/tools/composePull.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,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,qBAAqB,CAAC;AAE7E,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,wDAAwD,EACxD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,KAAK,GAAG,qBAAqB,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,2IAA2I,CAAC;YACvJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,MAAM,WAAW,sBAAsB,KAAK,YAAY,CACzD,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/composeUp.d.ts

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

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

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

package/dist/tools/composeUp.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const COMPOSE_DIR = process.env.HOMELAB_COMPOSE_DIR || "/opt/homelab/docker";
+const inputSchema = {
+    stacks: z
+        .array(z.string())
+        .optional()
+        .describe("Specific compose files to start (e.g. ['compose.monitoring.yml']). Omit for all."),
+};
+export function register(server) {
+    server.tool("homelab_composeUp", "Start Docker Compose stacks on the Pi", inputSchema, async (args) => {
+        try {
+            let files = "-f compose.base.yml";
+            if (args.stacks && args.stacks.length > 0) {
+                files += " " + args.stacks.map((s) => `-f ${s}`).join(" ");
+            }
+            else {
+                files += " -f compose.monitoring.yml -f compose.network.yml -f compose.apps.yml -f compose.security.yml -f compose.storage.yml -f compose.tools.yml";
+            }
+            const output = await execSSH(`cd ${COMPOSE_DIR} && docker compose ${files} up -d --remove-orphans 2>&1`);
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=composeUp.js.map

package/dist/tools/composeUp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeUp.js","sourceRoot":"","sources":["../../src/tools/composeUp.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,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,qBAAqB,CAAC;AAE7E,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;CAChG,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,uCAAuC,EACvC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,KAAK,GAAG,qBAAqB,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,2IAA2I,CAAC;YACvJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,MAAM,WAAW,sBAAsB,KAAK,8BAA8B,CAC3E,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/diskUsage.d.ts

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

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

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

package/dist/tools/diskUsage.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    path: z
+        .string()
+        .optional()
+        .default("/")
+        .describe("Path to check disk usage for (default: /)"),
+    depth: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(1)
+        .describe("Directory depth for breakdown (default: 1)"),
+};
+export function register(server) {
+    server.tool("homelab_diskUsage", "Get detailed disk usage breakdown on the Pi", inputSchema, async (args) => {
+        try {
+            const output = await execSSH([
+                'echo "=== Filesystem ==="',
+                "df -h",
+                'echo ""',
+                `echo "=== Directory Usage (${args.path}, depth ${args.depth}) ==="`,
+                `sudo du -h --max-depth=${args.depth} ${args.path} 2>/dev/null | sort -rh | head -20`,
+                'echo ""',
+                'echo "=== Docker Disk Usage ==="',
+                "docker system df 2>/dev/null || echo 'Docker not available'",
+            ].join(" && "));
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=diskUsage.js.map

package/dist/tools/diskUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diskUsage.js","sourceRoot":"","sources":["../../src/tools/diskUsage.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,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,2CAA2C,CAAC;IACxD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,6CAA6C,EAC7C,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;gBAC3B,2BAA2B;gBAC3B,OAAO;gBACP,SAAS;gBACT,8BAA8B,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,KAAK,QAAQ;gBACpE,0BAA0B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,oCAAoC;gBACrF,SAAS;gBACT,kCAAkC;gBAClC,6DAA6D;aAC9D,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAEhB,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/networkInfo.d.ts

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

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

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

package/dist/tools/networkInfo.js

@@ -0,0 +1,25 @@
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+export function register(server) {
+    server.tool("homelab_networkInfo", "Get network info from the Pi: IP addresses, interfaces, DNS, and Tailscale status", {}, async () => {
+        try {
+            const output = await execSSH([
+                'echo "=== IP Addresses ==="',
+                "ip -4 addr show | grep inet | awk '{print $NF, $2}'",
+                'echo ""',
+                'echo "=== Default Gateway ==="',
+                "ip route | grep default",
+                'echo ""',
+                'echo "=== DNS ==="',
+                "cat /etc/resolv.conf | grep nameserver",
+                'echo ""',
+                'echo "=== Tailscale ==="',
+                "tailscale status 2>/dev/null || echo 'Tailscale not installed or not running'",
+            ].join(" && "));
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=networkInfo.js.map

package/dist/tools/networkInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkInfo.js","sourceRoot":"","sources":["../../src/tools/networkInfo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,mFAAmF,EACnF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;gBAC3B,6BAA6B;gBAC7B,qDAAqD;gBACrD,SAAS;gBACT,gCAAgC;gBAChC,yBAAyB;gBACzB,SAAS;gBACT,oBAAoB;gBACpB,wCAAwC;gBACxC,SAAS;gBACT,0BAA0B;gBAC1B,+EAA+E;aAChF,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAEhB,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/piReboot.d.ts

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

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

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

package/dist/tools/piReboot.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    confirm: z
+        .boolean()
+        .describe("Must be true to proceed with reboot. Safety check to prevent accidental reboots."),
+};
+export function register(server) {
+    server.tool("homelab_piReboot", "Safely reboot the Raspberry Pi. Checks for running containers before rebooting.", inputSchema, async (args) => {
+        try {
+            if (!args.confirm) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "Reboot cancelled. Set confirm=true to proceed.",
+                        }],
+                };
+            }
+            const containers = await execSSH("docker ps --format '{{.Names}}' 2>/dev/null | wc -l");
+            const count = parseInt(containers, 10) || 0;
+            let preCheck = "";
+            if (count > 0) {
+                preCheck = `Warning: ${count} running container(s) will be stopped.\n`;
+            }
+            const uptime = await execSSH("uptime -p");
+            preCheck += `Current uptime: ${uptime}\n`;
+            preCheck += "Initiating reboot...\n";
+            await execSSH("sudo shutdown -r +0");
+            return {
+                content: [{ type: "text", text: preCheck + "Reboot command sent." }],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=piReboot.js.map

package/dist/tools/piReboot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piReboot.js","sourceRoot":"","sources":["../../src/tools/piReboot.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,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,CAAC,kFAAkF,CAAC;CAChG,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,iFAAiF,EACjF,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,gDAAgD;yBACvD,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,qDAAqD,CAAC,CAAC;YACxF,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YAE5C,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,QAAQ,GAAG,YAAY,KAAK,0CAA0C,CAAC;YACzE,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;YAC1C,QAAQ,IAAI,mBAAmB,MAAM,IAAI,CAAC;YAC1C,QAAQ,IAAI,wBAAwB,CAAC;YAErC,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;YAErC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAAC;aAC9E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/piStatus.d.ts

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

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

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

package/dist/tools/piStatus.js

@@ -0,0 +1,28 @@
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+export function register(server) {
+    server.tool("homelab_piStatus", "Get Raspberry Pi system status: CPU temp, memory, disk, uptime, and throttle state", {}, async () => {
+        try {
+            const output = await execSSH([
+                'echo "=== Uptime ==="',
+                "uptime",
+                'echo ""',
+                'echo "=== CPU Temperature ==="',
+                "cat /sys/class/thermal/thermal_zone0/temp | awk '{printf \"%.1f C\\n\", $1/1000}'",
+                'echo ""',
+                'echo "=== Memory ==="',
+                "free -h | head -2",
+                'echo ""',
+                'echo "=== Disk ==="',
+                "df -h / | tail -1",
+                'echo ""',
+                'echo "=== Throttle Status ==="',
+                "vcgencmd get_throttled 2>/dev/null || echo 'N/A'",
+            ].join(" && "));
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=piStatus.js.map

package/dist/tools/piStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piStatus.js","sourceRoot":"","sources":["../../src/tools/piStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,oFAAoF,EACpF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;gBAC3B,uBAAuB;gBACvB,QAAQ;gBACR,SAAS;gBACT,gCAAgC;gBAChC,mFAAmF;gBACnF,SAAS;gBACT,uBAAuB;gBACvB,mBAAmB;gBACnB,SAAS;gBACT,qBAAqB;gBACrB,mBAAmB;gBACnB,SAAS;gBACT,gCAAgC;gBAChC,kDAAkD;aACnD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAEhB,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/serviceHealth.d.ts

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

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

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

package/dist/tools/serviceHealth.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    service: z
+        .string()
+        .optional()
+        .describe("Specific container name to check, or omit for all"),
+};
+export function register(server) {
+    server.tool("homelab_serviceHealth", "Check Docker container health status on the Pi", inputSchema, async (args) => {
+        try {
+            const filter = args.service ? `--filter "name=${args.service}"` : "";
+            const ps = await execSSH(`docker ps ${filter} --format "table {{.Names}}\\t{{.Status}}\\t{{.Ports}}"`);
+            const unhealthy = await execSSH(`docker ps ${filter} --filter "health=unhealthy" --format "{{.Names}}"`);
+            let text = ps || "No containers found.";
+            if (unhealthy) {
+                text += `\n\nUnhealthy containers: ${unhealthy}`;
+            }
+            else {
+                text += "\n\nAll containers healthy.";
+            }
+            return { content: [{ type: "text", text }] };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=serviceHealth.js.map

package/dist/tools/serviceHealth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceHealth.js","sourceRoot":"","sources":["../../src/tools/serviceHealth.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,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;CACjE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,gDAAgD,EAChD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,EAAE,GAAG,MAAM,OAAO,CACtB,aAAa,MAAM,yDAAyD,CAC7E,CAAC;YAEF,MAAM,SAAS,GAAG,MAAM,OAAO,CAC7B,aAAa,MAAM,oDAAoD,CACxE,CAAC;YAEF,IAAI,IAAI,GAAG,EAAE,IAAI,sBAAsB,CAAC;YACxC,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,IAAI,6BAA6B,SAAS,EAAE,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,IAAI,IAAI,6BAA6B,CAAC;YACxC,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/serviceLogs.d.ts

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

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

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

package/dist/tools/serviceLogs.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    service: z.string().min(1).describe("Container name to get logs from"),
+    lines: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(50)
+        .describe("Number of recent log lines to return"),
+};
+export function register(server) {
+    server.tool("homelab_serviceLogs", "Tail recent logs from a Docker container on the Pi", inputSchema, async (args) => {
+        try {
+            const output = await execSSH(`docker logs --tail ${args.lines} ${args.service} 2>&1`);
+            return {
+                content: [{
+                        type: "text",
+                        text: output || `No logs found for ${args.service}.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=serviceLogs.js.map

package/dist/tools/serviceLogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceLogs.js","sourceRoot":"","sources":["../../src/tools/serviceLogs.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,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACtE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,oDAAoD,EACpD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,sBAAsB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,OAAO,CACxD,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,IAAI,qBAAqB,IAAI,CAAC,OAAO,GAAG;qBACrD,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/serviceRestart.d.ts

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

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

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

package/dist/tools/serviceRestart.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+const inputSchema = {
+    service: z.string().min(1).describe("Container name to restart"),
+};
+export function register(server) {
+    server.tool("homelab_serviceRestart", "Restart a Docker container on the Pi", inputSchema, async (args) => {
+        try {
+            await execSSH(`docker restart ${args.service}`);
+            const status = await execSSH(`docker ps --filter "name=${args.service}" --format "{{.Names}}\\t{{.Status}}"`);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Restarted ${args.service}.\n${status}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=serviceRestart.js.map

package/dist/tools/serviceRestart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceRestart.js","sourceRoot":"","sources":["../../src/tools/serviceRestart.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,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CACjE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,sCAAsC,EACtC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,kBAAkB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,4BAA4B,IAAI,CAAC,OAAO,uCAAuC,CAChF,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,aAAa,IAAI,CAAC,OAAO,MAAM,MAAM,EAAE;qBAC9C,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/sshTest.d.ts

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

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

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

package/dist/tools/sshTest.js

@@ -0,0 +1,25 @@
+import { execSSH, errorResponse } from "../utils/ssh-api.js";
+export function register(server) {
+    server.tool("homelab_sshTest", "Test SSH connectivity to the Raspberry Pi", {}, async () => {
+        try {
+            const host = process.env.HOMELAB_PI_HOST || "raspi5.local";
+            const user = process.env.HOMELAB_PI_USER || "tmhs";
+            const output = await execSSH("echo ok && hostname && uptime -p");
+            const lines = output.split("\n");
+            return {
+                content: [{
+                        type: "text",
+                        text: [
+                            `SSH connection to ${user}@${host}: OK`,
+                            `Hostname: ${lines[1] || "unknown"}`,
+                            `Uptime: ${lines[2] || "unknown"}`,
+                        ].join("\n"),
+                    }],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=sshTest.js.map

package/dist/tools/sshTest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sshTest.js","sourceRoot":"","sources":["../../src/tools/sshTest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,2CAA2C,EAC3C,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,cAAc,CAAC;YAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC;YAEnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kCAAkC,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEjC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;4BACJ,qBAAqB,IAAI,IAAI,IAAI,MAAM;4BACvC,aAAa,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE;4BACpC,WAAW,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE;yBACnC,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,18 @@
+export declare class SSHError extends Error {
+    readonly command?: string;
+    constructor(message: string, command?: string);
+}
+export declare class SSHConnectionError extends SSHError {
+    constructor(host: string);
+}
+export declare class SSHAuthError extends SSHError {
+    constructor();
+}
+export declare class SSHTimeoutError extends SSHError {
+    constructor(timeoutMs: number);
+}
+export declare class CommandFailedError extends SSHError {
+    readonly exitCode: number;
+    constructor(command: string, exitCode: number, stderr: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAK9C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,YAAa,SAAQ,QAAQ;;CAOzC;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK9D"}

package/dist/utils/errors.js

@@ -0,0 +1,35 @@
+export class SSHError extends Error {
+    command;
+    constructor(message, command) {
+        super(message);
+        this.name = "SSHError";
+        this.command = command;
+    }
+}
+export class SSHConnectionError extends SSHError {
+    constructor(host) {
+        super(`Cannot connect to ${host}. Verify the host is reachable and SSH is running.`);
+        this.name = "SSHConnectionError";
+    }
+}
+export class SSHAuthError extends SSHError {
+    constructor() {
+        super("SSH authentication failed. Check your key path (HOMELAB_PI_KEY_PATH) and username (HOMELAB_PI_USER).");
+        this.name = "SSHAuthError";
+    }
+}
+export class SSHTimeoutError extends SSHError {
+    constructor(timeoutMs) {
+        super(`SSH connection timed out after ${timeoutMs}ms.`);
+        this.name = "SSHTimeoutError";
+    }
+}
+export class CommandFailedError extends SSHError {
+    exitCode;
+    constructor(command, exitCode, stderr) {
+        super(stderr.trim() || `Command exited with code ${exitCode}`, command);
+        this.name = "CommandFailedError";
+        this.exitCode = exitCode;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,OAAO,CAAU;IAEjC,YAAY,OAAe,EAAE,OAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,IAAY;QACtB,KAAK,CAAC,qBAAqB,IAAI,oDAAoD,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC;QACE,KAAK,CACH,sGAAsG,CACvG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,SAAiB;QAC3B,KAAK,CAAC,kCAAkC,SAAS,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9B,QAAQ,CAAS;IAEjC,YAAY,OAAe,EAAE,QAAgB,EAAE,MAAc;QAC3D,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,4BAA4B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/utils/ssh-api.d.ts

@@ -0,0 +1,10 @@
+export declare function execSSH(command: string): Promise<string>;
+export declare function checkSSHAvailable(): Promise<void>;
+export declare function errorResponse(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+//# sourceMappingURL=ssh-api.d.ts.map

package/dist/utils/ssh-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-api.d.ts","sourceRoot":"","sources":["../../src/utils/ssh-api.ts"],"names":[],"mappings":"AAqBA,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyE9D;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAC7C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,EAAE,IAAI,CAAC;CACf,CA4BA"}

package/dist/utils/ssh-api.js

@@ -0,0 +1,130 @@
+import { readFileSync } from "node:fs";
+import { Client } from "ssh2";
+import { SSHError, SSHConnectionError, SSHAuthError, SSHTimeoutError, CommandFailedError, } from "./errors.js";
+const CONNECT_TIMEOUT_MS = 10_000;
+const EXEC_TIMEOUT_MS = 30_000;
+function getConfig() {
+    const host = process.env.HOMELAB_PI_HOST || "raspi5.local";
+    const username = process.env.HOMELAB_PI_USER || "tmhs";
+    const keyPath = process.env.HOMELAB_PI_KEY_PATH || "";
+    return { host, username, keyPath };
+}
+export async function execSSH(command) {
+    const { host, username, keyPath } = getConfig();
+    return new Promise((resolve, reject) => {
+        const conn = new Client();
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            conn.end();
+            reject(new SSHTimeoutError(EXEC_TIMEOUT_MS));
+        }, EXEC_TIMEOUT_MS);
+        conn
+            .on("ready", () => {
+            conn.exec(command, (err, stream) => {
+                if (err) {
+                    clearTimeout(timer);
+                    conn.end();
+                    return reject(new SSHError(err.message, command));
+                }
+                stream
+                    .on("close", (code) => {
+                    clearTimeout(timer);
+                    conn.end();
+                    if (timedOut)
+                        return;
+                    if (code !== 0 && code !== null) {
+                        reject(new CommandFailedError(command, code, stderr));
+                    }
+                    else {
+                        resolve(stdout.trim());
+                    }
+                })
+                    .on("data", (data) => {
+                    stdout += data.toString();
+                })
+                    .stderr.on("data", (data) => {
+                    stderr += data.toString();
+                });
+            });
+        })
+            .on("error", (err) => {
+            clearTimeout(timer);
+            if (timedOut)
+                return;
+            if (err.message.includes("authentication") ||
+                err.message.includes("All configured authentication methods failed")) {
+                reject(new SSHAuthError());
+            }
+            else if (err.message.includes("ECONNREFUSED") ||
+                err.message.includes("ENOTFOUND") ||
+                err.message.includes("ETIMEDOUT") ||
+                err.level === "client-timeout") {
+                reject(new SSHConnectionError(host));
+            }
+            else {
+                reject(new SSHError(err.message));
+            }
+        })
+            .connect({
+            host,
+            port: 22,
+            username,
+            privateKey: keyPath ? readFileSync(keyPath) : undefined,
+            agent: process.env.SSH_AUTH_SOCK,
+            readyTimeout: CONNECT_TIMEOUT_MS,
+        });
+    });
+}
+export async function checkSSHAvailable() {
+    try {
+        await execSSH("echo ok");
+    }
+    catch (error) {
+        throw error;
+    }
+}
+export function errorResponse(error) {
+    if (error instanceof SSHError) {
+        const parts = [`[${error.name}] ${error.message}`];
+        if (error.command) {
+            parts.push(`Command: ${error.command}`);
+        }
+        const suggestion = getErrorSuggestion(error);
+        if (suggestion) {
+            parts.push(`Suggestion: ${suggestion}`);
+        }
+        return {
+            content: [{ type: "text", text: parts.join("\n") }],
+            isError: true,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            content: [{ type: "text", text: error.message }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: "An unknown error occurred." }],
+        isError: true,
+    };
+}
+function getErrorSuggestion(error) {
+    if (error instanceof SSHConnectionError) {
+        return "Check that the Pi is powered on and reachable. Verify HOMELAB_PI_HOST is correct.";
+    }
+    if (error instanceof SSHAuthError) {
+        return "Verify HOMELAB_PI_KEY_PATH points to a valid private key and HOMELAB_PI_USER is correct.";
+    }
+    if (error instanceof SSHTimeoutError) {
+        return "The Pi may be under heavy load or unreachable. Try again or check network connectivity.";
+    }
+    if (error instanceof CommandFailedError) {
+        return "The command failed on the Pi. Check the error output above for details.";
+    }
+    return null;
+}
+//# sourceMappingURL=ssh-api.js.map

package/dist/utils/ssh-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-api.js","sourceRoot":"","sources":["../../src/utils/ssh-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,cAAc,CAAC;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAEtD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe;IAC3C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;IAEhD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;QAC/C,CAAC,EAAE,eAAe,CAAC,CAAC;QAEpB,IAAI;aACD,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;gBACjC,IAAI,GAAG,EAAE,CAAC;oBACR,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,CAAC,GAAG,EAAE,CAAC;oBACX,OAAO,MAAM,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBACpD,CAAC;gBAED,MAAM;qBACH,EAAE,CAAC,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE;oBAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,CAAC,GAAG,EAAE,CAAC;oBACX,IAAI,QAAQ;wBAAE,OAAO;oBAErB,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBAChC,MAAM,CAAC,IAAI,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;oBACxD,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC,CAAC;qBACD,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;oBAC3B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC5B,CAAC,CAAC;qBACD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;oBAClC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC5B,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;aACD,EAAE,CAAC,OAAO,EAAE,CAAC,GAA+B,EAAE,EAAE;YAC/C,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,QAAQ;gBAAE,OAAO;YAErB,IACE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBACtC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,8CAA8C,CAAC,EACpE,CAAC;gBACD,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;YAC7B,CAAC;iBAAM,IACL,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBACpC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACjC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACjC,GAAG,CAAC,KAAK,KAAK,gBAAgB,EAC9B,CAAC;gBACD,MAAM,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC,CAAC;aACD,OAAO,CAAC;YACP,IAAI;YACJ,IAAI,EAAE,EAAE;YACR,QAAQ;YACR,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YACvD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;YAChC,YAAY,EAAE,kBAAkB;SACjC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAI1C,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAa,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAE7D,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YACzD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC;QACxE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAe;IACzC,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,mFAAmF,CAAC;IAC7F,CAAC;IACD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,0FAA0F,CAAC;IACpG,CAAC;IACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,yFAAyF,CAAC;IACnG,CAAC;IACD,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,yEAAyE,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +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"
+}