@tmhs/homelab-mcp 0.15.3 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/README.md +9 -4
  2. package/dist/index.js +1 -1
  3. package/dist/tools/adguardFilters.d.ts.map +1 -1
  4. package/dist/tools/adguardFilters.js +7 -26
  5. package/dist/tools/adguardFilters.js.map +1 -1
  6. package/dist/tools/adguardQueryLog.d.ts.map +1 -1
  7. package/dist/tools/adguardQueryLog.js +8 -26
  8. package/dist/tools/adguardQueryLog.js.map +1 -1
  9. package/dist/tools/adguardStats.d.ts.map +1 -1
  10. package/dist/tools/adguardStats.js +7 -26
  11. package/dist/tools/adguardStats.js.map +1 -1
  12. package/dist/tools/alertList.d.ts +5 -0
  13. package/dist/tools/alertList.d.ts.map +1 -1
  14. package/dist/tools/alertList.js +16 -17
  15. package/dist/tools/alertList.js.map +1 -1
  16. package/dist/tools/aptHistory.d.ts +6 -0
  17. package/dist/tools/aptHistory.d.ts.map +1 -1
  18. package/dist/tools/aptHistory.js +14 -4
  19. package/dist/tools/aptHistory.js.map +1 -1
  20. package/dist/tools/aptUpdate.d.ts.map +1 -1
  21. package/dist/tools/aptUpdate.js +20 -5
  22. package/dist/tools/aptUpdate.js.map +1 -1
  23. package/dist/tools/backupDiff.d.ts.map +1 -1
  24. package/dist/tools/backupDiff.js +2 -1
  25. package/dist/tools/backupDiff.js.map +1 -1
  26. package/dist/tools/backupList.d.ts.map +1 -1
  27. package/dist/tools/backupList.js +7 -4
  28. package/dist/tools/backupList.js.map +1 -1
  29. package/dist/tools/backupRestore.d.ts.map +1 -1
  30. package/dist/tools/backupRestore.js +4 -3
  31. package/dist/tools/backupRestore.js.map +1 -1
  32. package/dist/tools/backupRun.d.ts.map +1 -1
  33. package/dist/tools/backupRun.js +10 -2
  34. package/dist/tools/backupRun.js.map +1 -1
  35. package/dist/tools/backupStatus.d.ts.map +1 -1
  36. package/dist/tools/backupStatus.js +8 -4
  37. package/dist/tools/backupStatus.js.map +1 -1
  38. package/dist/tools/certList.d.ts.map +1 -1
  39. package/dist/tools/certList.js +25 -18
  40. package/dist/tools/certList.js.map +1 -1
  41. package/dist/tools/certRenew.js +2 -2
  42. package/dist/tools/certRenew.js.map +1 -1
  43. package/dist/tools/composeDown.d.ts.map +1 -1
  44. package/dist/tools/composeDown.js +3 -10
  45. package/dist/tools/composeDown.js.map +1 -1
  46. package/dist/tools/composePs.d.ts.map +1 -1
  47. package/dist/tools/composePs.js +2 -2
  48. package/dist/tools/composePs.js.map +1 -1
  49. package/dist/tools/composePull.d.ts.map +1 -1
  50. package/dist/tools/composePull.js +3 -10
  51. package/dist/tools/composePull.js.map +1 -1
  52. package/dist/tools/composeUp.d.ts.map +1 -1
  53. package/dist/tools/composeUp.js +5 -11
  54. package/dist/tools/composeUp.js.map +1 -1
  55. package/dist/tools/containerScan.d.ts.map +1 -1
  56. package/dist/tools/containerScan.js +14 -6
  57. package/dist/tools/containerScan.js.map +1 -1
  58. package/dist/tools/diagnostics.d.ts +5 -0
  59. package/dist/tools/diagnostics.d.ts.map +1 -1
  60. package/dist/tools/diagnostics.js +26 -19
  61. package/dist/tools/diagnostics.js.map +1 -1
  62. package/dist/tools/diskUsage.d.ts.map +1 -1
  63. package/dist/tools/diskUsage.js +4 -3
  64. package/dist/tools/diskUsage.js.map +1 -1
  65. package/dist/tools/grafanaSnapshot.d.ts.map +1 -1
  66. package/dist/tools/grafanaSnapshot.js +11 -34
  67. package/dist/tools/grafanaSnapshot.js.map +1 -1
  68. package/dist/tools/healthCheck.d.ts +8 -0
  69. package/dist/tools/healthCheck.d.ts.map +1 -1
  70. package/dist/tools/healthCheck.js +56 -21
  71. package/dist/tools/healthCheck.js.map +1 -1
  72. package/dist/tools/journalLogs.d.ts.map +1 -1
  73. package/dist/tools/journalLogs.js +1 -0
  74. package/dist/tools/journalLogs.js.map +1 -1
  75. package/dist/tools/logSearch.d.ts.map +1 -1
  76. package/dist/tools/logSearch.js +20 -6
  77. package/dist/tools/logSearch.js.map +1 -1
  78. package/dist/tools/nodeList.d.ts.map +1 -1
  79. package/dist/tools/nodeList.js +22 -11
  80. package/dist/tools/nodeList.js.map +1 -1
  81. package/dist/tools/npmCerts.d.ts.map +1 -1
  82. package/dist/tools/npmCerts.js +6 -38
  83. package/dist/tools/npmCerts.js.map +1 -1
  84. package/dist/tools/npmProxyHosts.d.ts.map +1 -1
  85. package/dist/tools/npmProxyHosts.js +6 -38
  86. package/dist/tools/npmProxyHosts.js.map +1 -1
  87. package/dist/tools/ntfySend.d.ts.map +1 -1
  88. package/dist/tools/ntfySend.js +6 -16
  89. package/dist/tools/ntfySend.js.map +1 -1
  90. package/dist/tools/ntfyTopics.d.ts +4 -0
  91. package/dist/tools/ntfyTopics.d.ts.map +1 -1
  92. package/dist/tools/ntfyTopics.js +26 -17
  93. package/dist/tools/ntfyTopics.js.map +1 -1
  94. package/dist/tools/prometheusQuery.d.ts.map +1 -1
  95. package/dist/tools/prometheusQuery.js +8 -16
  96. package/dist/tools/prometheusQuery.js.map +1 -1
  97. package/dist/tools/serviceLogs.d.ts.map +1 -1
  98. package/dist/tools/serviceLogs.js +5 -1
  99. package/dist/tools/serviceLogs.js.map +1 -1
  100. package/dist/tools/speedtestResults.d.ts.map +1 -1
  101. package/dist/tools/speedtestResults.js +7 -16
  102. package/dist/tools/speedtestResults.js.map +1 -1
  103. package/dist/tools/sshTest.js +4 -4
  104. package/dist/tools/sshTest.js.map +1 -1
  105. package/dist/tools/uptimeKumaStatus.d.ts +4 -0
  106. package/dist/tools/uptimeKumaStatus.d.ts.map +1 -1
  107. package/dist/tools/uptimeKumaStatus.js +30 -16
  108. package/dist/tools/uptimeKumaStatus.js.map +1 -1
  109. package/dist/tools/volumeBackup.d.ts.map +1 -1
  110. package/dist/tools/volumeBackup.js +4 -3
  111. package/dist/tools/volumeBackup.js.map +1 -1
  112. package/dist/utils/compose.d.ts +27 -0
  113. package/dist/utils/compose.d.ts.map +1 -0
  114. package/dist/utils/compose.js +92 -0
  115. package/dist/utils/compose.js.map +1 -0
  116. package/dist/utils/config.d.ts +4 -0
  117. package/dist/utils/config.d.ts.map +1 -0
  118. package/dist/utils/config.js +7 -0
  119. package/dist/utils/config.js.map +1 -0
  120. package/dist/utils/errors.d.ts +2 -2
  121. package/dist/utils/errors.d.ts.map +1 -1
  122. package/dist/utils/errors.js +8 -4
  123. package/dist/utils/errors.js.map +1 -1
  124. package/dist/utils/restic.d.ts +13 -0
  125. package/dist/utils/restic.d.ts.map +1 -0
  126. package/dist/utils/restic.js +21 -0
  127. package/dist/utils/restic.js.map +1 -0
  128. package/dist/utils/service-http.d.ts +82 -0
  129. package/dist/utils/service-http.d.ts.map +1 -0
  130. package/dist/utils/service-http.js +104 -0
  131. package/dist/utils/service-http.js.map +1 -0
  132. package/dist/utils/since-param.d.ts +13 -0
  133. package/dist/utils/since-param.d.ts.map +1 -0
  134. package/dist/utils/since-param.js +21 -0
  135. package/dist/utils/since-param.js.map +1 -0
  136. package/dist/utils/ssh-api.d.ts +54 -3
  137. package/dist/utils/ssh-api.d.ts.map +1 -1
  138. package/dist/utils/ssh-api.js +222 -33
  139. package/dist/utils/ssh-api.js.map +1 -1
  140. package/package.json +1 -1
