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,66 @@
1
+ // Side-effect import: populates the risk registry
2
+ import "../safety/risk.js";
3
+ import { registerClusterTools } from "./cluster.js";
4
+ import { registerNodeTools } from "./node.js";
5
+ import { registerStorageTools } from "./storage.js";
6
+ import { registerTasksTools } from "./tasks.js";
7
+ import { registerJobsTools } from "./jobs.js";
8
+ import { registerSnapshotTools } from "./snapshot.js";
9
+ import { registerBackupTools } from "./backup.js";
10
+ import { registerIsoTools } from "./iso.js";
11
+ import { registerVmCrudTools } from "./vm/crud.js";
12
+ import { registerContainerCrudTools } from "./container/crud.js";
13
+ import { registerVmConfigTools } from "./vm/config.js";
14
+ import { registerContainerConfigTools } from "./container/config.js";
15
+ import { registerVmDiagnosticsTools } from "./vm/diagnostics.js";
16
+ import { registerContainerDiagnosticsTools } from "./container/diagnostics.js";
17
+ import { registerVmMigrationTools } from "./vm/migration.js";
18
+ import { registerContainerMigrationTools } from "./container/migration.js";
19
+ import { registerVmConsoleTools } from "./vm/console.js";
20
+ import { registerContainerConsoleTools } from "./container/console.js";
21
+ import { registerPoolTools } from "./pools.js";
22
+ import { registerHaTools } from "./ha.js";
23
+ import { registerBackupScheduleTools } from "./backup-schedule.js";
24
+ import { registerNodeAdminTools } from "./node-admin.js";
25
+ import { registerNodeServicesTools } from "./node-services.js";
26
+ import { registerNodeNetworkTools } from "./node-network.js";
27
+ import { registerNodeDisksTools } from "./node-disks.js";
28
+ import { registerNodeCertsTools } from "./node-certs.js";
29
+ import { registerStorageAdminTools } from "./storage-admin.js";
30
+ import { registerReplicationTools } from "./replication.js";
31
+ import { registerSdnTools } from "./sdn.js";
32
+ export function registerAll(server, ctx) {
33
+ registerClusterTools(server, ctx);
34
+ registerNodeTools(server, ctx);
35
+ registerStorageTools(server, ctx);
36
+ registerTasksTools(server, ctx);
37
+ registerJobsTools(server, ctx);
38
+ registerSnapshotTools(server, ctx);
39
+ registerBackupTools(server, ctx);
40
+ registerIsoTools(server, ctx);
41
+ registerVmCrudTools(server, ctx);
42
+ registerContainerCrudTools(server, ctx);
43
+ registerVmConfigTools(server, ctx);
44
+ registerContainerConfigTools(server, ctx);
45
+ registerVmDiagnosticsTools(server, ctx);
46
+ registerContainerDiagnosticsTools(server, ctx);
47
+ registerVmMigrationTools(server, ctx);
48
+ registerContainerMigrationTools(server, ctx);
49
+ registerVmConsoleTools(server, ctx);
50
+ registerContainerConsoleTools(server, ctx);
51
+ // Phase 2B
52
+ registerPoolTools(server, ctx);
53
+ registerHaTools(server, ctx);
54
+ registerBackupScheduleTools(server, ctx);
55
+ // Phase 2C
56
+ registerNodeAdminTools(server, ctx);
57
+ registerNodeServicesTools(server, ctx);
58
+ registerNodeNetworkTools(server, ctx);
59
+ registerNodeDisksTools(server, ctx);
60
+ registerNodeCertsTools(server, ctx);
61
+ // Phase 2D
62
+ registerStorageAdminTools(server, ctx);
63
+ registerReplicationTools(server, ctx);
64
+ registerSdnTools(server, ctx);
65
+ }
66
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * ISO & OS template tools: list_isos, list_templates, download_iso, delete_iso.
3
+ */
4
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
5
+ import type { ToolContext } from "./context.js";
6
+ export declare function registerIsoTools(server: McpServer, ctx: ToolContext): void;
7
+ //# sourceMappingURL=iso.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"iso.d.ts","sourceRoot":"","sources":["../../src/tools/iso.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,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CA8H1E"}
@@ -0,0 +1,131 @@
1
+ import { z } from "zod";
2
+ import * as paths from "../proxmox/paths.js";
3
+ import { runTool, jsonResult, errResult } from "../format/response.js";
4
+ import { trackUpid } from "./helpers.js";
5
+ import { validateDownloadUrl } from "../security/url-guard.js";
6
+ const ChecksumAlgoSchema = z.enum(["md5", "sha1", "sha256", "sha512"]).default("sha256");
7
+ export function registerIsoTools(server, ctx) {
8
+ server.registerTool("list_isos", {
9
+ title: "List ISO images",
10
+ description: "List ISO images available on the cluster.",
11
+ inputSchema: z
12
+ .object({
13
+ node: z.string().optional().describe("Filter by node"),
14
+ storage: z.string().optional().describe("Filter by storage"),
15
+ })
16
+ .strict(),
17
+ annotations: {
18
+ readOnlyHint: true,
19
+ destructiveHint: false,
20
+ idempotentHint: true,
21
+ openWorldHint: false,
22
+ },
23
+ }, async ({ node, storage }) => runTool(ctx, "list_isos", { node, storage }, async () => {
24
+ const all = await scanStoragesForContent(ctx, "iso", node, storage);
25
+ return jsonResult(`ISOs (${all.flatMap((r) => r.entries).length}):`, all);
26
+ }));
27
+ server.registerTool("list_templates", {
28
+ title: "List OS templates",
29
+ description: "List LXC OS templates (vztmpl) available on the cluster.",
30
+ inputSchema: z
31
+ .object({
32
+ node: z.string().optional(),
33
+ storage: z.string().optional(),
34
+ })
35
+ .strict(),
36
+ annotations: {
37
+ readOnlyHint: true,
38
+ destructiveHint: false,
39
+ idempotentHint: true,
40
+ openWorldHint: false,
41
+ },
42
+ }, async ({ node, storage }) => runTool(ctx, "list_templates", { node, storage }, async () => {
43
+ const all = await scanStoragesForContent(ctx, "vztmpl", node, storage);
44
+ return jsonResult(`Templates (${all.flatMap((r) => r.entries).length}):`, all);
45
+ }));
46
+ server.registerTool("download_iso", {
47
+ title: "Download ISO/template from URL",
48
+ description: "Trigger a server-side download from a URL into a storage pool (useful for large ISOs). Proxmox fetches the file directly.",
49
+ inputSchema: z
50
+ .object({
51
+ node: z.string().min(1).describe("Target node"),
52
+ storage: z.string().min(1).describe("Target storage"),
53
+ url: z.string().url().describe("Source URL (http/https/ftp)"),
54
+ filename: z.string().min(1).describe("Destination filename"),
55
+ checksum: z.string().optional().describe("Optional checksum for verification"),
56
+ checksum_algorithm: ChecksumAlgoSchema,
57
+ content: z.enum(["iso", "vztmpl"]).default("iso").describe("Content type"),
58
+ })
59
+ .strict(),
60
+ annotations: {
61
+ readOnlyHint: false,
62
+ destructiveHint: false,
63
+ idempotentHint: false,
64
+ openWorldHint: true,
65
+ },
66
+ }, async ({ node, storage, url, filename, checksum, checksum_algorithm, content }) => runTool(ctx, "download_iso", { node, storage, url, filename, content }, async () => {
67
+ // SSRF guard: reject private/loopback IPs and enforce operator allowlist.
68
+ const guard = await validateDownloadUrl(url, {
69
+ allowedSchemes: ctx.config.download.allowedSchemes,
70
+ allowedHosts: ctx.config.download.allowedHosts,
71
+ });
72
+ if (!guard.ok) {
73
+ return errResult(`❌ Download rejected: ${guard.reason}`);
74
+ }
75
+ const body = {
76
+ url,
77
+ filename,
78
+ content,
79
+ };
80
+ if (checksum) {
81
+ body.checksum = checksum_algorithm + ":" + checksum;
82
+ }
83
+ const upid = await ctx.client.post(paths.storageDownloadUrl(node, storage), body);
84
+ const job = trackUpid(ctx, upid, { node, tool: "download_iso", args: { node, storage, url, filename } });
85
+ return jsonResult(`Download started.`, { job_id: job.job_id, upid });
86
+ }));
87
+ server.registerTool("delete_iso", {
88
+ title: "Delete ISO/template",
89
+ description: "Permanently delete an ISO or template. Requires approval_token for high-risk operation.",
90
+ inputSchema: z
91
+ .object({
92
+ node: z.string().min(1),
93
+ storage: z.string().min(1),
94
+ filename: z.string().min(1).describe("Filename (e.g. 'ubuntu-22.04.iso')"),
95
+ approval_token: z.string().optional().describe("Approval token for high-risk operation"),
96
+ })
97
+ .strict(),
98
+ annotations: {
99
+ readOnlyHint: false,
100
+ destructiveHint: true,
101
+ idempotentHint: false,
102
+ openWorldHint: true,
103
+ },
104
+ }, async ({ node, storage, filename, approval_token }) => runTool(ctx, "delete_iso", { node, storage, filename, approval_token }, async () => {
105
+ const volid = `${storage}:${filename}`;
106
+ await ctx.client.delete(paths.storageContent(node, storage, volid));
107
+ return jsonResult(`ISO/template deleted.`, { node, storage, volid });
108
+ }));
109
+ }
110
+ async function scanStoragesForContent(ctx, content, nodeFilter, storageFilter) {
111
+ const allStorage = (await ctx.client.get(paths.storage()));
112
+ const matching = allStorage.filter((s) => storageFilter ? s.storage === storageFilter : (s.content ?? "").includes(content));
113
+ const nodes = nodeFilter
114
+ ? [nodeFilter]
115
+ : (await ctx.client.get(paths.nodes())).map((n) => n.node);
116
+ const results = [];
117
+ for (const n of nodes) {
118
+ for (const s of matching) {
119
+ try {
120
+ const entries = (await ctx.client.get(paths.nodeStorageContent(n, s.storage, content)));
121
+ if (entries.length > 0)
122
+ results.push({ node: n, storage: s.storage, entries });
123
+ }
124
+ catch {
125
+ // skip
126
+ }
127
+ }
128
+ }
129
+ return results;
130
+ }
131
+ //# sourceMappingURL=iso.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"iso.js","sourceRoot":"","sources":["../../src/tools/iso.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Job tracking tools.
3
+ *
4
+ * Wraps the in-memory JobStore so the AI can list / poll / cancel / retry
5
+ * long-running operations initiated by other tools. Phase 1 uses an
6
+ * in-memory store; Phase 2 can swap in SQLite without tool changes.
7
+ */
8
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
9
+ import type { ToolContext } from "./context.js";
10
+ export declare function registerJobsTools(server: McpServer, ctx: ToolContext): void;
11
+ //# sourceMappingURL=jobs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CA6J3E"}
@@ -0,0 +1,173 @@
1
+ import { z } from "zod";
2
+ import * as paths from "../proxmox/paths.js";
3
+ import { runTool, jsonResult, errResult } from "../format/response.js";
4
+ export function registerJobsTools(server, ctx) {
5
+ server.registerTool("list_jobs", {
6
+ title: "List tracked jobs",
7
+ description: "List long-running Proxmox jobs tracked by this MCP server (e.g. create_vm, snapshot, backup).",
8
+ inputSchema: z
9
+ .object({
10
+ status: z
11
+ .enum(["queued", "running", "completed", "failed", "cancelled"])
12
+ .optional()
13
+ .describe("Filter by job status"),
14
+ tool: z.string().optional().describe("Filter by originating tool name"),
15
+ limit: z.number().int().min(1).max(500).optional().describe("Max rows (default 100)"),
16
+ })
17
+ .strict(),
18
+ annotations: {
19
+ readOnlyHint: true,
20
+ destructiveHint: false,
21
+ idempotentHint: true,
22
+ openWorldHint: false,
23
+ },
24
+ }, async ({ status, tool, limit }) => runTool(ctx, "list_jobs", { status, tool, limit }, async () => {
25
+ const jobs = ctx.jobs.list({ status, tool, limit: limit ?? 100 });
26
+ return jsonResult(`Jobs (${jobs.length}):`, jobs);
27
+ }));
28
+ server.registerTool("get_job", {
29
+ title: "Get job details",
30
+ description: "Fetch a single tracked job by job_id, optionally refreshing from Proxmox.",
31
+ inputSchema: z
32
+ .object({
33
+ job_id: z.string().uuid().describe("Job identifier returned by a prior tool call"),
34
+ refresh: z.boolean().optional().describe("Force a fresh poll of the underlying Proxmox task"),
35
+ })
36
+ .strict(),
37
+ annotations: {
38
+ readOnlyHint: true,
39
+ destructiveHint: false,
40
+ idempotentHint: true,
41
+ openWorldHint: false,
42
+ },
43
+ }, async ({ job_id, refresh }) => runTool(ctx, "get_job", { job_id, refresh }, async () => {
44
+ const job = ctx.jobs.get(job_id);
45
+ if (!job)
46
+ return errResult(`Job ${job_id} not found.`);
47
+ if (refresh && job.upid && job.node) {
48
+ await refreshJob(ctx, job);
49
+ }
50
+ return jsonResult(`Job ${job_id}:`, ctx.jobs.get(job_id));
51
+ }));
52
+ server.registerTool("poll_job", {
53
+ title: "Poll job status from Proxmox",
54
+ description: "Force-refresh a tracked job by polling its underlying Proxmox task. Returns the latest state, exit status, progress, and recent log tail.",
55
+ inputSchema: z
56
+ .object({ job_id: z.string().uuid().describe("Job identifier") })
57
+ .strict(),
58
+ annotations: {
59
+ readOnlyHint: true,
60
+ destructiveHint: false,
61
+ idempotentHint: true,
62
+ openWorldHint: false,
63
+ },
64
+ }, async ({ job_id }) => runTool(ctx, "poll_job", { job_id }, async () => {
65
+ const job = ctx.jobs.get(job_id);
66
+ if (!job)
67
+ return errResult(`Job ${job_id} not found.`);
68
+ if (!job.upid || !job.node) {
69
+ return jsonResult(`Job ${job_id} (no UPID yet):`, job);
70
+ }
71
+ await refreshJob(ctx, job);
72
+ return jsonResult(`Job ${job_id} (refreshed):`, ctx.jobs.get(job_id));
73
+ }));
74
+ server.registerTool("cancel_job", {
75
+ title: "Cancel a running job",
76
+ description: "Request cancellation of a tracked job. Calls Proxmox's task-stop endpoint. Some operations cannot be cancelled cleanly.",
77
+ inputSchema: z
78
+ .object({ job_id: z.string().uuid().describe("Job identifier") })
79
+ .strict(),
80
+ annotations: {
81
+ readOnlyHint: false,
82
+ destructiveHint: false,
83
+ idempotentHint: true,
84
+ openWorldHint: true,
85
+ },
86
+ }, async ({ job_id }) => runTool(ctx, "cancel_job", { job_id }, async () => {
87
+ const job = ctx.jobs.get(job_id);
88
+ if (!job)
89
+ return errResult(`Job ${job_id} not found.`);
90
+ if (!job.upid || !job.node) {
91
+ ctx.jobs.update(job_id, { status: "cancelled", ended_at: Date.now() });
92
+ return jsonResult(`Job ${job_id} cancelled (no UPID).`, ctx.jobs.get(job_id));
93
+ }
94
+ await ctx.client.post(paths.taskStop(job.node, job.upid));
95
+ ctx.jobs.update(job_id, { status: "cancelled", ended_at: Date.now() });
96
+ return jsonResult(`Job ${job_id} cancel requested.`, ctx.jobs.get(job_id));
97
+ }));
98
+ server.registerTool("retry_job", {
99
+ title: "Retry a failed/cancelled job",
100
+ description: "Re-invoke the originating tool for a failed/cancelled job, using the stored retry recipe. Returns the new job_id.",
101
+ inputSchema: z
102
+ .object({
103
+ job_id: z.string().uuid().describe("Job identifier"),
104
+ approval_token: z.string().optional().describe("Required if the original tool was destructive"),
105
+ })
106
+ .strict(),
107
+ annotations: {
108
+ readOnlyHint: false,
109
+ destructiveHint: false,
110
+ idempotentHint: false,
111
+ openWorldHint: true,
112
+ },
113
+ }, async ({ job_id, approval_token }) => runTool(ctx, "retry_job", { job_id, approval_token }, async () => {
114
+ const original = ctx.jobs.get(job_id);
115
+ if (!original)
116
+ return errResult(`Job ${job_id} not found.`);
117
+ if (!original.retry_spec)
118
+ return errResult(`Job ${job_id} has no stored retry recipe.`);
119
+ // Re-run is intentionally minimal in Phase 1: emit a "manual retry
120
+ // recommended" notice rather than re-invoking the tool automatically
121
+ // (avoids recursive tool dispatch through MCP).
122
+ const notice = {
123
+ original_job_id: job_id,
124
+ tool: original.retry_spec.tool,
125
+ args: original.retry_spec.args,
126
+ hint: `Call ${original.retry_spec.tool} again with the args shown above to retry. ` +
127
+ `The MCP server does not auto-reinvoke tools in Phase 1.`,
128
+ };
129
+ return jsonResult(`Retry recipe for ${job_id}:`, notice);
130
+ }));
131
+ }
132
+ async function refreshJob(ctx, job) {
133
+ if (!job.upid || !job.node)
134
+ return;
135
+ try {
136
+ const status = await ctx.client.get(paths.taskStatus(job.node, job.upid));
137
+ const s = status;
138
+ let nextStatus = job.status;
139
+ if (s.status === "running")
140
+ nextStatus = "running";
141
+ else if (s.status === "stopped" || s.status === "OK")
142
+ nextStatus = "completed";
143
+ else if (s.status === "ERROR")
144
+ nextStatus = "failed";
145
+ // Best-effort progress from log tail
146
+ let progress = job.progress;
147
+ try {
148
+ const log = await ctx.client.get(paths.taskLog(job.node, job.upid, 50));
149
+ const pctMatch = log
150
+ .map((l) => l.t.match(/(\d{1,3})%/))
151
+ .find((m) => Boolean(m));
152
+ if (pctMatch && pctMatch[1]) {
153
+ const p = Number.parseInt(pctMatch[1], 10);
154
+ if (!Number.isNaN(p) && p >= 0 && p <= 100)
155
+ progress = p;
156
+ }
157
+ }
158
+ catch {
159
+ // ignore log fetch failure
160
+ }
161
+ ctx.jobs.update(job.job_id, {
162
+ status: nextStatus,
163
+ exit_status: s.exitstatus ?? job.exit_status,
164
+ progress,
165
+ ended_at: nextStatus !== "running" ? Date.now() : null,
166
+ result: status,
167
+ });
168
+ }
169
+ catch (err) {
170
+ ctx.logger.warn({ err, job_id: job.job_id }, "jobs.refresh_failed");
171
+ }
172
+ }
173
+ //# sourceMappingURL=jobs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Node administration tools (Phase 2C).
3
+ *
4
+ * Covers apt/dns/hosts/time, network interfaces, services, disks,
5
+ * subscription, certificates, and bulk startall/stopall/migrateall.
6
+ */
7
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
8
+ import type { ToolContext } from "./context.js";
9
+ export declare function registerNodeAdminTools(server: McpServer, ctx: ToolContext): void;
10
+ //# sourceMappingURL=node-admin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-admin.d.ts","sourceRoot":"","sources":["../../src/tools/node-admin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAqehF"}