@bldg-7/proxmox-mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,142 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { toJsonSchemaCompat } from '@modelcontextprotocol/sdk/server/zod-json-schema-compat.js';
+import { toolRegistry } from './tools/registry.js';
+import { TOOL_NAMES } from './types/tools.js';
+const SERVER_VERSION = '0.1.0';
+const TOOL_DESCRIPTIONS = {
+    // Node & Cluster
+    proxmox_get_nodes: 'List all Proxmox cluster nodes with their status and resources',
+    proxmox_get_node_status: 'Get detailed status information for a specific Proxmox node',
+    proxmox_get_cluster_status: 'Get overall cluster status including nodes and resource usage',
+    proxmox_get_next_vmid: 'Get the next available VM/Container ID number',
+    // VM Query
+    proxmox_get_vms: 'List all virtual machines across the cluster with their status',
+    proxmox_get_vm_status: 'Get detailed status information for a specific VM',
+    proxmox_get_storage: 'List all storage pools and their usage across the cluster',
+    // VM Lifecycle
+    proxmox_start_lxc: 'Start an LXC container (requires elevated permissions)',
+    proxmox_start_vm: 'Start a QEMU virtual machine (requires elevated permissions)',
+    proxmox_stop_lxc: 'Stop an LXC container (requires elevated permissions)',
+    proxmox_stop_vm: 'Stop a QEMU virtual machine (requires elevated permissions)',
+    proxmox_delete_lxc: 'Delete an LXC container (requires elevated permissions)',
+    proxmox_delete_vm: 'Delete a QEMU virtual machine (requires elevated permissions)',
+    proxmox_reboot_lxc: 'Reboot an LXC container (requires elevated permissions)',
+    proxmox_reboot_vm: 'Reboot a QEMU virtual machine (requires elevated permissions)',
+    proxmox_shutdown_lxc: 'Gracefully shutdown an LXC container (requires elevated permissions)',
+    proxmox_shutdown_vm: 'Gracefully shutdown a QEMU virtual machine (requires elevated permissions)',
+    proxmox_pause_vm: 'Pause a QEMU virtual machine (requires elevated permissions)',
+    proxmox_resume_vm: 'Resume a paused QEMU virtual machine (requires elevated permissions)',
+    // VM Modify
+    proxmox_clone_lxc: 'Clone an LXC container (requires elevated permissions)',
+    proxmox_clone_vm: 'Clone a QEMU virtual machine (requires elevated permissions)',
+    proxmox_resize_lxc: 'Resize an LXC container CPU/memory (requires elevated permissions)',
+    proxmox_resize_vm: 'Resize a QEMU VM CPU/memory (requires elevated permissions)',
+    // Snapshots
+    proxmox_create_snapshot_lxc: 'Create a snapshot of an LXC container (requires elevated permissions)',
+    proxmox_create_snapshot_vm: 'Create a snapshot of a QEMU virtual machine (requires elevated permissions)',
+    proxmox_list_snapshots_lxc: 'List all snapshots of an LXC container (requires elevated permissions)',
+    proxmox_list_snapshots_vm: 'List all snapshots of a QEMU virtual machine (requires elevated permissions)',
+    proxmox_rollback_snapshot_lxc: 'Rollback an LXC container to a snapshot (requires elevated permissions)',
+    proxmox_rollback_snapshot_vm: 'Rollback a QEMU virtual machine to a snapshot (requires elevated permissions)',
+    proxmox_delete_snapshot_lxc: 'Delete a snapshot of an LXC container (requires elevated permissions)',
+    proxmox_delete_snapshot_vm: 'Delete a snapshot of a QEMU virtual machine (requires elevated permissions)',
+    // Backups
+    proxmox_create_backup_lxc: 'Create a backup of an LXC container (requires elevated permissions)',
+    proxmox_create_backup_vm: 'Create a backup of a QEMU virtual machine (requires elevated permissions)',
+    proxmox_list_backups: 'List all backups on a storage (requires elevated permissions)',
+    proxmox_restore_backup_lxc: 'Restore an LXC container from backup (requires elevated permissions)',
+    proxmox_restore_backup_vm: 'Restore a QEMU virtual machine from backup (requires elevated permissions)',
+    proxmox_delete_backup: 'Delete a backup file from storage (requires elevated permissions)',
+    // Disks
+    proxmox_add_disk_vm: 'Add a new disk to a QEMU virtual machine (requires elevated permissions)',
+    proxmox_add_mountpoint_lxc: 'Add a mount point to an LXC container (requires elevated permissions)',
+    proxmox_resize_disk_vm: 'Resize a QEMU VM disk (requires elevated permissions)',
+    proxmox_resize_disk_lxc: 'Resize an LXC container disk or mount point (requires elevated permissions)',
+    proxmox_remove_disk_vm: 'Remove a disk from a QEMU virtual machine (requires elevated permissions)',
+    proxmox_remove_mountpoint_lxc: 'Remove a mount point from an LXC container (requires elevated permissions)',
+    proxmox_move_disk_vm: 'Move a QEMU VM disk to different storage (requires elevated permissions)',
+    proxmox_move_disk_lxc: 'Move an LXC container disk to different storage (requires elevated permissions)',
+    // Network
+    proxmox_add_network_vm: 'Add network interface to QEMU VM (requires elevated permissions)',
+    proxmox_add_network_lxc: 'Add network interface to LXC container (requires elevated permissions)',
+    proxmox_update_network_vm: 'Update/modify VM network interface configuration (requires elevated permissions)',
+    proxmox_update_network_lxc: 'Update/modify LXC network interface configuration (requires elevated permissions)',
+    proxmox_remove_network_vm: 'Remove network interface from QEMU VM (requires elevated permissions)',
+    proxmox_remove_network_lxc: 'Remove network interface from LXC container (requires elevated permissions)',
+    // Command
+    proxmox_execute_vm_command: 'Execute a shell command on a virtual machine via Proxmox API',
+    // Creation
+    proxmox_list_templates: 'List available LXC container templates on a storage',
+    proxmox_create_lxc: 'Create a new LXC container (requires elevated permissions)',
+    proxmox_create_vm: 'Create a new QEMU virtual machine (requires elevated permissions)',
+};
+export function createServer(client, config) {
+    const server = new Server({
+        name: 'proxmox-mcp',
+        version: SERVER_VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    const toolDefinitions = TOOL_NAMES.map((name) => {
+        const entry = toolRegistry[name];
+        const jsonSchema = toJsonSchemaCompat(entry.schema);
+        // $schema meta-property is not part of the MCP tool inputSchema spec
+        const { $schema: _$schema, ...inputSchema } = jsonSchema;
+        return {
+            name,
+            description: TOOL_DESCRIPTIONS[name],
+            inputSchema: inputSchema,
+        };
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: toolDefinitions,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const entry = toolRegistry[name];
+        if (!entry) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: Unknown tool "${name}". Use ListTools to see available tools.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const validated = entry.schema.parse(args ?? {});
+            const result = await entry.handler(client, config, validated);
+            return { ...result };
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'ZodError') {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Validation error for tool "${name}": ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error executing tool "${name}": ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/backup.d.ts

@@ -0,0 +1,35 @@
+import type { ProxmoxApiClient } from '../client/proxmox.js';
+import type { Config } from '../config/index.js';
+import type { ToolResponse } from '../types/index.js';
+import type { CreateBackupLxcInput, CreateBackupVmInput, ListBackupsInput, RestoreBackupLxcInput, RestoreBackupVmInput, DeleteBackupInput } from '../schemas/backup.js';
+/**
+ * Create a backup of an LXC container
+ * Requires elevated permissions
+ */
+export declare function createBackupLxc(client: ProxmoxApiClient, config: Config, input: CreateBackupLxcInput): Promise<ToolResponse>;
+/**
+ * Create a backup of a QEMU VM
+ * Requires elevated permissions
+ */
+export declare function createBackupVM(client: ProxmoxApiClient, config: Config, input: CreateBackupVmInput): Promise<ToolResponse>;
+/**
+ * List all backups on a storage
+ * Requires elevated permissions
+ */
+export declare function listBackups(client: ProxmoxApiClient, config: Config, input: ListBackupsInput): Promise<ToolResponse>;
+/**
+ * Restore an LXC container from backup
+ * Requires elevated permissions
+ */
+export declare function restoreBackupLxc(client: ProxmoxApiClient, config: Config, input: RestoreBackupLxcInput): Promise<ToolResponse>;
+/**
+ * Restore a QEMU VM from backup
+ * Requires elevated permissions
+ */
+export declare function restoreBackupVM(client: ProxmoxApiClient, config: Config, input: RestoreBackupVmInput): Promise<ToolResponse>;
+/**
+ * Delete a backup file from storage
+ * Requires elevated permissions
+ */
+export declare function deleteBackup(client: ProxmoxApiClient, config: Config, input: DeleteBackupInput): Promise<ToolResponse>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/tools/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/tools/backup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBtD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAoCvB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,YAAY,CAAC,CAoCvB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAgDvB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CA2BvB"}

package/dist/tools/backup.js

@@ -0,0 +1,210 @@
+import { formatToolResponse, formatErrorResponse, formatBytes, } from '../formatters/index.js';
+import { requireElevated } from '../middleware/index.js';
+import { validateNodeName, validateVMID, validateStorageName } from '../validators/index.js';
+import { createBackupLxcSchema, createBackupVmSchema, listBackupsSchema, restoreBackupLxcSchema, restoreBackupVmSchema, deleteBackupSchema, } from '../schemas/backup.js';
+/**
+ * Create a backup of an LXC container
+ * Requires elevated permissions
+ */
+export async function createBackupLxc(client, config, input) {
+    try {
+        requireElevated(config, 'create LXC backup');
+        const validated = createBackupLxcSchema.parse(input);
+        const safeNode = validateNodeName(validated.node);
+        const safeVmid = validateVMID(validated.vmid);
+        const result = await client.request(`/nodes/${safeNode}/vzdump`, 'POST', {
+            vmid: safeVmid,
+            storage: validated.storage || 'local',
+            mode: validated.mode || 'snapshot',
+            compress: validated.compress || 'zstd',
+        });
+        let output = `💾 **Backup Creation Started**\n\n`;
+        output += `• **Container ID**: ${safeVmid}\n`;
+        output += `• **Node**: ${safeNode}\n`;
+        output += `• **Storage**: ${validated.storage || 'local'}\n`;
+        output += `• **Mode**: ${validated.mode || 'snapshot'}\n`;
+        output += `• **Compression**: ${validated.compress || 'zstd'}\n`;
+        output += `• **Task ID**: ${result || 'N/A'}\n\n`;
+        output += `**Backup Modes**:\n`;
+        output += `  • snapshot: Quick backup using snapshots (recommended)\n`;
+        output += `  • suspend: Suspends container during backup\n`;
+        output += `  • stop: Stops container during backup\n\n`;
+        output += `Use \`list_backups\` to view all backups.`;
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'Create LXC Backup');
+    }
+}
+/**
+ * Create a backup of a QEMU VM
+ * Requires elevated permissions
+ */
+export async function createBackupVM(client, config, input) {
+    try {
+        requireElevated(config, 'create VM backup');
+        const validated = createBackupVmSchema.parse(input);
+        const safeNode = validateNodeName(validated.node);
+        const safeVmid = validateVMID(validated.vmid);
+        const result = await client.request(`/nodes/${safeNode}/vzdump`, 'POST', {
+            vmid: safeVmid,
+            storage: validated.storage || 'local',
+            mode: validated.mode || 'snapshot',
+            compress: validated.compress || 'zstd',
+        });
+        let output = `💾 **Backup Creation Started**\n\n`;
+        output += `• **VM ID**: ${safeVmid}\n`;
+        output += `• **Node**: ${safeNode}\n`;
+        output += `• **Storage**: ${validated.storage || 'local'}\n`;
+        output += `• **Mode**: ${validated.mode || 'snapshot'}\n`;
+        output += `• **Compression**: ${validated.compress || 'zstd'}\n`;
+        output += `• **Task ID**: ${result || 'N/A'}\n\n`;
+        output += `**Backup Modes**:\n`;
+        output += `  • snapshot: Quick backup using snapshots (recommended)\n`;
+        output += `  • suspend: Suspends VM during backup\n`;
+        output += `  • stop: Stops VM during backup\n\n`;
+        output += `Use \`list_backups\` to view all backups.`;
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'Create VM Backup');
+    }
+}
+/**
+ * List all backups on a storage
+ * Requires elevated permissions
+ */
+export async function listBackups(client, config, input) {
+    try {
+        requireElevated(config, 'list backups');
+        const validated = listBackupsSchema.parse(input);
+        const safeNode = validateNodeName(validated.node);
+        const storage = validated.storage || 'local';
+        const backups = (await client.request(`/nodes/${safeNode}/storage/${storage}/content?content=backup`));
+        let output = `📦 **Backups on ${storage}**\n\n`;
+        if (!backups || backups.length === 0) {
+            output += `No backups found on storage \`${storage}\`.\n\n`;
+            output += `Use \`create_backup_lxc\` or \`create_backup_vm\` to create backups.`;
+        }
+        else {
+            // Sort by creation time (newest first)
+            const sorted = backups.sort((a, b) => (b.ctime || 0) - (a.ctime || 0));
+            for (const backup of sorted) {
+                // Parse filename to extract VM type and ID
+                const filename = backup.volid.split('/').pop() || backup.volid;
+                const match = filename.match(/vzdump-(lxc|qemu)-(\d+)-/);
+                const vmType = match ? match[1].toUpperCase() : 'UNKNOWN';
+                const vmId = match ? match[2] : 'N/A';
+                output += `**${filename}**\n`;
+                output += `   • VM ID: ${vmId} (${vmType})\n`;
+                output += `   • Size: ${backup.size ? formatBytes(backup.size) : 'N/A'}\n`;
+                if (backup.ctime) {
+                    const date = new Date(backup.ctime * 1000);
+                    output += `   • Created: ${date.toLocaleString()}\n`;
+                }
+                output += `   • Volume: ${backup.volid}\n\n`;
+            }
+            output += `**Total**: ${sorted.length} backup(s)`;
+        }
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'List Backups');
+    }
+}
+/**
+ * Restore an LXC container from backup
+ * Requires elevated permissions
+ */
+export async function restoreBackupLxc(client, config, input) {
+    try {
+        requireElevated(config, 'restore LXC backup');
+        const validated = restoreBackupLxcSchema.parse(input);
+        const safeNode = validateNodeName(validated.node);
+        const safeVmid = validateVMID(validated.vmid);
+        const body = {
+            vmid: safeVmid,
+            archive: validated.archive,
+            restore: 1,
+        };
+        if (validated.storage) {
+            body.storage = validated.storage;
+        }
+        const result = await client.request(`/nodes/${safeNode}/lxc`, 'POST', body);
+        let output = `♻️  **Backup Restore Started**\n\n`;
+        output += `• **New Container ID**: ${safeVmid}\n`;
+        output += `• **Node**: ${safeNode}\n`;
+        output += `• **Archive**: ${validated.archive}\n`;
+        if (validated.storage) {
+            output += `• **Storage**: ${validated.storage}\n`;
+        }
+        output += `• **Task ID**: ${result || 'N/A'}\n\n`;
+        output += `**Note**: Restore operation may take several minutes depending on backup size.\n`;
+        output += `**Tip**: Use \`get_vm_status\` to check the restored container status after completion.`;
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'Restore LXC Backup');
+    }
+}
+/**
+ * Restore a QEMU VM from backup
+ * Requires elevated permissions
+ */
+export async function restoreBackupVM(client, config, input) {
+    try {
+        requireElevated(config, 'restore VM backup');
+        const validated = restoreBackupVmSchema.parse(input);
+        const safeNode = validateNodeName(validated.node);
+        const safeVmid = validateVMID(validated.vmid);
+        const body = {
+            vmid: safeVmid,
+            archive: validated.archive,
+            restore: 1,
+        };
+        if (validated.storage) {
+            body.storage = validated.storage;
+        }
+        const result = await client.request(`/nodes/${safeNode}/qemu`, 'POST', body);
+        let output = `♻️  **Backup Restore Started**\n\n`;
+        output += `• **New VM ID**: ${safeVmid}\n`;
+        output += `• **Node**: ${safeNode}\n`;
+        output += `• **Archive**: ${validated.archive}\n`;
+        if (validated.storage) {
+            output += `• **Storage**: ${validated.storage}\n`;
+        }
+        output += `• **Task ID**: ${result || 'N/A'}\n\n`;
+        output += `**Note**: Restore operation may take several minutes depending on backup size.\n`;
+        output += `**Tip**: Use \`get_vm_status\` to check the restored VM status after completion.`;
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'Restore VM Backup');
+    }
+}
+/**
+ * Delete a backup file from storage
+ * Requires elevated permissions
+ */
+export async function deleteBackup(client, config, input) {
+    try {
+        requireElevated(config, 'delete backup');
+        const validated = deleteBackupSchema.parse(input);
+        const safeNode = validateNodeName(validated.node);
+        const safeStorage = validateStorageName(validated.storage);
+        // URL-encode the volume parameter
+        const encodedVolume = encodeURIComponent(validated.volume);
+        const result = await client.request(`/nodes/${safeNode}/storage/${safeStorage}/content/${encodedVolume}`, 'DELETE');
+        let output = `🗑️  **Backup Deletion Started**\n\n`;
+        output += `• **Node**: ${safeNode}\n`;
+        output += `• **Storage**: ${safeStorage}\n`;
+        output += `• **Volume**: ${validated.volume}\n`;
+        output += `• **Task ID**: ${result || 'N/A'}\n\n`;
+        output += `**Warning**: Backup file will be permanently deleted from storage.`;
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'Delete Backup');
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/tools/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/tools/backup.ts"],"names":[],"mappings":"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"}

package/dist/tools/cluster.d.ts

@@ -0,0 +1,15 @@
+import type { ProxmoxApiClient } from '../client/proxmox.js';
+import type { Config } from '../config/index.js';
+import type { ToolResponse } from '../types/index.js';
+import type { GetClusterStatusInput, GetNextVmidInput } from '../schemas/node.js';
+/**
+ * Get overall cluster status with resource usage and node information.
+ * Gracefully degrades without elevated permissions.
+ */
+export declare function getClusterStatus(client: ProxmoxApiClient, config: Config, input: GetClusterStatusInput): Promise<ToolResponse>;
+/**
+ * Get the next available VM/Container ID.
+ * No elevated permissions required.
+ */
+export declare function getNextVMID(client: ProxmoxApiClient, _config: Config, input: GetNextVmidInput): Promise<ToolResponse>;
+//# sourceMappingURL=cluster.d.ts.map

package/dist/tools/cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../../src/tools/cluster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAElF;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAgEvB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAevB"}

package/dist/tools/cluster.js

@@ -0,0 +1,82 @@
+import { formatToolResponse, formatErrorResponse, formatBytes, } from '../formatters/index.js';
+import { getClusterStatusSchema, getNextVmidSchema } from '../schemas/node.js';
+/**
+ * Get overall cluster status with resource usage and node information.
+ * Gracefully degrades without elevated permissions.
+ */
+export async function getClusterStatus(client, config, input) {
+    try {
+        // Validate input (empty schema)
+        getClusterStatusSchema.parse(input);
+        // Get nodes list
+        const nodes = (await client.request('/nodes'));
+        // Try to get cluster status if elevated, but ignore errors
+        if (config.allowElevated) {
+            try {
+                await client.request('/cluster/status');
+            }
+            catch {
+                // Ignore cluster status errors
+            }
+        }
+        // Format response
+        let output = '🏗️  **Proxmox Cluster Status**\n\n';
+        // Cluster overview
+        const onlineNodes = nodes.filter((n) => n.status === 'online').length;
+        const totalNodes = nodes.length;
+        output += `**Cluster Health**: ${onlineNodes === totalNodes ? '🟢 Healthy' : '🟡 Warning'}\n`;
+        output += `**Nodes**: ${onlineNodes}/${totalNodes} online\n\n`;
+        if (config.allowElevated) {
+            // Resource summary (only available with elevated permissions)
+            let totalCpu = 0;
+            let usedCpu = 0;
+            let totalMem = 0;
+            let usedMem = 0;
+            for (const node of nodes) {
+                if (node.status === 'online') {
+                    totalCpu += node.maxcpu || 0;
+                    usedCpu += (node.cpu || 0) * (node.maxcpu || 0);
+                    totalMem += node.maxmem || 0;
+                    usedMem += node.mem || 0;
+                }
+            }
+            const cpuPercent = totalCpu > 0 ? ((usedCpu / totalCpu) * 100).toFixed(1) : 'N/A';
+            const memPercent = totalMem > 0 ? ((usedMem / totalMem) * 100).toFixed(1) : 'N/A';
+            output += `**Resource Usage**:\n`;
+            output += `• CPU: ${cpuPercent}% (${usedCpu.toFixed(1)}/${totalCpu} cores)\n`;
+            output += `• Memory: ${memPercent}% (${formatBytes(usedMem)}/${formatBytes(totalMem)})\n\n`;
+        }
+        else {
+            output += `⚠️  **Limited Information**: Resource usage requires elevated permissions\n\n`;
+        }
+        // Node status
+        output += `**Node Details**:\n`;
+        for (const node of nodes.sort((a, b) => a.node.localeCompare(b.node))) {
+            const status = node.status === 'online' ? '🟢' : '🔴';
+            output += `${status} ${node.node} - ${node.status}\n`;
+        }
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'Get Cluster Status');
+    }
+}
+/**
+ * Get the next available VM/Container ID.
+ * No elevated permissions required.
+ */
+export async function getNextVMID(client, _config, input) {
+    try {
+        // Validate input (empty schema)
+        getNextVmidSchema.parse(input);
+        // Call Proxmox API
+        const result = await client.request('/cluster/nextid');
+        // Format response
+        const output = `**Next Available VM/Container ID**: ${result}`;
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'Get Next VMID');
+    }
+}
+//# sourceMappingURL=cluster.js.map