package/README.md CHANGED
@@ -9,7 +9,7 @@ MCP (Model Context Protocol) server for home lab operations. Connects to a Raspb
9
9
  | System | `homelab_piStatus` | CPU temp, memory, disk, uptime, throttle state |
10
10
  | System | `homelab_piReboot` | Safe reboot with pre-checks |
11
11
  | System | `homelab_diskUsage` | Disk usage breakdown by directory |
12
- | System | `homelab_aptUpdate` | Run apt update, list upgradable packages |
12
+ | System | `homelab_aptUpdate` | Run apt update, list upgradable packages; optional upgrade (requires confirm=true) |
13
13
  | Containers | `homelab_serviceHealth` | Docker container health status |
14
14
  | Containers | `homelab_serviceLogs` | Tail container logs |
15
15
  | Containers | `homelab_serviceRestart` | Restart a container |
@@ -75,6 +75,7 @@ Set environment variables:
75
75
  | `HOMELAB_PI_USER` | `pi` | SSH username |
76
76
  | `HOMELAB_PI_KEY_PATH` | (empty) | Path to SSH private key (e.g. `~/.ssh/id_ed25519`) |
77
77
  | `HOMELAB_COMPOSE_DIR` | `/opt/homelab/docker` | Compose project directory on Pi |
78
+ | `HOMELAB_COMPOSE_FILES` | (discovered) | Comma-separated compose files (in order) used when no `stacks` are passed. If unset, `compose.base.yml` and every `compose.*.yml` in the compose dir are used, falling back to `compose.yaml` / `docker-compose.yml` |
78
79
  | `HOMELAB_BACKUP_REPO` | `/mnt/backup/restic` | Restic backup repo path on Pi |
79
80
  | `HOMELAB_GRAFANA_TOKEN` | (empty) | Grafana API token (preferred auth method) |
80
81
  | `HOMELAB_GRAFANA_USER` | `admin` | Grafana basic auth username |
@@ -86,15 +87,19 @@ Set environment variables:
86
87
  | `HOMELAB_SPEEDTEST_PORT` | `8765` | Speedtest Tracker port override |
87
88
  | `HOMELAB_ADGUARD_USER` | `admin` | AdGuard Home username |
88
89
  | `HOMELAB_ADGUARD_PASSWORD` | `admin` | AdGuard Home password |
