proxmox-mcps 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (217) hide show
  1. package/.env.example +60 -0
  2. package/.mcp.json.example +19 -0
  3. package/LICENSE +21 -0
  4. package/README.md +72 -0
  5. package/dist/cli/check-config.d.ts +3 -0
  6. package/dist/cli/check-config.d.ts.map +1 -0
  7. package/dist/cli/check-config.js +29 -0
  8. package/dist/cli/check-config.js.map +1 -0
  9. package/dist/cli/print-tools.d.ts +4 -0
  10. package/dist/cli/print-tools.d.ts.map +1 -0
  11. package/dist/cli/print-tools.js +45 -0
  12. package/dist/cli/print-tools.js.map +1 -0
  13. package/dist/config/env.d.ts +183 -0
  14. package/dist/config/env.d.ts.map +1 -0
  15. package/dist/config/env.js +149 -0
  16. package/dist/config/env.js.map +1 -0
  17. package/dist/config/index.d.ts +26 -0
  18. package/dist/config/index.d.ts.map +1 -0
  19. package/dist/config/index.js +42 -0
  20. package/dist/config/index.js.map +1 -0
  21. package/dist/config/types.d.ts +60 -0
  22. package/dist/config/types.d.ts.map +1 -0
  23. package/dist/config/types.js +50 -0
  24. package/dist/config/types.js.map +1 -0
  25. package/dist/format/response.d.ts +40 -0
  26. package/dist/format/response.d.ts.map +1 -0
  27. package/dist/format/response.js +109 -0
  28. package/dist/format/response.js.map +1 -0
  29. package/dist/index.d.ts +3 -0
  30. package/dist/index.d.ts.map +1 -0
  31. package/dist/index.js +200 -0
  32. package/dist/index.js.map +1 -0
  33. package/dist/jobs/sqlite-store.d.ts +34 -0
  34. package/dist/jobs/sqlite-store.d.ts.map +1 -0
  35. package/dist/jobs/sqlite-store.js +282 -0
  36. package/dist/jobs/sqlite-store.js.map +1 -0
  37. package/dist/jobs/store.d.ts +66 -0
  38. package/dist/jobs/store.d.ts.map +1 -0
  39. package/dist/jobs/store.js +101 -0
  40. package/dist/jobs/store.js.map +1 -0
  41. package/dist/log.d.ts +24 -0
  42. package/dist/log.d.ts.map +1 -0
  43. package/dist/log.js +64 -0
  44. package/dist/log.js.map +1 -0
  45. package/dist/proxmox/auth.d.ts +30 -0
  46. package/dist/proxmox/auth.d.ts.map +1 -0
  47. package/dist/proxmox/auth.js +39 -0
  48. package/dist/proxmox/auth.js.map +1 -0
  49. package/dist/proxmox/client.d.ts +28 -0
  50. package/dist/proxmox/client.d.ts.map +1 -0
  51. package/dist/proxmox/client.js +192 -0
  52. package/dist/proxmox/client.js.map +1 -0
  53. package/dist/proxmox/errors.d.ts +51 -0
  54. package/dist/proxmox/errors.d.ts.map +1 -0
  55. package/dist/proxmox/errors.js +80 -0
  56. package/dist/proxmox/errors.js.map +1 -0
  57. package/dist/proxmox/paths.d.ts +126 -0
  58. package/dist/proxmox/paths.d.ts.map +1 -0
  59. package/dist/proxmox/paths.js +157 -0
  60. package/dist/proxmox/paths.js.map +1 -0
  61. package/dist/proxmox/types.d.ts +255 -0
  62. package/dist/proxmox/types.d.ts.map +1 -0
  63. package/dist/proxmox/types.js +9 -0
  64. package/dist/proxmox/types.js.map +1 -0
  65. package/dist/retry.d.ts +18 -0
  66. package/dist/retry.d.ts.map +1 -0
  67. package/dist/retry.js +50 -0
  68. package/dist/retry.js.map +1 -0
  69. package/dist/safety/policy.d.ts +23 -0
  70. package/dist/safety/policy.d.ts.map +1 -0
  71. package/dist/safety/policy.js +81 -0
  72. package/dist/safety/policy.js.map +1 -0
  73. package/dist/safety/risk.d.ts +3 -0
  74. package/dist/safety/risk.d.ts.map +1 -0
  75. package/dist/safety/risk.js +234 -0
  76. package/dist/safety/risk.js.map +1 -0
  77. package/dist/security/url-guard.d.ts +22 -0
  78. package/dist/security/url-guard.d.ts.map +1 -0
  79. package/dist/security/url-guard.js +166 -0
  80. package/dist/security/url-guard.js.map +1 -0
  81. package/dist/server.d.ts +24 -0
  82. package/dist/server.d.ts.map +1 -0
  83. package/dist/server.js +74 -0
  84. package/dist/server.js.map +1 -0
  85. package/dist/ssh/client.d.ts +32 -0
  86. package/dist/ssh/client.d.ts.map +1 -0
  87. package/dist/ssh/client.js +128 -0
  88. package/dist/ssh/client.js.map +1 -0
  89. package/dist/tools/backup-schedule.d.ts +10 -0
  90. package/dist/tools/backup-schedule.d.ts.map +1 -0
  91. package/dist/tools/backup-schedule.js +194 -0
  92. package/dist/tools/backup-schedule.js.map +1 -0
  93. package/dist/tools/backup.d.ts +7 -0
  94. package/dist/tools/backup.d.ts.map +1 -0
  95. package/dist/tools/backup.js +163 -0
  96. package/dist/tools/backup.js.map +1 -0
  97. package/dist/tools/cluster.d.ts +7 -0
  98. package/dist/tools/cluster.d.ts.map +1 -0
  99. package/dist/tools/cluster.js +20 -0
  100. package/dist/tools/cluster.js.map +1 -0
  101. package/dist/tools/container/config.d.ts +7 -0
  102. package/dist/tools/container/config.d.ts.map +1 -0
  103. package/dist/tools/container/config.js +97 -0
  104. package/dist/tools/container/config.js.map +1 -0
  105. package/dist/tools/container/console.d.ts +7 -0
  106. package/dist/tools/container/console.d.ts.map +1 -0
  107. package/dist/tools/container/console.js +65 -0
  108. package/dist/tools/container/console.js.map +1 -0
  109. package/dist/tools/container/crud.d.ts +7 -0
  110. package/dist/tools/container/crud.d.ts.map +1 -0
  111. package/dist/tools/container/crud.js +362 -0
  112. package/dist/tools/container/crud.js.map +1 -0
  113. package/dist/tools/container/diagnostics.d.ts +7 -0
  114. package/dist/tools/container/diagnostics.d.ts.map +1 -0
  115. package/dist/tools/container/diagnostics.js +115 -0
  116. package/dist/tools/container/diagnostics.js.map +1 -0
  117. package/dist/tools/container/migration.d.ts +7 -0
  118. package/dist/tools/container/migration.d.ts.map +1 -0
  119. package/dist/tools/container/migration.js +134 -0
  120. package/dist/tools/container/migration.js.map +1 -0
  121. package/dist/tools/context.d.ts +21 -0
  122. package/dist/tools/context.d.ts.map +1 -0
  123. package/dist/tools/context.js +2 -0
  124. package/dist/tools/context.js.map +1 -0
  125. package/dist/tools/ha.d.ts +7 -0
  126. package/dist/tools/ha.d.ts.map +1 -0
  127. package/dist/tools/ha.js +241 -0
  128. package/dist/tools/ha.js.map +1 -0
  129. package/dist/tools/helpers.d.ts +15 -0
  130. package/dist/tools/helpers.d.ts.map +1 -0
  131. package/dist/tools/helpers.js +7 -0
  132. package/dist/tools/helpers.js.map +1 -0
  133. package/dist/tools/index.d.ts +10 -0
  134. package/dist/tools/index.d.ts.map +1 -0
  135. package/dist/tools/index.js +66 -0
  136. package/dist/tools/index.js.map +1 -0
  137. package/dist/tools/iso.d.ts +7 -0
  138. package/dist/tools/iso.d.ts.map +1 -0
  139. package/dist/tools/iso.js +131 -0
  140. package/dist/tools/iso.js.map +1 -0
  141. package/dist/tools/jobs.d.ts +11 -0
  142. package/dist/tools/jobs.d.ts.map +1 -0
  143. package/dist/tools/jobs.js +173 -0
  144. package/dist/tools/jobs.js.map +1 -0
  145. package/dist/tools/node-admin.d.ts +10 -0
  146. package/dist/tools/node-admin.d.ts.map +1 -0
  147. package/dist/tools/node-admin.js +361 -0
  148. package/dist/tools/node-admin.js.map +1 -0
  149. package/dist/tools/node-certs.d.ts +7 -0
  150. package/dist/tools/node-certs.d.ts.map +1 -0
  151. package/dist/tools/node-certs.js +36 -0
  152. package/dist/tools/node-certs.js.map +1 -0
  153. package/dist/tools/node-disks.d.ts +7 -0
  154. package/dist/tools/node-disks.d.ts.map +1 -0
  155. package/dist/tools/node-disks.js +100 -0
  156. package/dist/tools/node-disks.js.map +1 -0
  157. package/dist/tools/node-network.d.ts +7 -0
  158. package/dist/tools/node-network.d.ts.map +1 -0
  159. package/dist/tools/node-network.js +102 -0
  160. package/dist/tools/node-network.js.map +1 -0
  161. package/dist/tools/node-services.d.ts +7 -0
  162. package/dist/tools/node-services.d.ts.map +1 -0
  163. package/dist/tools/node-services.js +39 -0
  164. package/dist/tools/node-services.js.map +1 -0
  165. package/dist/tools/node.d.ts +7 -0
  166. package/dist/tools/node.d.ts.map +1 -0
  167. package/dist/tools/node.js +85 -0
  168. package/dist/tools/node.js.map +1 -0
  169. package/dist/tools/pools.d.ts +10 -0
  170. package/dist/tools/pools.d.ts.map +1 -0
  171. package/dist/tools/pools.js +111 -0
  172. package/dist/tools/pools.js.map +1 -0
  173. package/dist/tools/replication.d.ts +7 -0
  174. package/dist/tools/replication.d.ts.map +1 -0
  175. package/dist/tools/replication.js +116 -0
  176. package/dist/tools/replication.js.map +1 -0
  177. package/dist/tools/sdn.d.ts +7 -0
  178. package/dist/tools/sdn.d.ts.map +1 -0
  179. package/dist/tools/sdn.js +358 -0
  180. package/dist/tools/sdn.js.map +1 -0
  181. package/dist/tools/snapshot.d.ts +10 -0
  182. package/dist/tools/snapshot.d.ts.map +1 -0
  183. package/dist/tools/snapshot.js +115 -0
  184. package/dist/tools/snapshot.js.map +1 -0
  185. package/dist/tools/storage-admin.d.ts +9 -0
  186. package/dist/tools/storage-admin.d.ts.map +1 -0
  187. package/dist/tools/storage-admin.js +126 -0
  188. package/dist/tools/storage-admin.js.map +1 -0
  189. package/dist/tools/storage.d.ts +7 -0
  190. package/dist/tools/storage.d.ts.map +1 -0
  191. package/dist/tools/storage.js +20 -0
  192. package/dist/tools/storage.js.map +1 -0
  193. package/dist/tools/tasks.d.ts +11 -0
  194. package/dist/tools/tasks.d.ts.map +1 -0
  195. package/dist/tools/tasks.js +85 -0
  196. package/dist/tools/tasks.js.map +1 -0
  197. package/dist/tools/vm/config.d.ts +28 -0
  198. package/dist/tools/vm/config.d.ts.map +1 -0
  199. package/dist/tools/vm/config.js +221 -0
  200. package/dist/tools/vm/config.js.map +1 -0
  201. package/dist/tools/vm/console.d.ts +9 -0
  202. package/dist/tools/vm/console.d.ts.map +1 -0
  203. package/dist/tools/vm/console.js +141 -0
  204. package/dist/tools/vm/console.js.map +1 -0
  205. package/dist/tools/vm/crud.d.ts +10 -0
  206. package/dist/tools/vm/crud.d.ts.map +1 -0
  207. package/dist/tools/vm/crud.js +333 -0
  208. package/dist/tools/vm/crud.js.map +1 -0
  209. package/dist/tools/vm/diagnostics.d.ts +10 -0
  210. package/dist/tools/vm/diagnostics.d.ts.map +1 -0
  211. package/dist/tools/vm/diagnostics.js +256 -0
  212. package/dist/tools/vm/diagnostics.js.map +1 -0
  213. package/dist/tools/vm/migration.d.ts +7 -0
  214. package/dist/tools/vm/migration.d.ts.map +1 -0
  215. package/dist/tools/vm/migration.js +131 -0
  216. package/dist/tools/vm/migration.js.map +1 -0
  217. package/package.json +74 -0