package/dist/tools/cluster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../../src/tools/cluster.ts"],"names":[],"mappings":"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"}

package/dist/tools/command.d.ts

@@ -0,0 +1,6 @@
+import type { ProxmoxApiClient } from '../client/proxmox.js';
+import type { Config } from '../config/index.js';
+import type { ToolResponse } from '../types/index.js';
+import type { ExecuteVmCommandInput } from '../schemas/vm.js';
+export declare function executeVMCommand(client: ProxmoxApiClient, config: Config, input: ExecuteVmCommandInput): Promise<ToolResponse>;
+//# sourceMappingURL=command.d.ts.map

package/dist/tools/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/tools/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA4BvB"}

package/dist/tools/command.js

@@ -0,0 +1,26 @@
+import { formatToolResponse, formatErrorResponse, } from '../formatters/index.js';
+import { requireElevated } from '../middleware/index.js';
+import { validateNodeName, validateVMID, validateCommand } from '../validators/index.js';
+import { executeVmCommandSchema } from '../schemas/vm.js';
+export async function executeVMCommand(client, config, input) {
+    try {
+        requireElevated(config, 'execute VM command');
+        const validated = executeVmCommandSchema.parse(input);
+        const safeNode = validateNodeName(validated.node);
+        const safeVmid = validateVMID(validated.vmid);
+        const safeCommand = validateCommand(validated.command);
+        const type = validated.type || 'qemu';
+        const result = (await client.request(`/nodes/${safeNode}/${type}/${safeVmid}/agent/exec`, 'POST', { command: ['sh', '-c', safeCommand] }));
+        const output = `⚡ **Command Execution Started**\n\n` +
+            `• **VM ID**: ${safeVmid}\n` +
+            `• **Type**: ${type.toUpperCase()}\n` +
+            `• **Command**: \`${safeCommand}\`\n` +
+            `• **PID**: ${result.pid}\n\n` +
+            `**Note**: Command runs asynchronously via QEMU guest agent.`;
+        return formatToolResponse(output);
+    }
+    catch (error) {
+        return formatErrorResponse(error, 'Execute VM Command');
+    }
+}
+//# sourceMappingURL=command.js.map