89
- | `HOMELAB_ADGUARD_PORT` | `3000` | AdGuard Home port override |
90
+ | `HOMELAB_ADGUARD_PORT` | `3000` | AdGuard Home web UI port. AdGuard and Grafana both default to 3000; if both run on the same host, set this (or `HOMELAB_GRAFANA_PORT`) to the port each actually uses |
90
91
  | `HOMELAB_NPM_EMAIL` | `admin@example.com` | NPM admin email |
91
92
  | `HOMELAB_NPM_PASSWORD` | `changeme` | NPM admin password |
92
93
  | `HOMELAB_NPM_PORT` | `81` | NPM admin API port override |
93
94
  | `HOMELAB_NTFY_PORT` | `8080` | Ntfy server port override |
94
- | `HOMELAB_NODES` | (empty) | JSON object mapping node names to SSH config for multi-node support |
95
+ | `HOMELAB_NODES` | (empty) | JSON object mapping node names to SSH config (`host` required; `user`, `keyPath` optional) for multi-node support. An optional `env` object overrides `HOMELAB_*` settings for that node (for example `HOMELAB_COMPOSE_DIR`, `HOMELAB_BACKUP_REPO`, service ports and credentials). Invalid JSON or an entry without `host` is reported as an error |
95
96
  | `HOMELAB_ANSIBLE_INVENTORY` | `/etc/ansible/hosts` | Ansible inventory file path for node discovery |
96
- | `HOMELAB_DRY_RUN` | (unset) | When set to any truthy value, `execSSH` prints the command without connecting |
97
+ | `HOMELAB_DRY_RUN` | (unset) | When set to `true`, `1`, `yes`, or `on`, `execSSH` prints the command without connecting |
98
+ | `HOMELAB_MAX_OUTPUT_BYTES` | `1048576` | Max bytes of command output kept per call; longer output is truncated to the last N bytes with a marker |
97
99
  | `HOMELAB_ALLOW_DANGEROUS_COMMANDS` | (unset) | Set to `true` to bypass the runtime command safety guard |
100
+ | `HOMELAB_UPTIME_KUMA_SLUG` | `default` | Status page slug used by `homelab_uptimeKumaStatus` when no `slug` is passed |
101
+ | `HOMELAB_NTFY_TOPICS` | (unset) | Default topic list (comma-separated) for `homelab_ntfyTopics` when no `topic` is passed |
102
+ | `HOMELAB_SSH_TIMEOUT_MS` | `30000` | Default timeout (connect + command) for tools without their own budget. Long-running tools (apt upgrade, compose pull, restic backup/restore, image scans) use longer built-in timeouts |
98
103
 
99
104
  ## Usage with Cursor
100
105
 
package/dist/index.js CHANGED
@@ -53,7 +53,7 @@ import { register as registerHealthCheck } from "./tools/healthCheck.js";
53
53
  import { register as registerDiagnostics } from "./tools/diagnostics.js";
54
54
  const server = new McpServer({
55
55
  name: "homelab-mcp",
56
- version: "0.15.3",
56
+ version: "0.16.0",
57
57
  });
58
58
  registerPiStatus(server);
59
59
  registerPiReboot(server);
@@ -1 +1 @@
1
- {"version":3,"file":"adguardFilters.d.ts","sourceRoot":"","sources":["../../src/tools/adguardFilters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsChD"}
1
+ {"version":3,"file":"adguardFilters.d.ts","sourceRoot":"","sources":["../../src/tools/adguardFilters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqBhD"}
@@ -1,37 +1,18 @@
1
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
2
- import { CommandFailedError } from "../utils/errors.js";
1
+ import { execSSH } from "../utils/ssh-api.js";
3
2
  import { nodeParam } from "../utils/node-param.js";
4
- const DEFAULT_PORT = 3000;
5
- const SERVICE_NAME = "AdGuard Home";
6
- function getPort() {
7
- const override = process.env.HOMELAB_ADGUARD_PORT;
8
- return override ? parseInt(override, 10) : DEFAULT_PORT;
9
- }
10
- function buildAuth() {
11
- const user = process.env.HOMELAB_ADGUARD_USER || "admin";
12
- const password = process.env.HOMELAB_ADGUARD_PASSWORD || "admin";
13
- return `-u '${user}:${password}'`;
14
- }
3
+ import { SERVICES, servicePort, adguardAuth, curlErrorResponse } from "../utils/service-http.js";
4
+ const SERVICE = SERVICES.adguard;
15
5
  export function register(server) {
16
6
  server.tool("homelab_adguardFilters", "List AdGuard Home filter lists with name, URL, enabled status, and rule count", { ...nodeParam }, async (args) => {
17
- const port = getPort();
7
+ let port = SERVICE.defaultPort;
18
8
  try {
19
- const auth = buildAuth();
9
+ port = servicePort(SERVICE, args.node);
10
+ const auth = adguardAuth(args.node);
20
11
  const output = await execSSH(`curl -sf ${auth} 'http://localhost:${port}/control/filtering/status'`, args.node);
21
12
  return { content: [{ type: "text", text: output }] };
22
13
  }
23
14
  catch (error) {
24
- if (error instanceof CommandFailedError) {
25
- if (error.exitCode === 7) {
26
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
27
- `Set HOMELAB_ADGUARD_PORT if using a non-default port.`));
28
- }
29
- if (error.exitCode === 22) {
30
- return errorResponse(new Error(`${SERVICE_NAME} returned an HTTP error. Check authentication -- ` +
31
- `set HOMELAB_ADGUARD_USER and HOMELAB_ADGUARD_PASSWORD.`));
32
- }
33
- }
34
- return errorResponse(error);
15
+ return curlErrorResponse(error, SERVICE, port);
35
16
  }
36
17
  });
37
18
  }
