@bldg-7/proxmox-mcp 0.6.1 → 1.0.1

package/README.md

@@ -8,7 +8,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue.svg)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
 
-A comprehensive MCP server providing 309 tools for managing Proxmox Virtual Environment, including QEMU VMs and LXC containers.
+A comprehensive MCP server providing 91 tools for managing Proxmox Virtual Environment, including QEMU VMs and LXC containers.
 
 ## Credits & Background
 
@@ -23,20 +23,20 @@ This project is a TypeScript rewrite of [mcp-proxmox-server](https://github.com/
 - Giant switch statement (55 cases) → tool registry with handler/schema pairs
 
 **Quality**:
-- 0 tests → 808 tests
+- 0 tests → 1,114 tests
 - No input validation → Zod runtime validation on every tool call
 - Implicit error handling → structured MCP error responses with context
 - No permission checks → two-tier permission model (basic / elevated)
 
 **Developer Experience**:
 - `npx @bldg-7/proxmox-mcp` just works
-- All 309 tool descriptions exposed via MCP `ListTools`
+- All 91 tool descriptions exposed via MCP `ListTools`
 - Rate limiter middleware included
 - Pino structured logging instead of `console.log`
 
 ## Features
 
-- **309 comprehensive tools** for Proxmox management
+- **91 comprehensive tools** for Proxmox management
 - **Full TypeScript implementation** with strict type safety
 - **Support for both QEMU VMs and LXC containers**
 - **Secure authentication** (API token)
@@ -125,35 +125,30 @@ Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/
 
 ## Available Tools
 
-This server provides **309 comprehensive tools** for Proxmox management:
+This server provides **91 comprehensive tools** for Proxmox management:
 
 | Category | Tools | Permission |
 |----------|-------|------------|
-| Node & Cluster | 7 | Mixed |
-| Node Management | 8 | Mixed |
-| System Operations | 20 | Mixed |
-| Node Network Config | 4 | Elevated 🔒 |
-| Cluster Management | 54 | Mixed |
-| Storage Management | 12 | Mixed |
-| Access Control | 25 | Mixed |
-| Pool Management | 5 | Mixed |
-| SDN Networking | 20 | Mixed |
-| Ceph | 16 | Mixed |
-| VM Query | 9 | Basic |
-| VM Lifecycle | 12 | Elevated 🔒 |
-| VM Modify | 4 | Elevated 🔒 |
-| VM/LXC Advanced | 30 | Mixed |
-| Snapshots | 8 | Mixed |
-| Backups | 6 | Elevated 🔒 |
-| Disks | 16 | Mixed |
-| VM/LXC Network | 6 | Elevated 🔒 |
-| Console Access | 5 | Elevated 🔒 |
-| Command Execution | 1 | Elevated 🔒 |
-| VM Creation | 6 | Mixed |
-| Certificates | 7 | Mixed |
-| ACME | 8 | Mixed |
-| Notifications | 5 | Mixed |
-| **Total** | **309** | |
+| Node Management | 14 | Mixed |
+| Guest (VM/LXC) | 23 | Mixed |
+| Guest Creation | 2 | Elevated 🔒 |
+| QEMU Agent | 7 | Elevated 🔒 |
+| Cluster Operations | 5 | Mixed |
+| Cluster Firewall | 6 | Mixed |
+| High Availability | 2 | Mixed |
+| Storage | 3 | Mixed |
+| SDN Networking | 4 | Mixed |
+| Access Control | 7 | Mixed |
+| Ceph | 6 | Mixed |
+| Console Access | 3 | Elevated 🔒 |
+| Backup | 1 | Mixed |
+| VM Disks | 1 | Elevated 🔒 |
+| LXC Mount Points | 1 | Elevated 🔒 |
+| Cloud-Init | 1 | Mixed |
+| Certificates | 1 | Mixed |
+| ACME | 3 | Mixed |
+| Notifications | 1 | Mixed |
+| **Total** | **91** | |
 
 📖 **[Full Tools Reference →](docs/TOOLS.md)**
 
@@ -165,7 +160,7 @@ This package includes **Agent Skills** - AI-optimized documentation that teaches
 
 | Skill | Description | Tools/Topics |
 |-------|-------------|--------------|
-| **proxmox-mcp-tools** | Complete MCP tool reference for Proxmox VE | 309 tools across 14 domains (VMs, LXC, cluster, storage, networking, Ceph, certificates, ACME, notifications) |
+| **proxmox-mcp-tools** | Complete MCP tool reference for Proxmox VE | 91 tools across 14 domains (VMs, LXC, cluster, storage, networking, Ceph, certificates, ACME, notifications) |
 | **proxmox-admin** | Operational expertise for Proxmox infrastructure | VM lifecycle, storage management, HA configuration, troubleshooting |
 
 ### Installation
@@ -202,9 +197,9 @@ You: "Create an Ubuntu VM with 4 cores, 8GB RAM, and 50GB disk on pve1"
 Agent knows the workflow from the skill:
   1. proxmox_get_next_vmid        → gets available VM ID (e.g., 105)
   2. proxmox_create_vm            → creates VM 105 with 4 cores, 8GB RAM
-  3. proxmox_add_disk_vm          → attaches 50GB virtio disk
-  4. proxmox_add_network_vm       → adds network interface on vmbr0
-  5. proxmox_start_vm             → powers on the VM
+  3. proxmox_vm_disk              → attaches 50GB virtio disk (action: 'add')
+  4. proxmox_guest_network        → adds network interface on vmbr0 (action: 'add', type: 'vm')
+  5. proxmox_guest_start          → powers on the VM (type: 'vm')
 ```
 
 **Example — Setting up HA** (agent uses `proxmox-admin` skill):
@@ -212,9 +207,9 @@ Agent knows the workflow from the skill:
 You: "Make VM 100 highly available"
 
 Agent knows the operational playbook:
-  1. proxmox_get_ha_groups        → checks existing HA groups
-  2. proxmox_create_ha_resource   → adds VM 100 to HA with priority
-  3. proxmox_get_ha_status        → verifies HA is active
+  1. proxmox_ha_group             → checks existing HA groups (action: 'list')
+  2. proxmox_ha_resource          → adds VM 100 to HA with priority (action: 'create')
+  3. proxmox_ha_resource          → verifies HA is active (action: 'status')
 ```
 
 **Example — Troubleshooting** (agent uses both skills together):
@@ -222,10 +217,10 @@ Agent knows the operational playbook:
 You: "VM 100 won't start, help me figure out why"
 
 Agent combines tool knowledge + operational expertise:
-  1. proxmox_get_vm_status        → checks current state
-  2. proxmox_get_vm_config        → reviews configuration
-  3. proxmox_get_node_status      → checks node resource availability
-  4. proxmox_get_node_tasks       → finds recent failed tasks
+  1. proxmox_guest_status         → checks current state (type: 'vm')
+  2. proxmox_guest_config         → reviews configuration (action: 'get', type: 'vm')
+  3. proxmox_node                 → checks node resource availability (action: 'status')
+  4. proxmox_node_task            → finds recent failed tasks (action: 'list')
   → Diagnoses: "Node pve1 has insufficient memory. VM requires 8GB but only 2GB free."
   → Suggests: resize VM memory, migrate to another node, or free resources
 ```
@@ -233,7 +228,7 @@ Agent combines tool knowledge + operational expertise:
 ### Skill Contents
 
 **proxmox-mcp-tools** — Tool Reference:
-- 309 tools organized into 14 domains (VMs, LXC, cluster, storage, networking, Ceph, access control, pools, certificates, ACME, notifications)
+- 91 tools organized into 14 domains (VMs, LXC, cluster, storage, networking, Ceph, access control, pools, certificates, ACME, notifications)
 - Parameters, types, and descriptions for every tool
 - Permission levels (basic vs elevated 🔒)
 - Common workflow patterns (create VM, backup/restore, clone, migrate)

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAQA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B1C"}

package/dist/index.js

@@ -3,9 +3,13 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { loadConfig } from './config/index.js';
 import { ProxmoxApiClient } from './client/proxmox.js';
 import { createServer } from './server.js';
+import { TOOL_NAMES } from './types/tools.js';
 import { logger } from './utils/index.js';
 export async function main() {
     try {
+        if (process.env.NODE_TLS_REJECT_UNAUTHORIZED === '0') {
+            logger.warn('NODE_TLS_REJECT_UNAUTHORIZED=0 disables TLS certificate verification for all HTTPS requests. Remove it and use PROXMOX_SSL_MODE/PROXMOX_SSL_CA_CERT instead.');
+        }
         // Load configuration from environment variables
         const config = loadConfig();
         logger.info('Configuration loaded successfully');
@@ -14,7 +18,7 @@ export async function main() {
         logger.info('Proxmox API client initialized');
         // Create MCP server with all tools registered
         const server = createServer(client, config);
-        logger.info('MCP server created with 55 tools registered');
+        logger.info(`MCP server created with ${TOOL_NAMES.length} tools registered`);
         // Create stdio transport and connect server
         const transport = new StdioServerTransport();
         await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAEjD,4BAA4B;QAC5B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAE9C,8CAA8C;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAE3D,4CAA4C;QAC5C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,4BAA4B,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,6BAA6B;AAC7B,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,sCAAsC;AACtC,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,mBAAmB;AACnB,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,GAAG,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CACT,8JAA8J,CAC/J,CAAC;QACJ,CAAC;QAED,gDAAgD;QAChD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAEjD,4BAA4B;QAC5B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAE9C,8CAA8C;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,2BAA2B,UAAU,CAAC,MAAM,mBAAmB,CAAC,CAAC;QAE7E,4CAA4C;QAC5C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,4BAA4B,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,6BAA6B;AAC7B,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,sCAAsC;AACtC,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,mBAAmB;AACnB,IAAI,EAAE,CAAC"}