@@ -0,0 +1,128 @@
1
+ /**
2
+ * SshClient — thin wrapper around ssh2 for `pct exec` on container hosts.
3
+ *
4
+ * Used by `execute_container_command` to run shell commands inside an LXC
5
+ * container by shelling out to `pct exec <vmid> -- <cmd>` on the host.
6
+ */
7
+ import { Client } from "ssh2";
8
+ export class SshClient {
9
+ cfg;
10
+ resolveHost;
11
+ logger;
12
+ constructor(opts) {
13
+ this.cfg = opts.ssh;
14
+ this.resolveHost =
15
+ opts.resolveHost ??
16
+ ((node) => this.cfg.hostOverrides[node] ?? node);
17
+ this.logger = opts.logger;
18
+ }
19
+ /**
20
+ * Run `pct exec <vmid> -- <command>` on the host that owns the container.
21
+ *
22
+ * The command is executed via `sh -c` so shell features (pipes, redirects)
23
+ * work as expected.
24
+ */
25
+ async pctExec(node, vmid, command) {
26
+ const start = Date.now();
27
+ const host = this.resolveHost(node);
28
+ const fullCmd = `pct exec ${vmid} -- sh -c ${shellQuote(command)}`;
29
+ return new Promise((resolve, reject) => {
30
+ const connectCfg = {
31
+ host,
32
+ port: this.cfg.port,
33
+ username: this.cfg.user,
34
+ };
35
+ if (this.cfg.keyFile) {
36
+ connectCfg.privateKey = loadKeyFile(this.cfg.keyFile);
37
+ }
38
+ else if (this.cfg.password) {
39
+ connectCfg.password = this.cfg.password;
40
+ }
41
+ if (this.cfg.knownHostsFile) {
42
+ // ssh2 doesn't expose known_hosts loading directly; users typically
43
+ // set hostKey via PKCS#11 or accept any key. We skip strict checks
44
+ // unless the caller overrides via env.
45
+ connectCfg.tryKeyboard = false;
46
+ }
47
+ else if (!this.cfg.strictHostKeyChecking) {
48
+ connectCfg.tryKeyboard = false;
49
+ }
50
+ const conn = new Client();
51
+ let stdout = "";
52
+ let stderr = "";
53
+ let settled = false;
54
+ const settle = (fn) => {
55
+ if (settled)
56
+ return;
57
+ settled = true;
58
+ try {
59
+ conn.end();
60
+ }
61
+ catch {
62
+ // ignore
63
+ }
64
+ fn();
65
+ };
66
+ conn.on("ready", () => {
67
+ conn.exec(fullCmd, (err, channel) => {
68
+ if (err) {
69
+ this.logger?.error({ err: err.message, host, vmid, command }, "ssh.exec_failed");
70
+ settle(() => reject(new Error(`SSH exec failed: ${err.message}`)));
71
+ return;
72
+ }
73
+ channel.on("data", (data) => {
74
+ stdout += data.toString("utf8");
75
+ });
76
+ channel.stderr.on("data", (data) => {
77
+ stderr += data.toString("utf8");
78
+ });
79
+ channel.on("exit", (code) => {
80
+ const exitCode = code ?? 0;
81
+ const result = {
82
+ stdout,
83
+ stderr,
84
+ exitCode,
85
+ durationMs: Date.now() - start,
86
+ };
87
+ this.logger?.debug({ host, vmid, exitCode, durationMs: result.durationMs, stdoutLen: stdout.length }, "ssh.exec_done");
88
+ settle(() => resolve(result));
89
+ });
90
+ channel.on("close", () => {
91
+ // Sometimes exit doesn't fire; close is the fallback.
92
+ settle(() => resolve({ stdout, stderr, exitCode: 0, durationMs: Date.now() - start }));
93
+ });
94
+ });
95
+ });
96
+ conn.on("error", (err) => {
97
+ this.logger?.error({ err: err.message, host }, "ssh.connect_failed");
98
+ settle(() => reject(new Error(`SSH connect failed to ${host}: ${err.message}`)));
99
+ });
100
+ conn.on("close", () => {
101
+ settle(() => reject(new Error(`SSH connection to ${host} closed unexpectedly`)));
102
+ });
103
+ conn.connect(connectCfg);
104
+ });
105
+ }
106
+ /**
107
+ * Close any persistent resources. (Currently no-op since we open per-call.)
108
+ */
109
+ close() {
110
+ // No persistent connection to close.
111
+ }
112
+ }
113
+ // ---- Helpers --------------------------------------------------------------
114
+ function shellQuote(s) {
115
+ // Wrap in single quotes; escape embedded single quotes.
116
+ return `'${s.replace(/'/g, `'\\''`)}'`;
117
+ }
118
+ function loadKeyFile(path) {
119
+ try {
120
+ // Synchronous read; called once at exec time. Fine for short keys.
121
+ const fs = require("node:fs");
122
+ return fs.readFileSync(path);
123
+ }
124
+ catch (err) {
125
+ throw new Error(`Failed to read SSH key file ${path}: ${err instanceof Error ? err.message : String(err)}`);
126
+ }
127
+ }
128
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/ssh/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Cluster Backup Schedule tools (vzdump schedule jobs).
3
+ *
4
+ * Distinct from ad-hoc `create_backup` in tools/backup.ts — these are
5
+ * scheduled jobs that Proxmox runs automatically.
6
+ */
7
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
8
+ import type { ToolContext } from "./context.js";
9
+ export declare function registerBackupScheduleTools(server: McpServer, ctx: ToolContext): void;
10
+ //# sourceMappingURL=backup-schedule.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup-schedule.d.ts","sourceRoot":"","sources":["../../src/tools/backup-schedule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAmNrF"}
@@ -0,0 +1,194 @@
1
+ import { z } from "zod";
2
+ import * as paths from "../proxmox/paths.js";
3
+ import { runTool, jsonResult } from "../format/response.js";
4
+ import { trackUpid } from "./helpers.js";
5
+ const ScheduleSchema = z
6
+ .string()
7
+ .describe("Calendar event: 'Mon..Sun', '00:00', or a calendar event spec");
8
+ export function registerBackupScheduleTools(server, ctx) {
9
+ server.registerTool("list_backup_jobs", {
10
+ title: "List backup schedule jobs",
11
+ description: "List all scheduled vzdump backup jobs (cluster-wide).",
12
+ inputSchema: z.object({}).strict(),
13
+ annotations: {
14
+ readOnlyHint: true,
15
+ destructiveHint: false,
16
+ idempotentHint: true,
17
+ openWorldHint: false,
18
+ },
19
+ }, async () => runTool(ctx, "list_backup_jobs", {}, async () => {
20
+ const data = await ctx.client.get(paths.backupJobs());
21
+ return jsonResult(`Backup jobs (${Array.isArray(data) ? data.length : "?"}):`, data);
22
+ }));
23
+ server.registerTool("get_backup_job", {
24
+ title: "Get backup schedule job",
25
+ description: "Get a single scheduled backup job.",
26
+ inputSchema: z
27
+ .object({ id: z.string().min(1).describe("Job ID") })
28
+ .strict(),
29
+ annotations: {
30
+ readOnlyHint: true,
31
+ destructiveHint: false,
32
+ idempotentHint: true,
33
+ openWorldHint: false,
34
+ },
35
+ }, async ({ id }) => runTool(ctx, "get_backup_job", { id }, async () => {
36
+ const data = await ctx.client.get(paths.backupJob(id));
37
+ return jsonResult(`Backup job ${id}:`, data);
38
+ }));
39
+ server.registerTool("get_backup_job_included", {
40
+ title: "Get backup job included guests",
41
+ description: "List the VMs/containers that a scheduled backup job would capture.",
42
+ inputSchema: z
43
+ .object({ id: z.string().min(1) })
44
+ .strict(),
45
+ annotations: {
46
+ readOnlyHint: true,
47
+ destructiveHint: false,
48
+ idempotentHint: true,
49
+ openWorldHint: false,
50
+ },
51
+ }, async ({ id }) => runTool(ctx, "get_backup_job_included", { id }, async () => {
52
+ const data = await ctx.client.get(paths.backupJobIncluded(id));
53
+ return jsonResult(`Guests included in backup job ${id}:`, data);
54
+ }));
55
+ server.registerTool("create_backup_job", {
56
+ title: "Create backup schedule",
57
+ description: "Schedule a recurring vzdump backup job.",
58
+ inputSchema: z
59
+ .object({
60
+ id: z.string().min(1).regex(/^[a-zA-Z0-9_\-]+$/).describe("Job ID"),
61
+ schedule: ScheduleSchema,
62
+ storage: z.string().min(1).describe("Target storage"),
63
+ vmid: z.string().optional().describe("Specific VM/CT (or 'all' for everything)"),
64
+ all: z.boolean().optional().describe("Backup all VMs/containers"),
65
+ exclude: z.string().optional().describe("Comma-separated list of VMIDs to exclude"),
66
+ pool: z.string().optional().describe("Pool filter"),
67
+ mode: z.enum(["snapshot", "suspend", "stop"]).default("snapshot"),
68
+ compress: z.enum(["0", "gzip", "lz4", "zstd"]).default("zstd"),
69
+ enabled: z.boolean().default(true),
70
+ notes: z.string().max(1024).optional(),
71
+ notification_mode: z.enum(["notification-system", "auto", "legacy-sendmail"]).optional(),
72
+ mailnotification: z.enum(["always", "failure"]).optional(),
73
+ mailto: z.string().optional(),
74
+ prune_backups: z.string().optional().describe("Retention options, e.g. 'keep-last=7,keep-daily=14'"),
75
+ bwlimit: z.number().int().min(0).optional().describe("Bandwidth limit in KB/s"),
76
+ ionice: z.number().int().min(0).max(8).optional(),
77
+ lockwait: z.number().int().min(0).optional(),
78
+ stopwait: z.number().int().min(0).optional(),
79
+ maxfiles: z.number().int().min(1).optional().describe("DEPRECATED — use prune_backups"),
80
+ next_run: z.string().optional(),
81
+ comment: z.string().max(1024).optional(),
82
+ })
83
+ .strict(),
84
+ annotations: {
85
+ readOnlyHint: false,
86
+ destructiveHint: false,
87
+ idempotentHint: false,
88
+ openWorldHint: true,
89
+ },
90
+ }, async (args) => runTool(ctx, "create_backup_job", args, async () => {
91
+ const body = buildBackupBody(args);
92
+ await ctx.client.post(paths.backupJobs(), body);
93
+ return jsonResult(`Backup job ${args.id} created.`, { id: args.id });
94
+ }));
95
+ server.registerTool("update_backup_job", {
96
+ title: "Update backup schedule",
97
+ description: "Update an existing scheduled backup job.",
98
+ inputSchema: z
99
+ .object({
100
+ id: z.string().min(1),
101
+ schedule: ScheduleSchema.optional(),
102
+ storage: z.string().optional(),
103
+ vmid: z.string().optional(),
104
+ all: z.boolean().optional(),
105
+ exclude: z.string().optional(),
106
+ pool: z.string().optional(),
107
+ mode: z.enum(["snapshot", "suspend", "stop"]).optional(),
108
+ compress: z.enum(["0", "gzip", "lz4", "zstd"]).optional(),
109
+ enabled: z.boolean().optional(),
110
+ notes: z.string().optional(),
111
+ notification_mode: z.enum(["notification-system", "auto", "legacy-sendmail"]).optional(),
112
+ mailnotification: z.enum(["always", "failure"]).optional(),
113
+ mailto: z.string().optional(),
114
+ prune_backups: z.string().optional(),
115
+ bwlimit: z.number().int().optional(),
116
+ ionice: z.number().int().optional(),
117
+ lockwait: z.number().int().optional(),
118
+ stopwait: z.number().int().optional(),
119
+ maxfiles: z.number().int().optional(),
120
+ next_run: z.string().optional(),
121
+ comment: z.string().optional(),
122
+ delete: z.array(z.string()).optional(),
123
+ })
124
+ .strict(),
125
+ annotations: {
126
+ readOnlyHint: false,
127
+ destructiveHint: false,
128
+ idempotentHint: true,
129
+ openWorldHint: true,
130
+ },
131
+ }, async (args) => runTool(ctx, "update_backup_job", args, async () => {
132
+ const { id, delete: del, ...rest } = args;
133
+ const body = buildBackupBody(rest);
134
+ if (del)
135
+ body.delete = del.join(",");
136
+ await ctx.client.put(paths.backupJob(id), body);
137
+ return jsonResult(`Backup job ${id} updated.`, { id });
138
+ }));
139
+ server.registerTool("delete_backup_job", {
140
+ title: "Delete backup schedule",
141
+ description: "Delete a scheduled backup job (existing backups are not deleted).",
142
+ inputSchema: z
143
+ .object({
144
+ id: z.string().min(1),
145
+ approval_token: z.string().optional(),
146
+ })
147
+ .strict(),
148
+ annotations: {
149
+ readOnlyHint: false,
150
+ destructiveHint: true,
151
+ idempotentHint: false,
152
+ openWorldHint: true,
153
+ },
154
+ }, async ({ id, approval_token }) => runTool(ctx, "delete_backup_job", { id, approval_token }, async () => {
155
+ await ctx.client.delete(paths.backupJob(id));
156
+ return jsonResult(`Backup job ${id} deleted.`, { id });
157
+ }));
158
+ server.registerTool("run_backup_job", {
159
+ title: "Run backup schedule now",
160
+ description: "Trigger a scheduled backup job to run immediately (bypasses the schedule).",
161
+ inputSchema: z
162
+ .object({ id: z.string().min(1) })
163
+ .strict(),
164
+ annotations: {
165
+ readOnlyHint: false,
166
+ destructiveHint: false,
167
+ idempotentHint: false,
168
+ openWorldHint: true,
169
+ },
170
+ }, async ({ id }) => runTool(ctx, "run_backup_job", { id }, async () => {
171
+ const upid = await ctx.client.post(paths.runBackupJob(id));
172
+ const job = trackUpid(ctx, upid, {
173
+ node: "",
174
+ tool: "run_backup_job",
175
+ args: { id },
176
+ });
177
+ return jsonResult(`Backup job ${id} triggered.`, { job_id: job.job_id, upid });
178
+ }));
179
+ }
180
+ function buildBackupBody(args) {
181
+ const body = {};
182
+ for (const [k, v] of Object.entries(args)) {
183
+ if (v === undefined || v === null || k === "id" || k === "delete")
184
+ continue;
185
+ if (typeof v === "boolean") {
186
+ body[k] = v ? 1 : 0;
187
+ }
188
+ else {
189
+ body[k] = v;
190
+ }
191
+ }
192
+ return body;
193
+ }
194
+ //# sourceMappingURL=backup-schedule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup-schedule.js","sourceRoot":"","sources":["../../src/tools/backup-schedule.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Backup tools: list, create, restore, delete, prune.
3
+ */
4
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
5
+ import type { ToolContext } from "./context.js";
6
+ export declare function registerBackupTools(server: McpServer, ctx: ToolContext): void;
7
+ //# sourceMappingURL=backup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/tools/backup.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAqM7E"}
@@ -0,0 +1,163 @@
1
+ import { z } from "zod";
2
+ import * as paths from "../proxmox/paths.js";
3
+ import { runTool, jsonResult } from "../format/response.js";
4
+ import { trackUpid } from "./helpers.js";
5
+ const CompressSchema = z.enum(["0", "gzip", "lz4", "zstd"]).default("zstd");
6
+ const ModeSchema = z.enum(["snapshot", "suspend", "stop"]).default("snapshot");
7
+ export function registerBackupTools(server, ctx) {
8
+ server.registerTool("list_backups", {
9
+ title: "List backups",
10
+ description: "List vzdump backup files cluster-wide. Filter by node, storage pool, or VM ID.",
11
+ inputSchema: z
12
+ .object({
13
+ node: z.string().optional().describe("Filter by node"),
14
+ storage: z.string().optional().describe("Filter by storage pool"),
15
+ vmid: z.string().regex(/^\d+$/).optional().describe("Filter by VM/container ID"),
16
+ })
17
+ .strict(),
18
+ annotations: {
19
+ readOnlyHint: true,
20
+ destructiveHint: false,
21
+ idempotentHint: true,
22
+ openWorldHint: false,
23
+ },
24
+ }, async ({ node, storage, vmid }) => runTool(ctx, "list_backups", { node, storage, vmid }, async () => {
25
+ // Discover candidate storage pools
26
+ const allStorage = (await ctx.client.get(paths.storage()));
27
+ const backupStorages = allStorage.filter((s) => (s.content ?? "").includes("backup"));
28
+ const nodesToScan = node
29
+ ? [node]
30
+ : (await ctx.client.get(paths.nodes())).map((n) => n.node);
31
+ const results = [];
32
+ for (const n of nodesToScan) {
33
+ for (const s of backupStorages) {
34
+ try {
35
+ let entries = (await ctx.client.get(paths.nodeStorageContent(n, s.storage, "backup")));
36
+ if (vmid) {
37
+ entries = entries.filter((e) => String(e.vmid ?? "") === vmid);
38
+ }
39
+ if (entries.length > 0)
40
+ results.push({ node: n, storage: s.storage, entries });
41
+ }
42
+ catch {
43
+ // Skip unreadable storages
44
+ }
45
+ }
46
+ }
47
+ return jsonResult(`Backups (${results.flatMap((r) => r.entries).length} files):`, results);
48
+ }));
49
+ server.registerTool("create_backup", {
50
+ title: "Create backup",
51
+ description: "Trigger a vzdump backup of a VM or container to a target storage pool.",
52
+ inputSchema: z
53
+ .object({
54
+ node: z.string().min(1).describe("Host node name"),
55
+ vmid: z.string().regex(/^\d+$/).describe("VM or container ID"),
56
+ storage: z.string().min(1).describe("Target storage pool"),
57
+ compress: CompressSchema.describe("Compression algorithm"),
58
+ mode: ModeSchema.describe("Backup mode: snapshot, suspend, or stop"),
59
+ notes: z.string().max(1024).optional().describe("Optional notes (Proxmox 8+)"),
60
+ })
61
+ .strict(),
62
+ annotations: {
63
+ readOnlyHint: false,
64
+ destructiveHint: false,
65
+ idempotentHint: false,
66
+ openWorldHint: true,
67
+ },
68
+ }, async ({ node, vmid, storage, compress, mode, notes }) => runTool(ctx, "create_backup", { node, vmid, storage, mode }, async () => {
69
+ const body = {
70
+ vmid,
71
+ storage,
72
+ compress,
73
+ mode,
74
+ };
75
+ if (notes)
76
+ body.notes = notes;
77
+ const upid = await ctx.client.post(paths.vzdump(node), body);
78
+ const job = trackUpid(ctx, upid, { node, tool: "create_backup", args: { node, vmid, storage, mode } });
79
+ return jsonResult(`Backup started.`, { job_id: job.job_id, upid });
80
+ }));
81
+ server.registerTool("restore_backup", {
82
+ title: "Restore backup",
83
+ description: "Restore a vzdump archive as a new VM/container. Requires approval_token for destructive operations.",
84
+ inputSchema: z
85
+ .object({
86
+ node: z.string().min(1).describe("Target node for the restored VM/container"),
87
+ archive: z.string().min(1).describe("Backup volume ID (e.g. 'backup:backup/vzdump-qemu-100-...')"),
88
+ vmid: z.string().regex(/^\d+$/).describe("New VM/container ID for the restored machine"),
89
+ storage: z.string().optional().describe("Target storage for disks"),
90
+ unique: z.boolean().default(true).describe("Generate unique MAC addresses"),
91
+ approval_token: z.string().optional().describe("Approval token for high-risk operation"),
92
+ })
93
+ .strict(),
94
+ annotations: {
95
+ readOnlyHint: false,
96
+ destructiveHint: true,
97
+ idempotentHint: false,
98
+ openWorldHint: true,
99
+ },
100
+ }, async ({ node, archive, vmid, storage, unique, approval_token }) => runTool(ctx, "restore_backup", { node, archive, vmid, storage, unique, approval_token }, async () => {
101
+ // Heuristic: vzdump-qemu-* vs vzdump-lxc-*
102
+ const isLxc = archive.includes("lxc");
103
+ const body = {
104
+ archive,
105
+ vmid,
106
+ unique: unique ? 1 : 0,
107
+ };
108
+ if (storage)
109
+ body.storage = storage;
110
+ const endpoint = isLxc ? paths.lxc(node) : paths.qemu(node);
111
+ const upid = await ctx.client.post(endpoint, body);
112
+ const job = trackUpid(ctx, upid, { node, tool: "restore_backup", args: { node, archive, vmid } });
113
+ return jsonResult(`Restore started.`, { job_id: job.job_id, upid });
114
+ }));
115
+ server.registerTool("delete_backup", {
116
+ title: "Delete backup file",
117
+ description: "Permanently delete a vzdump backup file. Requires approval_token for destructive operation.",
118
+ inputSchema: z
119
+ .object({
120
+ node: z.string().min(1),
121
+ storage: z.string().min(1),
122
+ volid: z.string().min(1).describe("Backup volume ID"),
123
+ approval_token: z.string().optional().describe("Approval token for destructive operation"),
124
+ })
125
+ .strict(),
126
+ annotations: {
127
+ readOnlyHint: false,
128
+ destructiveHint: true,
129
+ idempotentHint: false,
130
+ openWorldHint: true,
131
+ },
132
+ }, async ({ node, storage, volid, approval_token }) => runTool(ctx, "delete_backup", { node, storage, volid, approval_token }, async () => {
133
+ await ctx.client.delete(paths.storageContent(node, storage, volid));
134
+ return jsonResult(`Backup deleted.`, { node, storage, volid });
135
+ }));
136
+ server.registerTool("prune_backups", {
137
+ title: "Prune backups by retention",
138
+ description: "Apply a prune schedule (e.g. 'keep-last=7,keep-daily=14,keep-weekly=4') to a storage pool (Proxmox 8+).",
139
+ inputSchema: z
140
+ .object({
141
+ storage: z.string().min(1).describe("Target storage pool"),
142
+ prune_backups: z
143
+ .string()
144
+ .min(1)
145
+ .describe("Prune options (e.g. 'keep-last=7,keep-daily=14,keep-weekly=4')"),
146
+ type: z.string().optional().describe("Filter by content type (e.g. 'qemu', 'lxc')"),
147
+ })
148
+ .strict(),
149
+ annotations: {
150
+ readOnlyHint: false,
151
+ destructiveHint: true,
152
+ idempotentHint: true,
153
+ openWorldHint: true,
154
+ },
155
+ }, async ({ storage, prune_backups, type }) => runTool(ctx, "prune_backups", { storage, type }, async () => {
156
+ const body = { prune_backups };
157
+ if (type)
158
+ body.type = type;
159
+ const data = await ctx.client.post(paths.pruneBackups(storage), body);
160
+ return jsonResult(`Prune complete.`, data);
161
+ }));
162
+ }
163
+ //# sourceMappingURL=backup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/tools/backup.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Cluster-level tools: get_cluster_status.
3
+ */
4
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
5
+ import type { ToolContext } from "./context.js";
6
+ export declare function registerClusterTools(server: McpServer, ctx: ToolContext): void;
7
+ //# sourceMappingURL=cluster.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../../src/tools/cluster.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAqB9E"}
@@ -0,0 +1,20 @@
1
+ import { z } from "zod";
2
+ import * as paths from "../proxmox/paths.js";
3
+ import { runTool, jsonResult } from "../format/response.js";
4
+ export function registerClusterTools(server, ctx) {
5
+ server.registerTool("get_cluster_status", {
6
+ title: "Get Proxmox cluster status",
7
+ description: "Return quorum status, cluster name/version, and a list of nodes with their online state and IDs.",
8
+ inputSchema: z.object({}).strict(),
9
+ annotations: {
10
+ readOnlyHint: true,
11
+ destructiveHint: false,
12
+ idempotentHint: true,
13
+ openWorldHint: false,
14
+ },
15
+ }, async () => runTool(ctx, "get_cluster_status", {}, async () => {
16
+ const data = await ctx.client.get(paths.clusterStatus());
17
+ return jsonResult("Cluster status:", data);
18
+ }));
19
+ }
20
+ //# sourceMappingURL=cluster.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cluster.js","sourceRoot":"","sources":["../../src/tools/cluster.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,KAAK,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,GAAgB;IACtE,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,kGAAkG;QACpG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;QAClC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,IAAI,EAAE,CACT,OAAO,CAAC,GAAG,EAAE,oBAAoB,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;QACzD,OAAO,UAAU,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Container Config tools: update_container_config, resize_container_disk, move_container_volume.
3
+ */
4
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
5
+ import type { ToolContext } from "../context.js";
6
+ export declare function registerContainerConfigTools(server: McpServer, ctx: ToolContext): void;
7
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/tools/container/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAqHtF"}