@@ -1 +1 @@
1
- {"version":3,"file":"adguardFilters.js","sourceRoot":"","sources":["../../src/tools/adguardFilters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAClD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC;IACjE,OAAO,OAAO,IAAI,IAAI,QAAQ,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,+EAA+E,EAC/E,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,YAAY,IAAI,sBAAsB,IAAI,4BAA4B,EACtE,IAAI,CAAC,IAAI,CACV,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,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,wBAAwB,YAAY,YAAY,IAAI,mBAAmB;wBACrE,uDAAuD,CAC1D,CACF,CAAC;gBACJ,CAAC;gBACD,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;oBAC1B,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,GAAG,YAAY,mDAAmD;wBAChE,wDAAwD,CAC3D,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"adguardFilters.js","sourceRoot":"","sources":["../../src/tools/adguardFilters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEjG,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AAEjC,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,+EAA+E,EAC/E,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,YAAY,IAAI,sBAAsB,IAAI,4BAA4B,EACtE,IAAI,CAAC,IAAI,CACV,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,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"adguardQueryLog.d.ts","sourceRoot":"","sources":["../../src/tools/adguardQueryLog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2ChD"}
1
+ {"version":3,"file":"adguardQueryLog.d.ts","sourceRoot":"","sources":["../../src/tools/adguardQueryLog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhD"}
@@ -1,9 +1,8 @@
1
1
  import { z } from "zod";
2
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
3
- import { CommandFailedError } from "../utils/errors.js";
2
+ import { execSSH } from "../utils/ssh-api.js";
4
3
  import { nodeParam } from "../utils/node-param.js";
5
- const DEFAULT_PORT = 3000;
6
- const SERVICE_NAME = "AdGuard Home";
4
+ import { SERVICES, servicePort, adguardAuth, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.adguard;
7
6
  const inputSchema = {
8
7
  ...nodeParam,
9
8
  search: z
@@ -14,24 +13,17 @@ const inputSchema = {
14
13
  .number()
15
14
  .int()
16
15
  .positive()
16
+ .max(500)
17
17
  .optional()
18
18
  .default(25)
19
19
  .describe("Number of recent queries to return"),
20
20
  };
21
- function getPort() {
22
- const override = process.env.HOMELAB_ADGUARD_PORT;
23
- return override ? parseInt(override, 10) : DEFAULT_PORT;
24
- }
25
- function buildAuth() {
26
- const user = process.env.HOMELAB_ADGUARD_USER || "admin";
27
- const password = process.env.HOMELAB_ADGUARD_PASSWORD || "admin";
28
- return `-u '${user}:${password}'`;
29
- }
30
21
  export function register(server) {
31
22
  server.tool("homelab_adguardQueryLog", "Search the AdGuard Home DNS query log", inputSchema, async (args) => {
32
- const port = getPort();
23
+ let port = SERVICE.defaultPort;
33
24
  try {
34
- const auth = buildAuth();
25
+ port = servicePort(SERVICE, args.node);
26
+ const auth = adguardAuth(args.node);
35
27
  const params = [`limit=${args.count}`];
36
28
  if (args.search) {
37
29
  params.push(`search=${encodeURIComponent(args.search)}`);
@@ -41,17 +33,7 @@ export function register(server) {
41
33
  return { content: [{ type: "text", text: output }] };
42
34
  }
43
35
  catch (error) {
44
- if (error instanceof CommandFailedError) {
45
- if (error.exitCode === 7) {
46
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
47
- `Set HOMELAB_ADGUARD_PORT if using a non-default port.`));
48
- }
49
- if (error.exitCode === 22) {
50
- return errorResponse(new Error(`${SERVICE_NAME} returned an HTTP error. Check authentication -- ` +
51
- `set HOMELAB_ADGUARD_USER and HOMELAB_ADGUARD_PASSWORD.`));
52
- }
53
- }
54
- return errorResponse(error);
36
+ return curlErrorResponse(error, SERVICE, port);
55
37
  }
56
38
  });
57
39
  }
@@ -1 +1 @@
1
- {"version":3,"file":"adguardQueryLog.js","sourceRoot":"","sources":["../../src/tools/adguardQueryLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC;AAEF,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAClD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC;IACjE,OAAO,OAAO,IAAI,IAAI,QAAQ,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,uCAAuC,EACvC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAa,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACjD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,YAAY,IAAI,sBAAsB,IAAI,qBAAqB,KAAK,GAAG,EACvE,IAAI,CAAC,IAAI,CACV,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,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,wBAAwB,YAAY,YAAY,IAAI,mBAAmB;wBACrE,uDAAuD,CAC1D,CACF,CAAC;gBACJ,CAAC;gBACD,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;oBAC1B,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,GAAG,YAAY,mDAAmD;wBAChE,wDAAwD,CAC3D,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"adguardQueryLog.js","sourceRoot":"","sources":["../../src/tools/adguardQueryLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEjG,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AAEjC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,uCAAuC,EACvC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,MAAM,GAAa,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACjD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,YAAY,IAAI,sBAAsB,IAAI,qBAAqB,KAAK,GAAG,EACvE,IAAI,CAAC,IAAI,CACV,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,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"adguardStats.d.ts","sourceRoot":"","sources":["../../src/tools/adguardStats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsChD"}
1
+ {"version":3,"file":"adguardStats.d.ts","sourceRoot":"","sources":["../../src/tools/adguardStats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqBhD"}
@@ -1,37 +1,18 @@
1
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
2
- import { CommandFailedError } from "../utils/errors.js";
1
+ import { execSSH } from "../utils/ssh-api.js";
3
2
  import { nodeParam } from "../utils/node-param.js";
4
- const DEFAULT_PORT = 3000;
5
- const SERVICE_NAME = "AdGuard Home";
6
- function getPort() {
7
- const override = process.env.HOMELAB_ADGUARD_PORT;
8
- return override ? parseInt(override, 10) : DEFAULT_PORT;
9
- }
10
- function buildAuth() {
11
- const user = process.env.HOMELAB_ADGUARD_USER || "admin";
12
- const password = process.env.HOMELAB_ADGUARD_PASSWORD || "admin";
13
- return `-u '${user}:${password}'`;
14
- }
3
+ import { SERVICES, servicePort, adguardAuth, curlErrorResponse } from "../utils/service-http.js";
4
+ const SERVICE = SERVICES.adguard;
15
5
  export function register(server) {
16
6
  server.tool("homelab_adguardStats", "Get AdGuard Home DNS statistics including query counts, blocked domains, and top clients", { ...nodeParam }, async (args) => {
17
- const port = getPort();
7
+ let port = SERVICE.defaultPort;
18
8
  try {
19
- const auth = buildAuth();
9
+ port = servicePort(SERVICE, args.node);
10
+ const auth = adguardAuth(args.node);
20
11
  const output = await execSSH(`curl -sf ${auth} 'http://localhost:${port}/control/stats'`, args.node);
21
12
  return { content: [{ type: "text", text: output }] };
22
13
  }
23
14
  catch (error) {
24
- if (error instanceof CommandFailedError) {
25
- if (error.exitCode === 7) {
26
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
27
- `Set HOMELAB_ADGUARD_PORT if using a non-default port.`));
28
- }
29
- if (error.exitCode === 22) {
30
- return errorResponse(new Error(`${SERVICE_NAME} returned an HTTP error. Check authentication -- ` +
31
- `set HOMELAB_ADGUARD_USER and HOMELAB_ADGUARD_PASSWORD.`));
32
- }
33
- }
34
- return errorResponse(error);
15
+ return curlErrorResponse(error, SERVICE, port);
35
16
  }
36
17
  });
37
18
  }
@@ -1 +1 @@
1
- {"version":3,"file":"adguardStats.js","sourceRoot":"","sources":["../../src/tools/adguardStats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAClD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC;IACjE,OAAO,OAAO,IAAI,IAAI,QAAQ,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,0FAA0F,EAC1F,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,YAAY,IAAI,sBAAsB,IAAI,iBAAiB,EAC3D,IAAI,CAAC,IAAI,CACV,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,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,wBAAwB,YAAY,YAAY,IAAI,mBAAmB;wBACrE,uDAAuD,CAC1D,CACF,CAAC;gBACJ,CAAC;gBACD,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;oBAC1B,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,GAAG,YAAY,mDAAmD;wBAChE,wDAAwD,CAC3D,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"adguardStats.js","sourceRoot":"","sources":["../../src/tools/adguardStats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEjG,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AAEjC,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,0FAA0F,EAC1F,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,YAAY,IAAI,sBAAsB,IAAI,iBAAiB,EAC3D,IAAI,CAAC,IAAI,CACV,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,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1,3 +1,8 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /**
3
+ * Alertmanager v2 GET /api/v2/alerts has no `state` parameter (unknown
4
+ * params are ignored); filtering uses these boolean flags instead.
5
+ */
6
+ export declare const STATE_FILTERS: Record<"active" | "suppressed" | "unprocessed", string>;
2
7
  export declare function register(server: McpServer): void;
3
8
  //# sourceMappingURL=alertList.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"alertList.d.ts","sourceRoot":"","sources":["../../src/tools/alertList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8BhD"}
1
+ {"version":3,"file":"alertList.d.ts","sourceRoot":"","sources":["../../src/tools/alertList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,GAAG,YAAY,GAAG,aAAa,EAAE,MAAM,CAIjF,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqBhD"}
@@ -1,9 +1,8 @@
1
1
  import { z } from "zod";
2
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
3
- import { CommandFailedError } from "../utils/errors.js";
2
+ import { execSSH } from "../utils/ssh-api.js";
4
3
  import { nodeParam } from "../utils/node-param.js";
5
- const DEFAULT_PORT = 9093;
6
- const SERVICE_NAME = "Alertmanager";
4
+ import { SERVICES, servicePort, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.alertmanager;
7
6
  const inputSchema = {
8
7
  ...nodeParam,
9
8
  state: z
@@ -11,26 +10,26 @@ const inputSchema = {
11
10
  .optional()
12
11
  .describe("Filter alerts by state. Returns all states if omitted"),
13
12
  };
14
- function getPort() {
15
- const override = process.env.HOMELAB_ALERTMANAGER_PORT;
16
- return override ? parseInt(override, 10) : DEFAULT_PORT;
17
- }
13
+ /**
14
+ * Alertmanager v2 GET /api/v2/alerts has no `state` parameter (unknown
15
+ * params are ignored); filtering uses these boolean flags instead.
16
+ */
17
+ export const STATE_FILTERS = {
18
+ active: "active=true&silenced=false&inhibited=false&unprocessed=false",
19
+ suppressed: "active=false&silenced=true&inhibited=true&unprocessed=false",
20
+ unprocessed: "active=false&silenced=false&inhibited=false&unprocessed=true",
21
+ };
18
22
  export function register(server) {
19
23
  server.tool("homelab_alertList", "List alerts from Alertmanager, optionally filtered by state", inputSchema, async (args) => {
20
- const port = getPort();
24
+ let port = SERVICE.defaultPort;
21
25
  try {
22
- const stateParam = args.state ? `?state=${args.state}` : "";
26
+ port = servicePort(SERVICE, args.node);
27
+ const stateParam = args.state ? `?${STATE_FILTERS[args.state]}` : "";
23
28
  const output = await execSSH(`curl -sf 'http://localhost:${port}/api/v2/alerts${stateParam}'`, args.node);
24
29
  return { content: [{ type: "text", text: output }] };
25
30
  }
26
31
  catch (error) {
27
- if (error instanceof CommandFailedError) {
28
- if (error.exitCode === 7) {
29
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
30
- `Set HOMELAB_ALERTMANAGER_PORT if using a non-default port.`));
31
- }
32
- }
33
- return errorResponse(error);
32
+ return curlErrorResponse(error, SERVICE, port);
34
33
  }
35
34
  });
36
35
  }
@@ -1 +1 @@
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;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,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,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IACvD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,6DAA6D,EAC7D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,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,8BAA8B,IAAI,iBAAiB,UAAU,GAAG,EAChE,IAAI,CAAC,IAAI,CACV,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,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,wBAAwB,YAAY,YAAY,IAAI,mBAAmB;wBACrE,4DAA4D,CAC/D,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
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,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC;AAEtC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,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;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA4D;IACpF,MAAM,EAAE,8DAA8D;IACtE,UAAU,EAAE,6DAA6D;IACzE,WAAW,EAAE,8DAA8D;CAC5E,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,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,iBAAiB,UAAU,GAAG,EAChE,IAAI,CAAC,IAAI,CACV,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,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1,3 +1,9 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /**
3
+ * Emit history oldest-to-newest so `tail` keeps the most recent entries:
4
+ * rotated archives in reverse numeric order (history.log.12.gz ... .1.gz),
5
+ * then the current history.log last.
6
+ */
7
+ export declare function buildAptHistoryCommand(lines: number): string;
2
8
  export declare function register(server: McpServer): void;
3
9
  //# sourceMappingURL=aptHistory.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"aptHistory.d.ts","sourceRoot":"","sources":["../../src/tools/aptHistory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBhD"}
1
+ {"version":3,"file":"aptHistory.d.ts","sourceRoot":"","sources":["../../src/tools/aptHistory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBhD"}
@@ -7,17 +7,27 @@ const inputSchema = {
7
7
  .number()
8
8
  .int()
9
9
  .positive()
10
+ .max(5000)
10
11
  .optional()
11
12
  .default(50)
12
13
  .describe("Number of recent history entries to return"),
13
14
  };
15
+ const PATTERN = "'(Install|Upgrade|Remove|Commandline)'";
16
+ /**
17
+ * Emit history oldest-to-newest so `tail` keeps the most recent entries:
18
+ * rotated archives in reverse numeric order (history.log.12.gz ... .1.gz),
19
+ * then the current history.log last.
20
+ */
21
+ export function buildAptHistoryCommand(lines) {
22
+ return (`{ ls -1v /var/log/apt/history.log.*.gz 2>/dev/null | tac | ` +
23
+ `xargs -r zgrep -hE ${PATTERN} 2>/dev/null; ` +
24
+ `grep -hE ${PATTERN} /var/log/apt/history.log 2>/dev/null; } ` +
25
+ `| tail -n ${lines}`);
26
+ }
14
27
  export function register(server) {
15
28
  server.tool("homelab_aptHistory", "Show recent apt install, upgrade, and remove history", inputSchema, async (args) => {
16
29
  try {
17
- const cmd = `(grep -E '(Install|Upgrade|Remove|Commandline)' /var/log/apt/history.log 2>/dev/null; ` +
18
- `zgrep -E '(Install|Upgrade|Remove|Commandline)' /var/log/apt/history.log.*.gz 2>/dev/null) ` +
19
- `| tail -${args.lines}`;
20
- const output = await execSSH(cmd, args.node);
30
+ const output = await execSSH(buildAptHistoryCommand(args.lines), args.node);
21
31
  return {
22
32
  content: [{
23
33
  type: "text",
@@ -1 +1 @@
1
- {"version":3,"file":"aptHistory.js","sourceRoot":"","sources":["../../src/tools/aptHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,sDAAsD,EACtD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,GAAG,GACP,wFAAwF;gBACxF,6FAA6F;gBAC7F,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,IAAI,+BAA+B;qBAChD,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"}
1
+ {"version":3,"file":"aptHistory.js","sourceRoot":"","sources":["../../src/tools/aptHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC;AAEF,MAAM,OAAO,GAAG,wCAAwC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,CACL,6DAA6D;QAC7D,sBAAsB,OAAO,gBAAgB;QAC7C,YAAY,OAAO,2CAA2C;QAC9D,aAAa,KAAK,EAAE,CACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,sDAAsD,EACtD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,IAAI,+BAA+B;qBAChD,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"}
@@ -1 +1 @@
1
- {"version":3,"file":"aptUpdate.d.ts","sourceRoot":"","sources":["../../src/tools/aptUpdate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoBhD"}
1
+ {"version":3,"file":"aptUpdate.d.ts","sourceRoot":"","sources":["../../src/tools/aptUpdate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+BhD"}
@@ -1,22 +1,37 @@
1
1
  import { z } from "zod";
2
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
2
+ import { execSSH, errorResponse, TIMEOUTS } from "../utils/ssh-api.js";
3
3
  import { nodeParam } from "../utils/node-param.js";
4
+ import { confirmCancelled } from "../utils/confirm-param.js";
4
5
  const inputSchema = {
5
6
  ...nodeParam,
6
7
  upgrade: z
7
8
  .boolean()
8
9
  .optional()
9
10
  .default(false)
10
- .describe("Also run apt upgrade after update (default: false, just lists upgradable)"),
11
+ .describe("Also run apt upgrade after update (default: false, just lists upgradable). Requires confirm=true"),
12
+ confirm: z
13
+ .boolean()
14
+ .optional()
15
+ .describe("Safety gate. Must be true when upgrade is true; not needed to only list updates."),
11
16
  };
12
17
  export function register(server) {
13
- server.tool("homelab_aptUpdate", "Run apt update on the Pi and list upgradable packages", inputSchema, async (args) => {
18
+ server.tool("homelab_aptUpdate", "Run apt update on the Pi and list upgradable packages; optionally upgrade (requires confirm=true)", inputSchema, async (args) => {
19
+ if (args.upgrade && args.confirm !== true) {
20
+ // Upgrading changes system state (packages, services, possibly the
21
+ // kernel), so it uses the same confirm gate as other mutating tools.
22
+ return confirmCancelled("Package upgrade");
23
+ }
14
24
  try {
15
25
  let cmd = "sudo apt-get update -qq 2>&1 && apt list --upgradable 2>/dev/null";
16
26
  if (args.upgrade) {
17
- cmd += " && sudo apt-get upgrade -y 2>&1";
27
+ // Non-interactive so a conffile prompt cannot block on stdin.
28
+ cmd +=
29
+ " && sudo DEBIAN_FRONTEND=noninteractive apt-get upgrade -y" +
30
+ " -o Dpkg::Options::=--force-confdef -o Dpkg::Options::=--force-confold 2>&1";
18
31
  }
19
- const output = await execSSH(cmd, args.node);
32
+ const output = await execSSH(cmd, args.node, {
33
+ timeoutMs: args.upgrade ? TIMEOUTS.long : TIMEOUTS.medium,
34
+ });
20
35
  return { content: [{ type: "text", text: output }] };
21
36
  }
22
37
  catch (error) {
@@ -1 +1 @@
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;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,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,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAE7C,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"}
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,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,kGAAkG,CAAC;IAC/G,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;CAChG,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,mGAAmG,EACnG,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1C,mEAAmE;YACnE,qEAAqE;YACrE,OAAO,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC;YACH,IAAI,GAAG,GAAG,mEAAmE,CAAC;YAC9E,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,8DAA8D;gBAC9D,GAAG;oBACD,4DAA4D;wBAC5D,6EAA6E,CAAC;YAClF,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE;gBAC3C,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM;aAC1D,CAAC,CAAC;YAEH,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"}
@@ -1 +1 @@
1
- {"version":3,"file":"backupDiff.d.ts","sourceRoot":"","sources":["../../src/tools/backupDiff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBhD"}
1
+ {"version":3,"file":"backupDiff.d.ts","sourceRoot":"","sources":["../../src/tools/backupDiff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBhD"}
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
2
  import { execSSH, errorResponse } from "../utils/ssh-api.js";
3
3
  import { nodeParam } from "../utils/node-param.js";
4
+ import { backupRepo } from "../utils/config.js";
4
5
  const inputSchema = {
5
6
  ...nodeParam,
6
7
  snapshotA: z.string().min(1).describe("First snapshot ID (older)"),
@@ -9,7 +10,7 @@ const inputSchema = {
9
10
  export function register(server) {
10
11
  server.tool("homelab_backupDiff", "Show the difference between two restic backup snapshots", inputSchema, async (args) => {
11
12
  try {
12
- const repo = process.env.HOMELAB_BACKUP_REPO || "/mnt/backup/restic";
13
+ const repo = backupRepo(args.node);
13
14
  const output = await execSSH(`sudo restic -r ${repo} diff '${args.snapshotA}' '${args.snapshotB}' 2>&1`, args.node);
14
15
  return { content: [{ type: "text", text: output }] };
15
16
  }
@@ -1 +1 @@
1
- {"version":3,"file":"backupDiff.js","sourceRoot":"","sources":["../../src/tools/backupDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CACpE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,yDAAyD,EACzD,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,UAAU,IAAI,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,QAAQ,EAC1E,IAAI,CAAC,IAAI,CACV,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"}
1
+ {"version":3,"file":"backupDiff.js","sourceRoot":"","sources":["../../src/tools/backupDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CACpE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,yDAAyD,EACzD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,UAAU,IAAI,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,QAAQ,EAC1E,IAAI,CAAC,IAAI,CACV,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"}
@@ -1 +1 @@
1
- {"version":3,"file":"backupList.d.ts","sourceRoot":"","sources":["../../src/tools/backupList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwBhD"}
1
+ {"version":3,"file":"backupList.d.ts","sourceRoot":"","sources":["../../src/tools/backupList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyBhD"}
@@ -1,6 +1,8 @@
1
1
  import { z } from "zod";
2
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
2
+ import { execSSH } from "../utils/ssh-api.js";
3
+ import { resticErrorResponse } from "../utils/restic.js";
3
4
  import { nodeParam } from "../utils/node-param.js";
5
+ import { backupRepo } from "../utils/config.js";
4
6
  const inputSchema = {
5
7
  ...nodeParam,
6
8
  path: z.string().optional().describe("Filter snapshots containing this path"),
@@ -9,8 +11,9 @@ const inputSchema = {
9
11
  };
10
12
  export function register(server) {
11
13
  server.tool("homelab_backupList", "List all restic backup snapshots with optional filtering by path, tag, or host", inputSchema, async (args) => {
14
+ let repo = "";
12
15
  try {
13
- const repo = process.env.HOMELAB_BACKUP_REPO || "/mnt/backup/restic";
16
+ repo = backupRepo(args.node);
14
17
  const flags = [];
15
18
  if (args.path)
16
19
  flags.push(`--path '${args.path}'`);
@@ -19,11 +22,11 @@ export function register(server) {
19
22
  if (args.host)
20
23
  flags.push(`--host '${args.host}'`);
21
24
  const extra = flags.length > 0 ? " " + flags.join(" ") : "";
22
- const output = await execSSH(`sudo restic -r ${repo} snapshots${extra} --json 2>/dev/null || echo "No backup repo found at ${repo} or restic not configured"`, args.node);
25
+ const output = await execSSH(`sudo restic -r ${repo} snapshots${extra} --json`, args.node);
23
26
  return { content: [{ type: "text", text: output }] };
24
27
  }
25
28
  catch (error) {
26
- return errorResponse(error);
29
+ return resticErrorResponse(error, repo);
27
30
  }
28
31
  });
29
32
  }
@@ -1 +1 @@
1
- {"version":3,"file":"backupList.js","sourceRoot":"","sources":["../../src/tools/backupList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC7E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CACrE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,gFAAgF,EAChF,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,oBAAoB,CAAC;YACrE,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YAChD,IAAI,IAAI,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,aAAa,KAAK,wDAAwD,IAAI,4BAA4B,EAChI,IAAI,CAAC,IAAI,CACV,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"}
1
+ {"version":3,"file":"backupList.js","sourceRoot":"","sources":["../../src/tools/backupList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC7E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CACrE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,gFAAgF,EAChF,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,CAAC;YACH,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YAChD,IAAI,IAAI,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,aAAa,KAAK,SAAS,EACjD,IAAI,CAAC,IAAI,CACV,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,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"backupRestore.d.ts","sourceRoot":"","sources":["../../src/tools/backupRestore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyBhD"}
1
+ {"version":3,"file":"backupRestore.d.ts","sourceRoot":"","sources":["../../src/tools/backupRestore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhD"}
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
2
+ import { execSSH, errorResponse, TIMEOUTS } from "../utils/ssh-api.js";
3
3
  import { nodeParam } from "../utils/node-param.js";
4
+ import { backupRepo } from "../utils/config.js";
4
5
  import { confirmParam, confirmCancelled } from "../utils/confirm-param.js";
5
6
  const inputSchema = {
6
7
  ...nodeParam,
@@ -24,9 +25,9 @@ export function register(server) {
24
25
  return confirmCancelled("Restore");
25
26
  }
26
27
  try {
27
- const repo = process.env.HOMELAB_BACKUP_REPO || "/mnt/backup/restic";
28
+ const repo = backupRepo(args.node);
28
29
  const includeFlag = args.include ? ` --include '${args.include}'` : "";
29
- const output = await execSSH(`sudo restic -r ${repo} restore '${args.snapshot}' --target '${args.target}'${includeFlag} 2>&1`, args.node);
30
+ const output = await execSSH(`sudo restic -r ${repo} restore '${args.snapshot}' --target '${args.target}'${includeFlag} 2>&1`, args.node, { timeoutMs: TIMEOUTS.backup });
30
31
  return { content: [{ type: "text", text: output }] };
31
32
  }
32
33
  catch (error) {
@@ -1 +1 @@
1
- {"version":3,"file":"backupRestore.js","sourceRoot":"","sources":["../../src/tools/backupRestore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;IACnF,GAAG,YAAY;CAChB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,wEAAwE,EACxE,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,oBAAoB,CAAC;YACrE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,aAAa,IAAI,CAAC,QAAQ,eAAe,IAAI,CAAC,MAAM,IAAI,WAAW,OAAO,EAChG,IAAI,CAAC,IAAI,CACV,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"}
1
+ {"version":3,"file":"backupRestore.js","sourceRoot":"","sources":["../../src/tools/backupRestore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;IACnF,GAAG,YAAY;CAChB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,wEAAwE,EACxE,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,aAAa,IAAI,CAAC,QAAQ,eAAe,IAAI,CAAC,MAAM,IAAI,WAAW,OAAO,EAChG,IAAI,CAAC,IAAI,EACT,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,CAC/B,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"}
@@ -1 +1 @@
1
- {"version":3,"file":"backupRun.d.ts","sourceRoot":"","sources":["../../src/tools/backupRun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBhD"}
1
+ {"version":3,"file":"backupRun.d.ts","sourceRoot":"","sources":["../../src/tools/backupRun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8BhD"}
@@ -1,17 +1,25 @@
1
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
1
+ import { execSSH, errorResponse, TIMEOUTS } from "../utils/ssh-api.js";
2
2
  import { nodeParam } from "../utils/node-param.js";
3
3
  import { confirmParam, confirmCancelled } from "../utils/confirm-param.js";
4
4
  const inputSchema = {
5
5
  ...nodeParam,
6
6
  ...confirmParam,
7
7
  };
8
+ const BACKUP_SCRIPT = "/opt/backup/backup.sh";
8
9
  export function register(server) {
9
10
  server.tool("homelab_backupRun", "Trigger a restic backup on the Pi", inputSchema, async (args) => {
10
11
  if (!args.confirm) {
11
12
  return confirmCancelled("Backup");
12
13
  }
13
14
  try {
14
- const output = await execSSH("sudo /opt/backup/backup.sh 2>&1 || echo 'Backup script not found at /opt/backup/backup.sh'", args.node);
15
+ // Check for the script separately so "not found" is only reported
16
+ // when it is actually missing. A failing backup exits non-zero and
17
+ // surfaces as an error with the tail of its output.
18
+ const output = await execSSH(`if ! sudo test -x ${BACKUP_SCRIPT}; then ` +
19
+ `echo 'Backup script not found or not executable at ${BACKUP_SCRIPT}' >&2; exit 127; fi; ` +
20
+ `out=$(sudo ${BACKUP_SCRIPT} 2>&1); rc=$?; ` +
21
+ `if [ "$rc" -ne 0 ]; then printf '%s\\n' "$out" | tail -40 >&2; exit "$rc"; fi; ` +
22
+ `printf '%s\\n' "$out"`, args.node, { timeoutMs: TIMEOUTS.backup });
15
23
  return { content: [{ type: "text", text: output }] };
16
24
  }
17
25
  catch (error) {