@tmhs/homelab-mcp 0.15.4 → 0.16.1

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 (120) hide show
  1. package/README.md +6 -3
  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 +7 -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 +13 -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 +12 -2
  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 +2 -1
  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 +9 -1
  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 +7 -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 +3 -9
  40. package/dist/tools/certList.js.map +1 -1
  41. package/dist/tools/composeDown.d.ts.map +1 -1
  42. package/dist/tools/composeDown.js +2 -9
  43. package/dist/tools/composeDown.js.map +1 -1
  44. package/dist/tools/composePs.d.ts.map +1 -1
  45. package/dist/tools/composePs.js +2 -2
  46. package/dist/tools/composePs.js.map +1 -1
  47. package/dist/tools/composePull.d.ts.map +1 -1
  48. package/dist/tools/composePull.js +2 -9
  49. package/dist/tools/composePull.js.map +1 -1
  50. package/dist/tools/composeUp.d.ts.map +1 -1
  51. package/dist/tools/composeUp.js +4 -10
  52. package/dist/tools/composeUp.js.map +1 -1
  53. package/dist/tools/containerScan.d.ts.map +1 -1
  54. package/dist/tools/containerScan.js +12 -4
  55. package/dist/tools/containerScan.js.map +1 -1
  56. package/dist/tools/diskUsage.d.ts.map +1 -1
  57. package/dist/tools/diskUsage.js +2 -1
  58. package/dist/tools/diskUsage.js.map +1 -1
  59. package/dist/tools/grafanaSnapshot.d.ts.map +1 -1
  60. package/dist/tools/grafanaSnapshot.js +11 -34
  61. package/dist/tools/grafanaSnapshot.js.map +1 -1
  62. package/dist/tools/logSearch.d.ts.map +1 -1
  63. package/dist/tools/logSearch.js +17 -4
  64. package/dist/tools/logSearch.js.map +1 -1
  65. package/dist/tools/npmCerts.d.ts.map +1 -1
  66. package/dist/tools/npmCerts.js +6 -38
  67. package/dist/tools/npmCerts.js.map +1 -1
  68. package/dist/tools/npmProxyHosts.d.ts.map +1 -1
  69. package/dist/tools/npmProxyHosts.js +6 -38
  70. package/dist/tools/npmProxyHosts.js.map +1 -1
  71. package/dist/tools/ntfySend.d.ts.map +1 -1
  72. package/dist/tools/ntfySend.js +6 -16
  73. package/dist/tools/ntfySend.js.map +1 -1
  74. package/dist/tools/ntfyTopics.d.ts +4 -0
  75. package/dist/tools/ntfyTopics.d.ts.map +1 -1
  76. package/dist/tools/ntfyTopics.js +26 -17
  77. package/dist/tools/ntfyTopics.js.map +1 -1
  78. package/dist/tools/prometheusQuery.d.ts.map +1 -1
  79. package/dist/tools/prometheusQuery.js +8 -16
  80. package/dist/tools/prometheusQuery.js.map +1 -1
  81. package/dist/tools/serviceLogs.d.ts.map +1 -1
  82. package/dist/tools/serviceLogs.js +4 -1
  83. package/dist/tools/serviceLogs.js.map +1 -1
  84. package/dist/tools/speedtestResults.d.ts.map +1 -1
  85. package/dist/tools/speedtestResults.js +6 -16
  86. package/dist/tools/speedtestResults.js.map +1 -1
  87. package/dist/tools/sshTest.js +4 -4
  88. package/dist/tools/sshTest.js.map +1 -1
  89. package/dist/tools/uptimeKumaStatus.d.ts +4 -0
  90. package/dist/tools/uptimeKumaStatus.d.ts.map +1 -1
  91. package/dist/tools/uptimeKumaStatus.js +30 -16
  92. package/dist/tools/uptimeKumaStatus.js.map +1 -1
  93. package/dist/tools/volumeBackup.d.ts.map +1 -1
  94. package/dist/tools/volumeBackup.js +2 -1
  95. package/dist/tools/volumeBackup.js.map +1 -1
  96. package/dist/utils/compose.d.ts +27 -0
  97. package/dist/utils/compose.d.ts.map +1 -0
  98. package/dist/utils/compose.js +92 -0
  99. package/dist/utils/compose.js.map +1 -0
  100. package/dist/utils/config.d.ts +4 -0
  101. package/dist/utils/config.d.ts.map +1 -0
  102. package/dist/utils/config.js +7 -0
  103. package/dist/utils/config.js.map +1 -0
  104. package/dist/utils/restic.d.ts +13 -0
  105. package/dist/utils/restic.d.ts.map +1 -0
  106. package/dist/utils/restic.js +21 -0
  107. package/dist/utils/restic.js.map +1 -0
  108. package/dist/utils/service-http.d.ts +82 -0
  109. package/dist/utils/service-http.d.ts.map +1 -0
  110. package/dist/utils/service-http.js +104 -0
  111. package/dist/utils/service-http.js.map +1 -0
  112. package/dist/utils/since-param.d.ts +13 -0
  113. package/dist/utils/since-param.d.ts.map +1 -0
  114. package/dist/utils/since-param.js +21 -0
  115. package/dist/utils/since-param.js.map +1 -0
  116. package/dist/utils/ssh-api.d.ts +8 -2
  117. package/dist/utils/ssh-api.d.ts.map +1 -1
  118. package/dist/utils/ssh-api.js +33 -1
  119. package/dist/utils/ssh-api.js.map +1 -1
  120. package/package.json +1 -1