package/dist/tools/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/tools/command.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAwB,EACxB,MAAc,EACd,KAA4B;IAE5B,IAAI,CAAC;QACH,eAAe,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAE9C,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,MAAM,CAAC;QAEtC,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAClC,UAAU,QAAQ,IAAI,IAAI,IAAI,QAAQ,aAAa,EACnD,MAAM,EACN,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,CACvC,CAAoB,CAAC;QAEtB,MAAM,MAAM,GACV,qCAAqC;YACrC,gBAAgB,QAAQ,IAAI;YAC5B,eAAe,IAAI,CAAC,WAAW,EAAE,IAAI;YACrC,oBAAoB,WAAW,MAAM;YACrC,cAAc,MAAM,CAAC,GAAG,MAAM;YAC9B,6DAA6D,CAAC;QAEhE,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,mBAAmB,CAAC,KAAc,EAAE,oBAAoB,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/tools/disk.d.ts

@@ -0,0 +1,45 @@
+import type { ProxmoxApiClient } from '../client/proxmox.js';
+import type { Config } from '../config/index.js';
+import type { ToolResponse } from '../types/index.js';
+import type { AddDiskVmInput, AddMountpointLxcInput, ResizeDiskVmInput, ResizeDiskLxcInput, RemoveDiskVmInput, RemoveMountpointLxcInput, MoveDiskVmInput, MoveDiskLxcInput } from '../schemas/disk.js';
+/**
+ * Add a new disk to a QEMU VM
+ * Requires elevated permissions
+ */
+export declare function addDiskVM(client: ProxmoxApiClient, config: Config, input: AddDiskVmInput): Promise<ToolResponse>;
+/**
+ * Add a mount point to an LXC container
+ * Requires elevated permissions
+ */
+export declare function addMountpointLxc(client: ProxmoxApiClient, config: Config, input: AddMountpointLxcInput): Promise<ToolResponse>;
+/**
+ * Resize a QEMU VM disk
+ * Requires elevated permissions
+ */
+export declare function resizeDiskVM(client: ProxmoxApiClient, config: Config, input: ResizeDiskVmInput): Promise<ToolResponse>;
+/**
+ * Resize an LXC container disk or mount point
+ * Requires elevated permissions
+ */
+export declare function resizeDiskLxc(client: ProxmoxApiClient, config: Config, input: ResizeDiskLxcInput): Promise<ToolResponse>;
+/**
+ * Remove a disk from a QEMU VM
+ * Requires elevated permissions
+ */
+export declare function removeDiskVM(client: ProxmoxApiClient, config: Config, input: RemoveDiskVmInput): Promise<ToolResponse>;
+/**
+ * Remove a mount point from an LXC container
+ * Requires elevated permissions
+ */
+export declare function removeMountpointLxc(client: ProxmoxApiClient, config: Config, input: RemoveMountpointLxcInput): Promise<ToolResponse>;
+/**
+ * Move a QEMU VM disk to different storage
+ * Requires elevated permissions
+ */
+export declare function moveDiskVM(client: ProxmoxApiClient, config: Config, input: MoveDiskVmInput): Promise<ToolResponse>;
+/**
+ * Move an LXC container disk to different storage
+ * Requires elevated permissions
+ */
+export declare function moveDiskLxc(client: ProxmoxApiClient, config: Config, input: MoveDiskLxcInput): Promise<ToolResponse>;
+//# sourceMappingURL=disk.d.ts.map

package/dist/tools/disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../src/tools/disk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAiBtD,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,YAAY,CAAC,CAmCvB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,YAAY,CAAC,CAiCvB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CA4BvB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,YAAY,CAAC,CA4BvB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,YAAY,CAAC,CAiCvB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAkCvB"}