@tmhs/homelab-mcp 0.16.1 → 0.17.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.
- package/README.md +13 -1
- package/dist/index.js +7 -1
- package/dist/index.js.map +1 -1
- package/dist/prompts.d.ts +6 -0
- package/dist/prompts.d.ts.map +1 -0
- package/dist/prompts.js +74 -0
- package/dist/prompts.js.map +1 -0
- package/dist/resources.d.ts +8 -0
- package/dist/resources.d.ts.map +1 -0
- package/dist/resources.js +23 -0
- package/dist/resources.js.map +1 -0
- package/dist/tools/adguardFilterToggle.d.ts +22 -0
- package/dist/tools/adguardFilterToggle.d.ts.map +1 -0
- package/dist/tools/adguardFilterToggle.js +79 -0
- package/dist/tools/adguardFilterToggle.js.map +1 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Home Lab MCP Server
|
|
2
2
|
|
|
3
|
-
MCP (Model Context Protocol) server for home lab operations. Connects to a Raspberry Pi (or multiple nodes) via SSH and provides
|
|
3
|
+
MCP (Model Context Protocol) server for home lab operations. Connects to a Raspberry Pi (or multiple nodes) via SSH and provides 51 tools for system management, Docker Compose stacks, service monitoring, networking, backups, disaster recovery, security auditing, log analysis, notifications, OS management, certificate lifecycle, multi-node management, and diagnostics. All tools accept an optional `node` parameter to target specific nodes.
|
|
4
4
|
|
|
5
5
|
## Tools
|
|
6
6
|
|
|
@@ -32,6 +32,7 @@ MCP (Model Context Protocol) server for home lab operations. Connects to a Raspb
|
|
|
32
32
|
| DNS/Proxy | `homelab_adguardStats` | AdGuard Home DNS statistics |
|
|
33
33
|
| DNS/Proxy | `homelab_adguardFilters` | List AdGuard filter lists and status |
|
|
34
34
|
| DNS/Proxy | `homelab_adguardQueryLog` | Search AdGuard DNS query log |
|
|
35
|
+
| DNS/Proxy | `homelab_adguardFilterToggle` | Enable or disable an AdGuard filter list (requires confirm=true) |
|
|
35
36
|
| DNS/Proxy | `homelab_npmProxyHosts` | List NPM proxy host configs |
|
|
36
37
|
| DNS/Proxy | `homelab_npmCerts` | List SSL certificates and expiry |
|
|
37
38
|
| Security | `homelab_ufwStatus` | List UFW firewall rules and status |
|
|
@@ -101,6 +102,17 @@ Set environment variables:
|
|
|
101
102
|
| `HOMELAB_NTFY_TOPICS` | (unset) | Default topic list (comma-separated) for `homelab_ntfyTopics` when no `topic` is passed |
|
|
102
103
|
| `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 |
|
|
103
104
|
|
|
105
|
+
## Resources and Prompts
|
|
106
|
+
|
|
107
|
+
Besides tools, the server exposes MCP resources and prompts, so any MCP client gets guided workflows.
|
|
108
|
+
|
|
109
|
+
| Kind | Name | Description |
|
|
110
|
+
|------|------|-------------|
|
|
111
|
+
| Resource | `homelab://nodes` | Managed nodes (name and host only) from `HOMELAB_PI_HOST` and `HOMELAB_NODES` |
|
|
112
|
+
| Prompt | `morning-health-check` | Read-only daily check: hardware, containers, active alerts, backups, disk. Optional `node` |
|
|
113
|
+
| Prompt | `pre-reboot-checklist` | Gathers state, backups and pending updates before a reboot; never reboots on its own. Optional `node` |
|
|
114
|
+
| Prompt | `investigate-container` | Status, logs and error search for one container with a proposed fix. Requires `service`, optional `node` |
|
|
115
|
+
|
|
104
116
|
## Usage with Cursor
|
|
105
117
|
|
|
106
118
|
Add to `.cursor/mcp.json`:
|
package/dist/index.js
CHANGED
|
@@ -24,6 +24,7 @@ import { register as registerSpeedtestResults } from "./tools/speedtestResults.j
|
|
|
24
24
|
import { register as registerAdguardStats } from "./tools/adguardStats.js";
|
|
25
25
|
import { register as registerAdguardFilters } from "./tools/adguardFilters.js";
|
|
26
26
|
import { register as registerAdguardQueryLog } from "./tools/adguardQueryLog.js";
|
|
27
|
+
import { register as registerAdguardFilterToggle } from "./tools/adguardFilterToggle.js";
|
|
27
28
|
import { register as registerNpmProxyHosts } from "./tools/npmProxyHosts.js";
|
|
28
29
|
import { register as registerNpmCerts } from "./tools/npmCerts.js";
|
|
29
30
|
import { register as registerBackupList } from "./tools/backupList.js";
|
|
@@ -51,9 +52,11 @@ import { register as registerNodeStatus } from "./tools/nodeStatus.js";
|
|
|
51
52
|
import { register as registerInventorySync } from "./tools/inventorySync.js";
|
|
52
53
|
import { register as registerHealthCheck } from "./tools/healthCheck.js";
|
|
53
54
|
import { register as registerDiagnostics } from "./tools/diagnostics.js";
|
|
55
|
+
import { registerResources } from "./resources.js";
|
|
56
|
+
import { registerPrompts } from "./prompts.js";
|
|
54
57
|
const server = new McpServer({
|
|
55
58
|
name: "homelab-mcp",
|
|
56
|
-
version: "0.
|
|
59
|
+
version: "0.17.0",
|
|
57
60
|
});
|
|
58
61
|
registerPiStatus(server);
|
|
59
62
|
registerPiReboot(server);
|
|
@@ -78,6 +81,7 @@ registerSpeedtestResults(server);
|
|
|
78
81
|
registerAdguardStats(server);
|
|
79
82
|
registerAdguardFilters(server);
|
|
80
83
|
registerAdguardQueryLog(server);
|
|
84
|
+
registerAdguardFilterToggle(server);
|
|
81
85
|
registerNpmProxyHosts(server);
|
|
82
86
|
registerNpmCerts(server);
|
|
83
87
|
registerBackupList(server);
|
|
@@ -105,6 +109,8 @@ registerNodeStatus(server);
|
|
|
105
109
|
registerInventorySync(server);
|
|
106
110
|
registerHealthCheck(server);
|
|
107
111
|
registerDiagnostics(server);
|
|
112
|
+
registerResources(server);
|
|
113
|
+
registerPrompts(server);
|
|
108
114
|
async function main() {
|
|
109
115
|
const transport = new StdioServerTransport();
|
|
110
116
|
await server.connect(transport);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAC;AAEH,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AAExB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
export declare function morningHealthCheckText(node?: string): string;
|
|
3
|
+
export declare function preRebootChecklistText(node?: string): string;
|
|
4
|
+
export declare function investigateContainerText(service: string, node?: string): string;
|
|
5
|
+
export declare function registerPrompts(server: McpServer): void;
|
|
6
|
+
//# sourceMappingURL=prompts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAa/E;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiCvD"}
|
package/dist/prompts.js
ADDED
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
/**
|
|
3
|
+
* MCP prompts: guided workflows built from the skills, available to any MCP
|
|
4
|
+
* client (not only Cursor / Claude Code plugin users).
|
|
5
|
+
*/
|
|
6
|
+
function nodeClause(node) {
|
|
7
|
+
return node ? ` Pass \`node: "${node}"\` to every tool call.` : "";
|
|
8
|
+
}
|
|
9
|
+
function userMessage(text) {
|
|
10
|
+
return { messages: [{ role: "user", content: { type: "text", text } }] };
|
|
11
|
+
}
|
|
12
|
+
export function morningHealthCheckText(node) {
|
|
13
|
+
return [
|
|
14
|
+
`Run a morning health check of my home lab.${nodeClause(node)}`,
|
|
15
|
+
"",
|
|
16
|
+
"1. Call `homelab_piStatus` for temperature, throttling, memory, disk and uptime.",
|
|
17
|
+
"2. Call `homelab_serviceHealth` and list any container that is unhealthy, restarting or exited.",
|
|
18
|
+
"3. Call `homelab_alertList` with `state: \"active\"` for firing alerts.",
|
|
19
|
+
"4. Call `homelab_backupStatus` and check that the latest snapshot is recent.",
|
|
20
|
+
"5. Call `homelab_diskUsage` if any filesystem is above 80% used.",
|
|
21
|
+
"",
|
|
22
|
+
"Summarize in a short report: OK items in one line, then each problem with its likely cause and a suggested next step.",
|
|
23
|
+
"Read-only: do not restart, upgrade or change anything.",
|
|
24
|
+
].join("\n");
|
|
25
|
+
}
|
|
26
|
+
export function preRebootChecklistText(node) {
|
|
27
|
+
return [
|
|
28
|
+
`Prepare a pre-reboot checklist for the Pi.${nodeClause(node)}`,
|
|
29
|
+
"",
|
|
30
|
+
"1. Call `homelab_piStatus` and `homelab_serviceHealth` to record the current state.",
|
|
31
|
+
"2. Call `homelab_backupStatus` and confirm a recent snapshot exists.",
|
|
32
|
+
"3. Call `homelab_kernelInfo` and `homelab_aptUpgradable` to see whether a kernel or package update is pending.",
|
|
33
|
+
"4. Call `homelab_systemdServices` for failed units that might not come back cleanly.",
|
|
34
|
+
"",
|
|
35
|
+
"List the risks and the containers that will restart. Do not call `homelab_piReboot`;",
|
|
36
|
+
"only reboot if I explicitly confirm afterwards (it requires `confirm: true`).",
|
|
37
|
+
].join("\n");
|
|
38
|
+
}
|
|
39
|
+
export function investigateContainerText(service, node) {
|
|
40
|
+
return [
|
|
41
|
+
`Investigate the container "${service}".${nodeClause(node)}`,
|
|
42
|
+
"",
|
|
43
|
+
`1. Call \`homelab_serviceHealth\` with \`service: "${service}"\` for its status and health.`,
|
|
44
|
+
`2. Call \`homelab_serviceLogs\` with \`service: "${service}"\` and \`lines: 200\`.`,
|
|
45
|
+
`3. Call \`homelab_logSearch\` with \`service: "${service}"\` and \`pattern: "error"\` (adjust \`since\` if needed).`,
|
|
46
|
+
"4. Call `homelab_composePs` to see related containers and port mappings.",
|
|
47
|
+
"5. Call `homelab_piStatus` if the logs point at memory, disk or temperature pressure.",
|
|
48
|
+
"",
|
|
49
|
+
"Explain the most likely root cause and propose a fix. Do not restart or recreate anything",
|
|
50
|
+
"until I confirm (`homelab_serviceRestart` and `homelab_composeUp` require `confirm: true`).",
|
|
51
|
+
].join("\n");
|
|
52
|
+
}
|
|
53
|
+
const nodeArg = z.string().optional().describe("Target node name (default: primary Pi)");
|
|
54
|
+
export function registerPrompts(server) {
|
|
55
|
+
server.registerPrompt("morning-health-check", {
|
|
56
|
+
title: "Morning health check",
|
|
57
|
+
description: "Read-only daily check of hardware, containers, alerts, backups and disk",
|
|
58
|
+
argsSchema: { node: nodeArg },
|
|
59
|
+
}, ({ node }) => userMessage(morningHealthCheckText(node)));
|
|
60
|
+
server.registerPrompt("pre-reboot-checklist", {
|
|
61
|
+
title: "Pre-reboot checklist",
|
|
62
|
+
description: "Gather state, backups and pending updates before rebooting; never reboots by itself",
|
|
63
|
+
argsSchema: { node: nodeArg },
|
|
64
|
+
}, ({ node }) => userMessage(preRebootChecklistText(node)));
|
|
65
|
+
server.registerPrompt("investigate-container", {
|
|
66
|
+
title: "Investigate a failing container",
|
|
67
|
+
description: "Status, logs and error search for one container, with a proposed fix",
|
|
68
|
+
argsSchema: {
|
|
69
|
+
service: z.string().min(1).describe("Container name"),
|
|
70
|
+
node: nodeArg,
|
|
71
|
+
},
|
|
72
|
+
}, ({ service, node }) => userMessage(investigateContainerText(service, node)));
|
|
73
|
+
}
|
|
74
|
+
//# sourceMappingURL=prompts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AAEH,SAAS,UAAU,CAAC,IAAa;IAC/B,OAAO,IAAI,CAAC,CAAC,CAAC,kBAAkB,IAAI,yBAAyB,CAAC,CAAC,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAClD,OAAO;QACL,6CAA6C,UAAU,CAAC,IAAI,CAAC,EAAE;QAC/D,EAAE;QACF,kFAAkF;QAClF,iGAAiG;QACjG,yEAAyE;QACzE,8EAA8E;QAC9E,kEAAkE;QAClE,EAAE;QACF,uHAAuH;QACvH,wDAAwD;KACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAClD,OAAO;QACL,6CAA6C,UAAU,CAAC,IAAI,CAAC,EAAE;QAC/D,EAAE;QACF,qFAAqF;QACrF,sEAAsE;QACtE,gHAAgH;QAChH,sFAAsF;QACtF,EAAE;QACF,sFAAsF;QACtF,+EAA+E;KAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,IAAa;IACrE,OAAO;QACL,8BAA8B,OAAO,KAAK,UAAU,CAAC,IAAI,CAAC,EAAE;QAC5D,EAAE;QACF,sDAAsD,OAAO,gCAAgC;QAC7F,oDAAoD,OAAO,yBAAyB;QACpF,kDAAkD,OAAO,4DAA4D;QACrH,0EAA0E;QAC1E,uFAAuF;QACvF,EAAE;QACF,2FAA2F;QAC3F,6FAA6F;KAC9F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AAEzF,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,yEAAyE;QACtF,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;KAC9B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CACxD,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,qFAAqF;QAClG,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;KAC9B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CACxD,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,uBAAuB,EACvB;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EAAE,sEAAsE;QACnF,UAAU,EAAE;YACV,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACrD,IAAI,EAAE,OAAO;SACd;KACF,EACD,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAC5E,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
export declare const NODES_URI = "homelab://nodes";
|
|
3
|
+
/**
|
|
4
|
+
* MCP resources. Only non-secret data is exposed: node names and hosts,
|
|
5
|
+
* never usernames, key paths, or per-node env overrides.
|
|
6
|
+
*/
|
|
7
|
+
export declare function registerResources(server: McpServer): void;
|
|
8
|
+
//# sourceMappingURL=resources.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,eAAO,MAAM,SAAS,oBAAoB,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBzD"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { listNodes } from "./utils/ssh-api.js";
|
|
2
|
+
export const NODES_URI = "homelab://nodes";
|
|
3
|
+
/**
|
|
4
|
+
* MCP resources. Only non-secret data is exposed: node names and hosts,
|
|
5
|
+
* never usernames, key paths, or per-node env overrides.
|
|
6
|
+
*/
|
|
7
|
+
export function registerResources(server) {
|
|
8
|
+
server.registerResource("nodes", NODES_URI, {
|
|
9
|
+
title: "Home lab nodes",
|
|
10
|
+
description: "Managed nodes (name and host) from HOMELAB_PI_HOST and HOMELAB_NODES",
|
|
11
|
+
mimeType: "application/json",
|
|
12
|
+
}, async (uri) => {
|
|
13
|
+
let text;
|
|
14
|
+
try {
|
|
15
|
+
text = JSON.stringify({ nodes: listNodes() }, null, 2);
|
|
16
|
+
}
|
|
17
|
+
catch (error) {
|
|
18
|
+
text = JSON.stringify({ error: error instanceof Error ? error.message : String(error) }, null, 2);
|
|
19
|
+
}
|
|
20
|
+
return { contents: [{ uri: uri.href, mimeType: "application/json", text }] };
|
|
21
|
+
});
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=resources.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,CAAC,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,SAAS,EACT;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,sEAAsE;QACnF,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACpG,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/E,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
interface AdguardFilter {
|
|
3
|
+
url: string;
|
|
4
|
+
name: string;
|
|
5
|
+
enabled: boolean;
|
|
6
|
+
}
|
|
7
|
+
interface FilteringStatus {
|
|
8
|
+
filters?: AdguardFilter[] | null;
|
|
9
|
+
whitelist_filters?: AdguardFilter[] | null;
|
|
10
|
+
}
|
|
11
|
+
/** Wrap a value in single quotes for the remote shell. */
|
|
12
|
+
export declare function shellQuote(value: string): string;
|
|
13
|
+
/** Find a filter (blocklist or allowlist) by its exact URL. */
|
|
14
|
+
export declare function findFilter(status: FilteringStatus, url: string): {
|
|
15
|
+
filter: AdguardFilter;
|
|
16
|
+
whitelist: boolean;
|
|
17
|
+
} | null;
|
|
18
|
+
/** Request body for AdGuard Home's POST /control/filtering/set_url. */
|
|
19
|
+
export declare function buildSetUrlPayload(filter: AdguardFilter, whitelist: boolean, enabled: boolean): string;
|
|
20
|
+
export declare function register(server: McpServer): void;
|
|
21
|
+
export {};
|
|
22
|
+
//# sourceMappingURL=adguardFilterToggle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adguardFilterToggle.d.ts","sourceRoot":"","sources":["../../src/tools/adguardFilterToggle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;CAC5C;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CACxB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,GACV;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAMtD;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAMtG;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuDhD"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { execSSH, errorResponse } from "../utils/ssh-api.js";
|
|
3
|
+
import { nodeParam } from "../utils/node-param.js";
|
|
4
|
+
import { confirmParam, confirmCancelled } from "../utils/confirm-param.js";
|
|
5
|
+
import { SERVICES, servicePort, adguardAuth, curlErrorResponse } from "../utils/service-http.js";
|
|
6
|
+
const SERVICE = SERVICES.adguard;
|
|
7
|
+
const inputSchema = {
|
|
8
|
+
...nodeParam,
|
|
9
|
+
url: z
|
|
10
|
+
.string()
|
|
11
|
+
.min(1)
|
|
12
|
+
.max(2048)
|
|
13
|
+
.describe("URL (or path) of an existing filter list, exactly as shown by homelab_adguardFilters"),
|
|
14
|
+
enabled: z.boolean().describe("true to enable the filter list, false to disable it"),
|
|
15
|
+
...confirmParam,
|
|
16
|
+
};
|
|
17
|
+
/** Wrap a value in single quotes for the remote shell. */
|
|
18
|
+
export function shellQuote(value) {
|
|
19
|
+
return `'${value.replace(/'/g, "'\\''")}'`;
|
|
20
|
+
}
|
|
21
|
+
/** Find a filter (blocklist or allowlist) by its exact URL. */
|
|
22
|
+
export function findFilter(status, url) {
|
|
23
|
+
const block = (status.filters ?? []).find((f) => f.url === url);
|
|
24
|
+
if (block)
|
|
25
|
+
return { filter: block, whitelist: false };
|
|
26
|
+
const allow = (status.whitelist_filters ?? []).find((f) => f.url === url);
|
|
27
|
+
if (allow)
|
|
28
|
+
return { filter: allow, whitelist: true };
|
|
29
|
+
return null;
|
|
30
|
+
}
|
|
31
|
+
/** Request body for AdGuard Home's POST /control/filtering/set_url. */
|
|
32
|
+
export function buildSetUrlPayload(filter, whitelist, enabled) {
|
|
33
|
+
return JSON.stringify({
|
|
34
|
+
url: filter.url,
|
|
35
|
+
whitelist,
|
|
36
|
+
data: { name: filter.name, url: filter.url, enabled },
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
export function register(server) {
|
|
40
|
+
server.tool("homelab_adguardFilterToggle", "Enable or disable an existing AdGuard Home filter list by URL (requires confirm=true)", inputSchema, async (args) => {
|
|
41
|
+
if (!args.confirm) {
|
|
42
|
+
return confirmCancelled("Filter toggle");
|
|
43
|
+
}
|
|
44
|
+
let port = SERVICE.defaultPort;
|
|
45
|
+
try {
|
|
46
|
+
port = servicePort(SERVICE, args.node);
|
|
47
|
+
const auth = adguardAuth(args.node);
|
|
48
|
+
const base = `http://localhost:${port}/control/filtering`;
|
|
49
|
+
const statusOutput = await execSSH(`curl -sf ${auth} '${base}/status'`, args.node);
|
|
50
|
+
const status = JSON.parse(statusOutput);
|
|
51
|
+
const match = findFilter(status, args.url);
|
|
52
|
+
if (!match) {
|
|
53
|
+
return errorResponse(new Error(`No AdGuard filter list with URL "${args.url}". ` +
|
|
54
|
+
"Use homelab_adguardFilters to list the configured URLs."));
|
|
55
|
+
}
|
|
56
|
+
const { filter, whitelist } = match;
|
|
57
|
+
const state = args.enabled ? "enabled" : "disabled";
|
|
58
|
+
if (filter.enabled === args.enabled) {
|
|
59
|
+
return {
|
|
60
|
+
content: [{ type: "text", text: `Filter "${filter.name}" (${filter.url}) is already ${state}.` }],
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
const payload = buildSetUrlPayload(filter, whitelist, args.enabled);
|
|
64
|
+
await execSSH(`curl -sf ${auth} -X POST -H 'Content-Type: application/json' ` +
|
|
65
|
+
`-d ${shellQuote(payload)} '${base}/set_url'`, args.node);
|
|
66
|
+
return {
|
|
67
|
+
content: [{
|
|
68
|
+
type: "text",
|
|
69
|
+
text: `Filter "${filter.name}" (${filter.url}) ${state}.` +
|
|
70
|
+
(whitelist ? " (allowlist)" : ""),
|
|
71
|
+
}],
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
catch (error) {
|
|
75
|
+
return curlErrorResponse(error, SERVICE, port);
|
|
76
|
+
}
|
|
77
|
+
});
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=adguardFilterToggle.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adguardFilterToggle.js","sourceRoot":"","sources":["../../src/tools/adguardFilterToggle.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tmhs/homelab-mcp",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "MCP server for home lab operations via SSH -
|
|
3
|
+
"version": "0.17.0",
|
|
4
|
+
"description": "MCP server for home lab operations via SSH - 51 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",
|
|
7
7
|
"bin": {
|