@tmhs/homelab-mcp 0.20.0 → 0.20.2
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.
- package/dist/index.js +1 -1
- package/dist/tools/certRenew.d.ts.map +1 -1
- package/dist/tools/certRenew.js +12 -6
- package/dist/tools/certRenew.js.map +1 -1
- package/dist/tools/inventorySync.js +2 -2
- package/dist/tools/inventorySync.js.map +1 -1
- package/dist/tools/logSearch.d.ts.map +1 -1
- package/dist/tools/logSearch.js +7 -3
- package/dist/tools/logSearch.js.map +1 -1
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -58,7 +58,7 @@ import { registerResources } from "./resources.js";
|
|
|
58
58
|
import { registerPrompts } from "./prompts.js";
|
|
59
59
|
const server = new McpServer({
|
|
60
60
|
name: "homelab-mcp",
|
|
61
|
-
version: "0.20.
|
|
61
|
+
version: "0.20.2",
|
|
62
62
|
});
|
|
63
63
|
registerPiStatus(server);
|
|
64
64
|
registerPiReboot(server);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"certRenew.d.ts","sourceRoot":"","sources":["../../src/tools/certRenew.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;
|
|
1
|
+
{"version":3,"file":"certRenew.d.ts","sourceRoot":"","sources":["../../src/tools/certRenew.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsChD"}
|
package/dist/tools/certRenew.js
CHANGED
|
@@ -8,19 +8,25 @@ const inputSchema = {
|
|
|
8
8
|
.string()
|
|
9
9
|
.optional()
|
|
10
10
|
.describe("Specific certificate name to renew. Renews all eligible certificates if omitted"),
|
|
11
|
+
force: z
|
|
12
|
+
.boolean()
|
|
13
|
+
.optional()
|
|
14
|
+
.default(false)
|
|
15
|
+
.describe("With domain: reissue even if the certificate is not due. Let's Encrypt allows only 5 duplicate " +
|
|
16
|
+
"certificates per week, so use it only when the current certificate is broken."),
|
|
11
17
|
...confirmParam,
|
|
12
18
|
};
|
|
13
|
-
function renewCommand(domain) {
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
19
|
+
function renewCommand(domain, force = false) {
|
|
20
|
+
if (!domain)
|
|
21
|
+
return "sudo certbot renew 2>&1";
|
|
22
|
+
return `sudo certbot renew --cert-name '${domain}'${force ? " --force-renewal" : ""} 2>&1`;
|
|
17
23
|
}
|
|
18
24
|
export function register(server) {
|
|
19
25
|
server.tool("homelab_certRenew", "Trigger Let's Encrypt certificate renewal via certbot", inputSchema, async (args) => {
|
|
20
26
|
if (!args.confirm) {
|
|
21
27
|
return confirmCancelled("Renewal", {
|
|
22
28
|
node: args.node,
|
|
23
|
-
commands: () => [renewCommand(args.domain)],
|
|
29
|
+
commands: () => [renewCommand(args.domain, args.force)],
|
|
24
30
|
note: "It first checks that certbot is installed.",
|
|
25
31
|
});
|
|
26
32
|
}
|
|
@@ -36,7 +42,7 @@ export function register(server) {
|
|
|
36
42
|
}],
|
|
37
43
|
};
|
|
38
44
|
}
|
|
39
|
-
const output = await execSSH(renewCommand(args.domain), args.node, { timeoutMs: TIMEOUTS.medium });
|
|
45
|
+
const output = await execSSH(renewCommand(args.domain, args.force), args.node, { timeoutMs: TIMEOUTS.medium });
|
|
40
46
|
return { content: [{ type: "text", text: output }] };
|
|
41
47
|
}
|
|
42
48
|
catch (error) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"certRenew.js","sourceRoot":"","sources":["../../src/tools/certRenew.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;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,GAAG,YAAY;CAChB,CAAC;AAEF,SAAS,YAAY,CAAC,MAAe;
|
|
1
|
+
{"version":3,"file":"certRenew.js","sourceRoot":"","sources":["../../src/tools/certRenew.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;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,iGAAiG;QAC/F,+EAA+E,CAClF;IACH,GAAG,YAAY;CAChB,CAAC;AAEF,SAAS,YAAY,CAAC,MAAe,EAAE,KAAK,GAAG,KAAK;IAClD,IAAI,CAAC,MAAM;QAAE,OAAO,yBAAyB,CAAC;IAC9C,OAAO,mCAAmC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,uDAAuD,EACvD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,SAAS,EAAE;gBACjC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvD,IAAI,EAAE,4CAA4C;aACnD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,OAAO,CAChC,0EAA0E,EAC1E,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,0DAA0D;gCAC9D,iCAAiC;gCACjC,kFAAkF;yBACrF,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/G,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,5 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import { execSSH, errorResponse } from "../utils/ssh-api.js";
|
|
2
|
+
import { execSSH, errorResponse, nodeSetting } from "../utils/ssh-api.js";
|
|
3
3
|
import { nodeParam } from "../utils/node-param.js";
|
|
4
4
|
const inputSchema = {
|
|
5
5
|
...nodeParam,
|
|
@@ -11,7 +11,7 @@ export function register(server) {
|
|
|
11
11
|
server.tool("homelab_inventorySync", "Discover nodes from Ansible inventory or Tailscale network", inputSchema, async (args) => {
|
|
12
12
|
try {
|
|
13
13
|
if (args.source === "ansible") {
|
|
14
|
-
const inventoryPath =
|
|
14
|
+
const inventoryPath = nodeSetting(args.node, "HOMELAB_ANSIBLE_INVENTORY") || "/etc/ansible/hosts";
|
|
15
15
|
const cmd = `test -f '${inventoryPath}' && cat '${inventoryPath}' || echo 'Inventory file not found at ${inventoryPath}. Set HOMELAB_ANSIBLE_INVENTORY to the correct path.'`;
|
|
16
16
|
const output = await execSSH(cmd, args.node);
|
|
17
17
|
return {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"inventorySync.js","sourceRoot":"","sources":["../../src/tools/inventorySync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"inventorySync.js","sourceRoot":"","sources":["../../src/tools/inventorySync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;SAC9B,QAAQ,CAAC,uFAAuF,CAAC;CACrG,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,4DAA4D,EAC5D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,aAAa,GACjB,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,CAAC,IAAI,oBAAoB,CAAC;gBAC9E,MAAM,GAAG,GACP,YAAY,aAAa,aAAa,aAAa,0CAA0C,aAAa,uDAAuD,CAAC;gBACpK,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7C,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,0BAA0B,aAAa,UAAU,MAAM,EAAE;yBAChE,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GACP,oHAAoH,CAAC;YACvH,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,4BAA4B,MAAM,EAAE;qBAC3C,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":"logSearch.d.ts","sourceRoot":"","sources":["../../src/tools/logSearch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,
|
|
1
|
+
{"version":3,"file":"logSearch.d.ts","sourceRoot":"","sources":["../../src/tools/logSearch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+BhD"}
|
package/dist/tools/logSearch.js
CHANGED
|
@@ -27,14 +27,18 @@ const inputSchema = {
|
|
|
27
27
|
export function register(server) {
|
|
28
28
|
server.tool("homelab_logSearch", "Search across Docker container logs with grep patterns", inputSchema, async (args) => {
|
|
29
29
|
try {
|
|
30
|
-
|
|
30
|
+
// The pattern travels base64-encoded and is decoded on the node, so
|
|
31
|
+
// search text such as "poweroff" is data for grep, not part of the
|
|
32
|
+
// command line the command guard inspects, and needs no shell quoting.
|
|
33
|
+
const encoded = Buffer.from(args.pattern, "utf8").toString("base64");
|
|
34
|
+
const pat = `pat=$(printf '%s' '${encoded}' | base64 -d)`;
|
|
31
35
|
// Bound the work: only read logs inside the time window instead of
|
|
32
36
|
// every container's full history. -e keeps patterns that start with
|
|
33
37
|
// "-" from being parsed as grep options.
|
|
34
38
|
const since = `--since ${toDockerSince(args.since)}`;
|
|
35
39
|
const cmd = args.service
|
|
36
|
-
?
|
|
37
|
-
:
|
|
40
|
+
? `${pat}; docker logs ${since} '${args.service}' 2>&1 | grep -i -e "$pat" | tail -${args.lines}`
|
|
41
|
+
: `${pat}; docker ps --format '{{.Names}}' | while read name; do matches=$(docker logs ${since} "$name" 2>&1 | grep -i -e "$pat" | tail -${args.lines}); if [ -n "$matches" ]; then echo "=== $name ==="; echo "$matches"; echo; fi; done`;
|
|
38
42
|
const output = await execSSH(cmd, args.node, { timeoutMs: TIMEOUTS.medium });
|
|
39
43
|
return {
|
|
40
44
|
content: [{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"logSearch.js","sourceRoot":"","sources":["../../src/tools/logSearch.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,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;IACnF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,qEAAqE,CAAC;IAClF,KAAK,EAAE,WAAW,CAChB,mFAAmF,CACpF;SACE,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;CAClB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,wDAAwD,EACxD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"logSearch.js","sourceRoot":"","sources":["../../src/tools/logSearch.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,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;IACnF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,qEAAqE,CAAC;IAClF,KAAK,EAAE,WAAW,CAChB,mFAAmF,CACpF;SACE,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;CAClB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,wDAAwD,EACxD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,oEAAoE;YACpE,mEAAmE;YACnE,uEAAuE;YACvE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrE,MAAM,GAAG,GAAG,sBAAsB,OAAO,gBAAgB,CAAC;YAC1D,mEAAmE;YACnE,oEAAoE;YACpE,yCAAyC;YACzC,MAAM,KAAK,GAAG,WAAW,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO;gBACtB,CAAC,CAAC,GAAG,GAAG,iBAAiB,KAAK,KAAK,IAAI,CAAC,OAAO,sCAAsC,IAAI,CAAC,KAAK,EAAE;gBACjG,CAAC,CAAC,GAAG,GAAG,iFAAiF,KAAK,6CAA6C,IAAI,CAAC,KAAK,qFAAqF,CAAC;YAC7O,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7E,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,IAAI,iCAAiC,IAAI,CAAC,OAAO,iBAAiB,IAAI,CAAC,KAAK,GAAG;qBAC5F,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tmhs/homelab-mcp",
|
|
3
|
-
"version": "0.20.
|
|
3
|
+
"version": "0.20.2",
|
|
4
4
|
"description": "MCP server for home lab operations via SSH - 53 tools for system status, Docker Compose management, service health, monitoring, DNS, reverse proxy, networking, backups, disaster recovery, security auditing, logs, notifications, OS management, certificates, multi-node, diagnostics, and administration on a Raspberry Pi.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|