@@ -1,51 +1,19 @@
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 = 81;
5
- const SERVICE_NAME = "Nginx Proxy Manager";
6
- function getPort() {
7
- const override = process.env.HOMELAB_NPM_PORT;
8
- return override ? parseInt(override, 10) : DEFAULT_PORT;
9
- }
10
- function getCredentials() {
11
- return {
12
- email: process.env.HOMELAB_NPM_EMAIL || "admin@example.com",
13
- password: process.env.HOMELAB_NPM_PASSWORD || "changeme",
14
- };
15
- }
16
- async function getNpmToken(port, node) {
17
- const { email, password } = getCredentials();
18
- const payload = JSON.stringify({ identity: email, secret: password });
19
- const output = await execSSH(`curl -sf -X POST -H 'Content-Type: application/json' ` +
20
- `-d '${payload}' 'http://localhost:${port}/api/tokens'`, node);
21
- const parsed = JSON.parse(output);
22
- return parsed.token;
23
- }
3
+ import { SERVICES, servicePort, getNpmToken, curlErrorResponse } from "../utils/service-http.js";
4
+ const SERVICE = SERVICES.npm;
24
5
  export function register(server) {
25
6
  server.tool("homelab_npmProxyHosts", "List all Nginx Proxy Manager proxy host configurations", { ...nodeParam }, async (args) => {
26
- const port = getPort();
7
+ let port = SERVICE.defaultPort;
27
8
  try {
9
+ port = servicePort(SERVICE, args.node);
28
10
  const token = await getNpmToken(port, args.node);
29
11
  const output = await execSSH(`curl -sf -H 'Authorization: Bearer ${token}' ` +
30
12
  `'http://localhost:${port}/api/nginx/proxy-hosts'`, args.node);
31
13
  return { content: [{ type: "text", text: output }] };
32
14
  }
33
15
  catch (error) {
34
- if (error instanceof CommandFailedError) {
35
- if (error.exitCode === 7) {
36
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
37
- `Set HOMELAB_NPM_PORT if using a non-default port.`));
38
- }
39
- if (error.exitCode === 22) {
40
- return errorResponse(new Error(`${SERVICE_NAME} returned an HTTP error. Check authentication -- ` +
41
- `set HOMELAB_NPM_EMAIL and HOMELAB_NPM_PASSWORD.`));
42
- }
43
- }
44
- if (error instanceof SyntaxError) {
45
- return errorResponse(new Error(`Failed to parse ${SERVICE_NAME} authentication response. ` +
46
- `Verify HOMELAB_NPM_EMAIL and HOMELAB_NPM_PASSWORD are correct.`));
47
- }
48
- return errorResponse(error);
16
+ return curlErrorResponse(error, SERVICE, port);
49
17
  }
50
18
  });
51
19
  }
@@ -1 +1 @@
1
- {"version":3,"file":"npmProxyHosts.js","sourceRoot":"","sources":["../../src/tools/npmProxyHosts.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,EAAE,CAAC;AACxB,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAE3C,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC9C,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc;IACrB,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,mBAAmB;QAC3D,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,UAAU;KACzD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAa;IACpD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,uDAAuD;QACrD,OAAO,OAAO,uBAAuB,IAAI,cAAc,EACzD,IAAI,CACL,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,wDAAwD,EACxD,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,sCAAsC,KAAK,IAAI;gBAC7C,qBAAqB,IAAI,yBAAyB,EACpD,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,mDAAmD,CACtD,CACF,CAAC;gBACJ,CAAC;gBACD,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;oBAC1B,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,GAAG,YAAY,mDAAmD;wBAChE,iDAAiD,CACpD,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;gBACjC,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,mBAAmB,YAAY,4BAA4B;oBACzD,gEAAgE,CACnE,CACF,CAAC;YACJ,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"npmProxyHosts.js","sourceRoot":"","sources":["../../src/tools/npmProxyHosts.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,GAAG,CAAC;AAE7B,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,wDAAwD,EACxD,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,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,sCAAsC,KAAK,IAAI;gBAC7C,qBAAqB,IAAI,yBAAyB,EACpD,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":"ntfySend.d.ts","sourceRoot":"","sources":["../../src/tools/ntfySend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqCzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+BhD"}
1
+ {"version":3,"file":"ntfySend.d.ts","sourceRoot":"","sources":["../../src/tools/ntfySend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsBhD"}
@@ -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 = 8080;
6
- const SERVICE_NAME = "Ntfy";
4
+ import { SERVICES, servicePort, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.ntfy;
7
6
  const inputSchema = {
8
7
  ...nodeParam,
9
8
  topic: z
@@ -27,14 +26,11 @@ const inputSchema = {
27
26
  .optional()
28
27
  .describe("Comma-separated tags/emojis (e.g. 'warning,server')"),
29
28
  };
30
- function getPort() {
31
- const override = process.env.HOMELAB_NTFY_PORT;
32
- return override ? parseInt(override, 10) : DEFAULT_PORT;
33
- }
34
29
  export function register(server) {
35
30
  server.tool("homelab_ntfySend", "Send a push notification via Ntfy", inputSchema, async (args) => {
36
- const port = getPort();
31
+ let port = SERVICE.defaultPort;
37
32
  try {
33
+ port = servicePort(SERVICE, args.node);
38
34
  const headers = [];
39
35
  if (args.title)
40
36
  headers.push(`-H 'Title: ${args.title}'`);
@@ -48,13 +44,7 @@ export function register(server) {
48
44
  return { content: [{ type: "text", text: output || `Notification sent to topic '${args.topic}'.` }] };
49
45
  }
50
46
  catch (error) {
51
- if (error instanceof CommandFailedError) {
52
- if (error.exitCode === 7) {
53
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
54
- `Set HOMELAB_NTFY_PORT if using a non-default port.`));
55
- }
56
- }
57
- return errorResponse(error);
47
+ return curlErrorResponse(error, SERVICE, port);
58
48
  }
59
49
  });
60
50
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ntfySend.js","sourceRoot":"","sources":["../../src/tools/ntfySend.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,MAAM,CAAC;AAE5B,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0BAA0B,CAAC;IACvC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,2BAA2B,CAAC;IACxC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oBAAoB,CAAC;IACjC,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SACjD,QAAQ,EAAE;SACV,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC;AAEF,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC/C,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,kBAAkB,EAClB,mCAAmC,EACnC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YAC1D,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YACnE,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,gBAAgB,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;YACrG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,IAAI,+BAA+B,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACjH,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,oDAAoD,CACvD,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":"ntfySend.js","sourceRoot":"","sources":["../../src/tools/ntfySend.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,IAAI,CAAC;AAE9B,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0BAA0B,CAAC;IACvC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,2BAA2B,CAAC;IACxC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oBAAoB,CAAC;IACjC,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SACjD,QAAQ,EAAE;SACV,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,mCAAmC,EACnC,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,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YAC1D,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YACnE,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,gBAAgB,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;YACrG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,IAAI,+BAA+B,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACjH,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,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /** Ntfy topic names: [-_A-Za-z0-9]{1,64}; several can be joined with commas. */
3
+ export declare const TOPIC_LIST_RE: RegExp;
4
+ /** Resolve the topic list from the argument or HOMELAB_NTFY_TOPICS. */
5
+ export declare function resolveTopics(topic?: string, node?: string): string | null;
2
6
  export declare function register(server: McpServer): void;
3
7
  //# sourceMappingURL=ntfyTopics.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ntfyTopics.d.ts","sourceRoot":"","sources":["../../src/tools/ntfyTopics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2BhD"}
1
+ {"version":3,"file":"ntfyTopics.d.ts","sourceRoot":"","sources":["../../src/tools/ntfyTopics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,gFAAgF;AAChF,eAAO,MAAM,aAAa,QAAiD,CAAC;AAE5E,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI1E;AAmBD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+BhD"}
@@ -1,42 +1,51 @@
1
1
  import { z } from "zod";
2
2
  import { execSSH, errorResponse } from "../utils/ssh-api.js";
3
- import { CommandFailedError } from "../utils/errors.js";
4
3
  import { nodeParam } from "../utils/node-param.js";
5
- const DEFAULT_PORT = 8080;
6
- const SERVICE_NAME = "Ntfy";
4
+ import { SERVICES, servicePort, setting, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.ntfy;
6
+ /** Ntfy topic names: [-_A-Za-z0-9]{1,64}; several can be joined with commas. */
7
+ export const TOPIC_LIST_RE = /^[-_A-Za-z0-9]{1,64}(,[-_A-Za-z0-9]{1,64})*$/;
8
+ /** Resolve the topic list from the argument or HOMELAB_NTFY_TOPICS. */
9
+ export function resolveTopics(topic, node) {
10
+ const candidate = (topic ?? setting(node, "HOMELAB_NTFY_TOPICS") ?? "").replace(/\s+/g, "");
11
+ if (!candidate)
12
+ return null;
13
+ return TOPIC_LIST_RE.test(candidate) ? candidate : null;
14
+ }
7
15
  const inputSchema = {
8
16
  ...nodeParam,
9
17
  topic: z
10
18
  .string()
19
+ .regex(TOPIC_LIST_RE, "Topic names may only contain letters, digits, '-' and '_' (comma-separate several)")
11
20
  .optional()
12
- .describe("Specific topic to check. Lists all cached messages if omitted"),
21
+ .describe("Topic, or comma-separated topics (e.g. 'alerts,backups'). Defaults to HOMELAB_NTFY_TOPICS. " +
22
+ "Ntfy has no 'all topics' subscription, so at least one topic is required"),
13
23
  since: z
14
24
  .string()
15
25
  .optional()
16
26
  .default("1h")
17
27
  .describe("Time window for recent messages (e.g. '1h', '30m', '1d')"),
18
28
  };
19
- function getPort() {
20
- const override = process.env.HOMELAB_NTFY_PORT;
21
- return override ? parseInt(override, 10) : DEFAULT_PORT;
22
- }
23
29
  export function register(server) {
24
30
  server.tool("homelab_ntfyTopics", "List Ntfy topics and recent messages", inputSchema, async (args) => {
25
- const port = getPort();
31
+ let port = SERVICE.defaultPort;
32
+ let topicPath = null;
26
33
  try {
27
- const topicPath = args.topic || "*";
34
+ port = servicePort(SERVICE, args.node);
35
+ topicPath = resolveTopics(args.topic, args.node);
36
+ if (!topicPath) {
37
+ return errorResponse(new Error("No ntfy topic given. Pass `topic` (one topic or a comma-separated list such as " +
38
+ "'alerts,backups') or set HOMELAB_NTFY_TOPICS. Ntfy has no wildcard subscription for all topics."));
39
+ }
28
40
  const cmd = `curl -sf 'http://localhost:${port}/${topicPath}/json?since=${args.since}&poll=1'`;
29
41
  const output = await execSSH(cmd, args.node);
30
42
  return { content: [{ type: "text", text: output || "No recent messages found." }] };
31
43
  }
32
44
  catch (error) {
33
- if (error instanceof CommandFailedError) {
34
- if (error.exitCode === 7) {
35
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
36
- `Set HOMELAB_NTFY_PORT if using a non-default port.`));
37
- }
38
- }
39
- return errorResponse(error);
45
+ return curlErrorResponse(error, SERVICE, port, {
46
+ httpError: `${SERVICE.name} returned an HTTP error for topic(s) "${topicPath}". Check the topic ` +
47
+ `names, the 'since' value (e.g. 1h, 30m, all), and access control on the server.`,
48
+ });
40
49
  }
41
50
  });
42
51
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ntfyTopics.js","sourceRoot":"","sources":["../../src/tools/ntfyTopics.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,MAAM,CAAC;AAE5B,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC;AAEF,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC/C,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,oBAAoB,EACpB,sCAAsC,EACtC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;YACpC,MAAM,GAAG,GAAG,8BAA8B,IAAI,IAAI,SAAS,eAAe,IAAI,CAAC,KAAK,UAAU,CAAC;YAC/F,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,IAAI,2BAA2B,EAAE,CAAC,EAAE,CAAC;QAC/F,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,oDAAoD,CACvD,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":"ntfyTopics.js","sourceRoot":"","sources":["../../src/tools/ntfyTopics.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,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7F,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;AAE9B,gFAAgF;AAChF,MAAM,CAAC,MAAM,aAAa,GAAG,8CAA8C,CAAC;AAE5E,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,IAAa;IACzD,MAAM,SAAS,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,KAAK,CAAC,aAAa,EAAE,oFAAoF,CAAC;SAC1G,QAAQ,EAAE;SACV,QAAQ,CACP,6FAA6F;QAC3F,0EAA0E,CAC7E;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,sCAAsC,EACtC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,iFAAiF;oBAC/E,iGAAiG,CACpG,CACF,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,GAAG,8BAA8B,IAAI,IAAI,SAAS,eAAe,IAAI,CAAC,KAAK,UAAU,CAAC;YAC/F,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,IAAI,2BAA2B,EAAE,CAAC,EAAE,CAAC;QAC/F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;gBAC7C,SAAS,EACP,GAAG,OAAO,CAAC,IAAI,yCAAyC,SAAS,qBAAqB;oBACtF,iFAAiF;aACpF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"prometheusQuery.d.ts","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+BhD"}
1
+ {"version":3,"file":"prometheusQuery.d.ts","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwBhD"}
@@ -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 = 9090;
6
- const SERVICE_NAME = "Prometheus";
4
+ import { SERVICES, servicePort, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.prometheus;
7
6
  const inputSchema = {
8
7
  ...nodeParam,
9
8
  query: z.string().min(1).describe("PromQL expression to evaluate"),
@@ -12,27 +11,20 @@ const inputSchema = {
12
11
  .optional()
13
12
  .describe("Evaluation timestamp (RFC3339 or Unix). Defaults to current time"),
14
13
  };
15
- function getPort() {
16
- const override = process.env.HOMELAB_PROMETHEUS_PORT;
17
- return override ? parseInt(override, 10) : DEFAULT_PORT;
18
- }
19
14
  export function register(server) {
20
15
  server.tool("homelab_prometheusQuery", "Run a PromQL query against Prometheus and return the result", inputSchema, async (args) => {
21
- const port = getPort();
16
+ let port = SERVICE.defaultPort;
22
17
  try {
18
+ port = servicePort(SERVICE, args.node);
23
19
  const encoded = encodeURIComponent(args.query);
24
20
  const timeParam = args.time ? `&time=${encodeURIComponent(args.time)}` : "";
25
21
  const output = await execSSH(`curl -sf 'http://localhost:${port}/api/v1/query?query=${encoded}${timeParam}'`, args.node);
26
22
  return { content: [{ type: "text", text: output }] };
27
23
  }
28
24
  catch (error) {
29
- if (error instanceof CommandFailedError) {
30
- if (error.exitCode === 7) {
31
- return errorResponse(new Error(`Could not reach ${SERVICE_NAME} on port ${port}. Is it running? ` +
32
- `Set HOMELAB_PROMETHEUS_PORT if using a non-default port.`));
33
- }
34
- }
35
- return errorResponse(error);
25
+ return curlErrorResponse(error, SERVICE, port, {
26
+ httpError: `${SERVICE.name} on port ${port} returned an HTTP error. Check the PromQL expression and time value.`,
27
+ });
36
28
  }
37
29
  });
38
30
  }
@@ -1 +1 @@
1
- {"version":3,"file":"prometheusQuery.js","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;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,YAAY,CAAC;AAElC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAClE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;AAEF,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACrD,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,yBAAyB,EACzB,6DAA6D,EAC7D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,uBAAuB,OAAO,GAAG,SAAS,GAAG,EAC/E,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,mBAAmB,YAAY,YAAY,IAAI,mBAAmB;wBAChE,0DAA0D,CAC7D,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":"prometheusQuery.js","sourceRoot":"","sources":["../../src/tools/prometheusQuery.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,UAAU,CAAC;AAEpC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAClE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,6DAA6D,EAC7D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,uBAAuB,OAAO,GAAG,SAAS,GAAG,EAC/E,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,EAAE;gBAC7C,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,YAAY,IAAI,sEAAsE;aACjH,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"serviceLogs.d.ts","sourceRoot":"","sources":["../../src/tools/serviceLogs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBhD"}
1
+ {"version":3,"file":"serviceLogs.d.ts","sourceRoot":"","sources":["../../src/tools/serviceLogs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwBhD"}
@@ -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 { sinceSchema, toDockerSince } from "../utils/since-param.js";
4
5
  const inputSchema = {
5
6
  ...nodeParam,
6
7
  service: z.string().min(1).describe("Container name to get logs from"),
@@ -12,11 +13,13 @@ const inputSchema = {
12
13
  .optional()
13
14
  .default(50)
14
15
  .describe("Number of recent log lines to return"),
16
+ since: sinceSchema("Only show logs newer than this (e.g. 30m, 2h, 7d, or an ISO date)").optional(),
15
17
  };
16
18
  export function register(server) {
17
19
  server.tool("homelab_serviceLogs", "Tail recent logs from a Docker container on the Pi", inputSchema, async (args) => {
18
20
  try {
19
- const output = await execSSH(`docker logs --tail ${args.lines} ${args.service} 2>&1`, args.node);
21
+ const since = args.since ? ` --since ${toDockerSince(args.since)}` : "";
22
+ const output = await execSSH(`docker logs --tail ${args.lines}${since} ${args.service} 2>&1`, args.node);
20
23
  return {
21
24
  content: [{
22
25
  type: "text",
@@ -1 +1 @@
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;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,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,GAAG,CAAC,IAAI,CAAC;SACT,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,EACvD,IAAI,CAAC,IAAI,CACV,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"}
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;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,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,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,sCAAsC,CAAC;IACnD,KAAK,EAAE,WAAW,CAAC,mEAAmE,CAAC,CAAC,QAAQ,EAAE;CACnG,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,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,sBAAsB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,OAAO,EAC/D,IAAI,CAAC,IAAI,CACV,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"}
@@ -1 +1 @@
1
- {"version":3,"file":"speedtestResults.d.ts","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BhD"}
1
+ {"version":3,"file":"speedtestResults.d.ts","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoBhD"}
@@ -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 = 8765;
6
- const SERVICE_NAME = "Speedtest Tracker";
4
+ import { SERVICES, servicePort, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.speedtest;
7
6
  const inputSchema = {
8
7
  ...nodeParam,
9
8
  count: z
@@ -15,25 +14,16 @@ const inputSchema = {
15
14
  .default(5)
16
15
  .describe("Number of recent speedtest results to return"),
17
16
  };
18
- function getPort() {
19
- const override = process.env.HOMELAB_SPEEDTEST_PORT;
20
- return override ? parseInt(override, 10) : DEFAULT_PORT;
21
- }
22
17
  export function register(server) {
23
18
  server.tool("homelab_speedtestResults", "Get recent speedtest results from Speedtest Tracker", inputSchema, async (args) => {
24
- const port = getPort();
19
+ let port = SERVICE.defaultPort;
25
20
  try {
21
+ port = servicePort(SERVICE, args.node);
26
22
  const output = await execSSH(`curl -sf 'http://localhost:${port}/api/speedtest/latest?limit=${args.count}'`, args.node);
27
23
  return { content: [{ type: "text", text: output }] };
28
24
  }
29
25
  catch (error) {
30
- if (error instanceof CommandFailedError) {
31
- if (error.exitCode === 7) {
32
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
33
- `Set HOMELAB_SPEEDTEST_PORT if using a non-default port.`));
34
- }
35
- }
36
- return errorResponse(error);
26
+ return curlErrorResponse(error, SERVICE, port);
37
27
  }
38
28
  });
39
29
  }
@@ -1 +1 @@
1
- {"version":3,"file":"speedtestResults.js","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;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,mBAAmB,CAAC;AAEzC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC;AAEF,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACpD,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,0BAA0B,EAC1B,qDAAqD,EACrD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,+BAA+B,IAAI,CAAC,KAAK,GAAG,EAC9E,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,yDAAyD,CAC5D,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":"speedtestResults.js","sourceRoot":"","sources":["../../src/tools/speedtestResults.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,SAAS,CAAC;AAEnC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,qDAAqD,EACrD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,+BAA+B,IAAI,CAAC,KAAK,GAAG,EAC9E,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,10 +1,10 @@
1
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
1
+ import { execSSH, errorResponse, getNodeConfig } from "../utils/ssh-api.js";
2
2
  import { nodeParam } from "../utils/node-param.js";
3
3
  export function register(server) {
4
- server.tool("homelab_sshTest", "Test SSH connectivity to the Raspberry Pi", { ...nodeParam }, async (args) => {
4
+ server.tool("homelab_sshTest", "Test SSH connectivity to the Raspberry Pi (or another registered node)", { ...nodeParam }, async (args) => {
5
5
  try {
6
- const host = process.env.HOMELAB_PI_HOST || "raspberrypi.local";
7
- const user = process.env.HOMELAB_PI_USER || "pi";
6
+ // Report the node that was actually tested, not the default Pi.
7
+ const { host, username: user } = getNodeConfig(args.node);
8
8
  const output = await execSSH("echo ok && hostname && uptime -p", args.node);
9
9
  const lines = output.split("\n");
10
10
  return {
@@ -1 +1 @@
1
- {"version":3,"file":"sshTest.js","sourceRoot":"","sources":["../../src/tools/sshTest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,2CAA2C,EAC3C,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,mBAAmB,CAAC;YAChE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC;YAEjD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kCAAkC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5E,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"}
1
+ {"version":3,"file":"sshTest.js","sourceRoot":"","sources":["../../src/tools/sshTest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,wEAAwE,EACxE,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,gEAAgE;YAChE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kCAAkC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5E,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"}
@@ -1,3 +1,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /** Uptime Kuma status page slugs: lowercase letters, digits and dashes. */
3
+ export declare const SLUG_RE: RegExp;
4
+ /** Slug from the argument, then HOMELAB_UPTIME_KUMA_SLUG, then "default". */
5
+ export declare function resolveSlug(slug?: string, node?: string): string;
2
6
  export declare function register(server: McpServer): void;
3
7
  //# sourceMappingURL=uptimeKumaStatus.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"uptimeKumaStatus.d.ts","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BhD"}
1
+ {"version":3,"file":"uptimeKumaStatus.d.ts","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,2EAA2E;AAC3E,eAAO,MAAM,OAAO,QAAiB,CAAC;AAEtC,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAWD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkChD"}
@@ -1,27 +1,41 @@
1
+ import { z } from "zod";
1
2
  import { execSSH, errorResponse } from "../utils/ssh-api.js";
2
- import { CommandFailedError } from "../utils/errors.js";
3
3
  import { nodeParam } from "../utils/node-param.js";
4
- const DEFAULT_PORT = 3001;
5
- const SERVICE_NAME = "Uptime Kuma";
6
- function getPort() {
7
- const override = process.env.HOMELAB_UPTIME_KUMA_PORT;
8
- return override ? parseInt(override, 10) : DEFAULT_PORT;
4
+ import { SERVICES, servicePort, setting, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.uptimeKuma;
6
+ /** Uptime Kuma status page slugs: lowercase letters, digits and dashes. */
7
+ export const SLUG_RE = /^[a-z0-9-]+$/;
8
+ /** Slug from the argument, then HOMELAB_UPTIME_KUMA_SLUG, then "default". */
9
+ export function resolveSlug(slug, node) {
10
+ return slug || setting(node, "HOMELAB_UPTIME_KUMA_SLUG", "default");
9
11
  }
12
+ const inputSchema = {
13
+ ...nodeParam,
14
+ slug: z
15
+ .string()
16
+ .regex(SLUG_RE, "Slug may only contain lowercase letters, digits and '-'")
17
+ .optional()
18
+ .describe("Status page slug (default: HOMELAB_UPTIME_KUMA_SLUG or 'default')"),
19
+ };
10
20
  export function register(server) {
11
- server.tool("homelab_uptimeKumaStatus", "Get the status of all Uptime Kuma monitors", { ...nodeParam }, async (args) => {
12
- const port = getPort();
21
+ server.tool("homelab_uptimeKumaStatus", "Get the status of all Uptime Kuma monitors", inputSchema, async (args) => {
22
+ let port = SERVICE.defaultPort;
23
+ let slug = "default";
13
24
  try {
14
- const output = await execSSH(`curl -sf 'http://localhost:${port}/api/status-page/heartbeat/default'`, args.node);
25
+ port = servicePort(SERVICE, args.node);
26
+ slug = resolveSlug(args.slug, args.node);
27
+ if (!SLUG_RE.test(slug)) {
28
+ return errorResponse(new Error(`Invalid Uptime Kuma status page slug "${slug}" (HOMELAB_UPTIME_KUMA_SLUG). ` +
29
+ "Use lowercase letters, digits and '-'."));
30
+ }
31
+ const output = await execSSH(`curl -sf 'http://localhost:${port}/api/status-page/heartbeat/${slug}'`, args.node);
15
32
  return { content: [{ type: "text", text: output }] };
16
33
  }
17
34
  catch (error) {
18
- if (error instanceof CommandFailedError) {
19
- if (error.exitCode === 7) {
20
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
21
- `Set HOMELAB_UPTIME_KUMA_PORT if using a non-default port.`));
22
- }
23
- }
24
- return errorResponse(error);
35
+ return curlErrorResponse(error, SERVICE, port, {
36
+ httpError: `${SERVICE.name} returned an HTTP error for status page "${slug}". Check that the ` +
37
+ "status page exists, or pass `slug` / set HOMELAB_UPTIME_KUMA_SLUG.",
38
+ });
25
39
  }
26
40
  });
27
41
  }
@@ -1 +1 @@
1
- {"version":3,"file":"uptimeKumaStatus.js","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.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,aAAa,CAAC;AAEnC,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACtD,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,0BAA0B,EAC1B,4CAA4C,EAC5C,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,qCAAqC,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,2DAA2D,CAC9D,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":"uptimeKumaStatus.js","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.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,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7F,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC;AAEpC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC;AAEtC,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,IAAa;IACtD,OAAO,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,0BAA0B,EAAE,SAAS,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,yDAAyD,CAAC;SACzE,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;CACjF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,4CAA4C,EAC5C,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,IAAI,GAAG,SAAS,CAAC;QACrB,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,yCAAyC,IAAI,gCAAgC;oBAC3E,wCAAwC,CAC3C,CACF,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,8BAA8B,IAAI,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,EAAE;gBAC7C,SAAS,EACP,GAAG,OAAO,CAAC,IAAI,4CAA4C,IAAI,oBAAoB;oBACnF,oEAAoE;aACvE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"volumeBackup.d.ts","sourceRoot":"","sources":["../../src/tools/volumeBackup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhD"}
1
+ {"version":3,"file":"volumeBackup.d.ts","sourceRoot":"","sources":["../../src/tools/volumeBackup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhD"}
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
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,
@@ -13,7 +14,7 @@ export function register(server) {
13
14
  return confirmCancelled("Volume backup");
14
15
  }
15
16
  try {
16
- const repo = process.env.HOMELAB_BACKUP_REPO || "/mnt/backup/restic";
17
+ const repo = backupRepo(args.node);
17
18
  const volumePath = `/var/lib/docker/volumes/${args.volume}/_data`;
18
19
  const output = await execSSH(`sudo restic -r ${repo} backup '${volumePath}' --tag docker-volume --tag '${args.volume}' 2>&1`, args.node, { timeoutMs: TIMEOUTS.backup });
19
20
  return { content: [{ type: "text", text: output }] };
@@ -1 +1 @@
1
- {"version":3,"file":"volumeBackup.js","sourceRoot":"","sources":["../../src/tools/volumeBackup.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,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACnE,GAAG,YAAY;CAChB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,2DAA2D,EAC3D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,oBAAoB,CAAC;YACrE,MAAM,UAAU,GAAG,2BAA2B,IAAI,CAAC,MAAM,QAAQ,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,YAAY,UAAU,gCAAgC,IAAI,CAAC,MAAM,QAAQ,EAC/F,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
+ {"version":3,"file":"volumeBackup.js","sourceRoot":"","sources":["../../src/tools/volumeBackup.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,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACnE,GAAG,YAAY;CAChB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,2DAA2D,EAC3D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,2BAA2B,IAAI,CAAC,MAAM,QAAQ,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,YAAY,UAAU,gCAAgC,IAAI,CAAC,MAAM,QAAQ,EAC/F,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"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Shared compose file selection for composeUp, composeDown, composePull and
3
+ * composePs.
4
+ *
5
+ * Resolution order when no `stacks` are passed:
6
+ * 1. HOMELAB_COMPOSE_FILES (comma-separated, used in the given order)
7
+ * 2. Discovery in the compose directory on the node: compose.base.yml first,
8
+ * then the reference stack files in their historical order (monitoring,
9
+ * network, apps, security, storage, tools) when present, then any other
10
+ * compose.*.yml alphabetically. If none exist, the first of compose.yaml,
11
+ * compose.yml, docker-compose.yaml, docker-compose.yml is used.
12
+ */
13
+ export declare const DEFAULT_COMPOSE_DIR = "/opt/homelab/docker";
14
+ /** Reference layout, in the order the files were always passed. */
15
+ export declare const KNOWN_STACK_FILES: readonly ["compose.base.yml", "compose.monitoring.yml", "compose.network.yml", "compose.apps.yml", "compose.security.yml", "compose.storage.yml", "compose.tools.yml"];
16
+ export declare function composeDir(node?: string): string;
17
+ /** Parse HOMELAB_COMPOSE_FILES; returns null when unset or empty. */
18
+ export declare function configuredComposeFiles(node?: string): string[] | null;
19
+ /**
20
+ * Build the full remote command: cd into the compose dir, pick the files,
21
+ * and run `docker compose <files> <action>`.
22
+ *
23
+ * When `stacks` is given, compose.base.yml is passed first followed by each
24
+ * requested file (unchanged behavior).
25
+ */
26
+ export declare function buildComposeCommand(action: string, stacks?: string[], node?: string): string;
27
+ //# sourceMappingURL=compose.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/utils/compose.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,wKAQpB,CAAC;AAYX,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAgBrE;AAqBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB5F"}