vme-mcp-server 0.1.10 → 0.1.13

package/README.md

@@ -18,18 +18,37 @@ npm install -g vme-mcp-server
 
 ### 2. Configure VME API Access
 
+**Option A: Command Line Arguments (Recommended)**
+
+```bash
+vme-mcp-server --endpoint https://your-vme-instance.com/api --token your-bearer-token
+# Or use short forms:
+vme-mcp-server -e https://your-vme-instance.com/api -t your-bearer-token
+```
+
+**Option B: Environment Variables**
+
+```bash
+export VME_ENDPOINT=https://your-vme-instance.com/api
+export VME_TOKEN=your-bearer-token-here
+```
+
+**Option C: Configuration File**
+
 Create a `.env` file:
 ```env
-VME_API_BASE_URL=https://your-vme-instance.com/api
-VME_API_TOKEN=your-bearer-token-here
+VME_ENDPOINT=https://your-vme-instance.com/api
+VME_TOKEN=your-bearer-token-here
 ```
 
+**Priority Order**: Command line arguments → Environment variables → .env files
+
 ### 3. Add to Claude Code
 
 **Option A: Using Claude Code CLI (Recommended)**
 
 ```bash
-claude mcp add vme-server -- vme-mcp-server
+claude mcp add vme-server -- vme-mcp-server --endpoint https://your-vme-instance.com/api --token your-bearer-token
 ```
 
 **Option B: Manual Configuration**
@@ -40,12 +59,23 @@ Add to your Claude Code configuration file:
 {
   "mcpServers": {
     "vme-server": {
-      "command": "npx",
-      "args": ["tsx", "src/server.ts"],
-      "cwd": "/path/to/vme-mcp-server",
+      "command": "vme-mcp-server",
+      "args": ["--endpoint", "https://your-vme-instance.com/api", "--token", "your-bearer-token"]
+    }
+  }
+}
+```
+
+**Option C: Using Environment Variables**
+
+```json
+{
+  "mcpServers": {
+    "vme-server": {
+      "command": "vme-mcp-server",
       "env": {
-        "VME_API_BASE_URL": "https://your-vme-instance.com/api",
-        "VME_API_TOKEN": "your-bearer-token"
+        "VME_ENDPOINT": "https://your-vme-instance.com/api",
+        "VME_TOKEN": "your-bearer-token"
       }
     }
   }

package/dist/README.md

@@ -10,20 +10,39 @@ npm install -g vme-mcp-server
 
 ## Quick Start
 
-### 1. Configure Environment
+### 1. Configure VME API Access
+
+**Option A: Command Line Arguments (Recommended)**
+
+```bash
+vme-mcp-server --endpoint https://your-hpe-vme-instance.com/api --token your-bearer-token
+# Or use short forms:
+vme-mcp-server -e https://your-hpe-vme-instance.com/api -t your-bearer-token
+```
+
+**Option B: Environment Variables**
+
+```bash
+export VME_ENDPOINT=https://your-hpe-vme-instance.com/api
+export VME_TOKEN=your-bearer-token
+```
+
+**Option C: Configuration File**
 
 Create a `.env` file:
 
 ```bash
 # HPE VM Essentials Configuration
-VME_API_BASE_URL=https://your-hpe-vme-instance.com/api
-VME_API_TOKEN=your-bearer-token
+VME_ENDPOINT=https://your-hpe-vme-instance.com/api
+VME_TOKEN=your-bearer-token
 
 # Privacy Controls (Optional)
 ENABLE_AI_TRAINING_DATA=false
 AI_TRAINING_DATA_RETENTION_DAYS=30
 ```
 
+**Priority Order**: Command line arguments → Environment variables → .env files
+
 ### 2. Add to Claude Desktop
 
 Add to your Claude Desktop configuration file:
@@ -31,6 +50,37 @@ Add to your Claude Desktop configuration file:
 **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
 
+**Option A: With Command Line Arguments**
+
+```json
+{
+  "mcpServers": {
+    "vme": {
+      "command": "vme-mcp-server",
+      "args": ["--endpoint", "https://your-hpe-vme-instance.com/api", "--token", "your-bearer-token"]
+    }
+  }
+}
+```
+
+**Option B: With Environment Variables**
+
+```json
+{
+  "mcpServers": {
+    "vme": {
+      "command": "vme-mcp-server",
+      "env": {
+        "VME_ENDPOINT": "https://your-hpe-vme-instance.com/api",
+        "VME_TOKEN": "your-bearer-token"
+      }
+    }
+  }
+}
+```
+
+**Option C: Using .env File**
+
 ```json
 {
   "mcpServers": {
@@ -101,9 +151,15 @@ The server automatically searches for `.env` files in multiple locations:
 
 ### Recommended Configuration Methods
 
-**Method 1: Direct Environment Variables (Best for Global Install)**
+**Method 1: Command Line Arguments (Recommended)**
+
+```bash
+vme-mcp-server --endpoint https://your-hpe-vme-instance.com/api --token your-bearer-token
+```
+
+**Method 2: Direct Environment Variables**
 
-Add to your Claude Desktop config (`~/.config/claude-desktop/config.json`):
+Add to your Claude Desktop config:
 
 ```json
 {
@@ -111,15 +167,15 @@ Add to your Claude Desktop config (`~/.config/claude-desktop/config.json`):
     "vme-mcp-server": {
       "command": "vme-mcp-server",
       "env": {
-        "VME_API_BASE_URL": "https://your-hpe-vme-instance.com/api",
-        "VME_API_TOKEN": "your-bearer-token"
+        "VME_ENDPOINT": "https://your-hpe-vme-instance.com/api",
+        "VME_TOKEN": "your-bearer-token"
       }
     }
   }
 }
 ```
 
-**Method 2: .env File (Good for Local Development)**
+**Method 3: .env File (Good for Local Development)**
 
 Create `.env` file in any of the supported locations above.
 
@@ -127,8 +183,8 @@ Create `.env` file in any of the supported locations above.
 
 | Variable | Description | Example |
 |----------|-------------|---------|
-| `VME_API_BASE_URL` | HPE VM Essentials API endpoint | `https://vme.company.com/api` |
-| `VME_API_TOKEN` | Bearer token for authentication | `your-bearer-token` |
+| `VME_ENDPOINT` | HPE VM Essentials API endpoint | `https://vme.company.com/api` |
+| `VME_TOKEN` | Bearer token for authentication | `your-bearer-token` |
 
 ### Optional Environment Variables
 
@@ -148,8 +204,8 @@ Create `.env` file in any of the supported locations above.
 - Verify MCP configuration syntax in `claude_desktop_config.json`
 
 **"API connection failed"**
-- Verify `VME_API_BASE_URL` is correct and accessible
-- Check that `VME_API_TOKEN` has sufficient permissions
+- Verify `VME_ENDPOINT` is correct and accessible
+- Check that `VME_TOKEN` has sufficient permissions
 - Ensure network connectivity to HPE VM Essentials infrastructure
 
 **"VM creation failed"**
@@ -176,6 +232,6 @@ Built with TypeScript and the Model Context Protocol for seamless Claude integra
 
 ## Version
 
-Current version: 0.1.10
+Current version: 0.1.11
 
 For development documentation and contribution guidelines, see the project repository.

package/dist/lib/api-utils.js

@@ -1,23 +1,35 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getResources = exports.resolveInput = exports.getClusterNodes = exports.api = void 0;
-const axios_1 = __importDefault(require("axios"));
-// Setup axios instance for VME API
-exports.api = axios_1.default.create({
-    baseURL: process.env.VME_API_BASE_URL,
-    headers: {
-        Authorization: `Bearer ${process.env.VME_API_TOKEN}`,
-        "Content-Type": "application/json"
+import axios from "axios";
+// Lazy axios instance creation to ensure environment variables are loaded
+let _api = null;
+function createApiInstance() {
+    if (!_api) {
+        console.log('VME API Configuration:');
+        console.log('  Base URL:', process.env.VME_API_BASE_URL);
+        console.log('  Token:', process.env.VME_API_TOKEN ? '***configured***' : 'NOT SET');
+        if (!process.env.VME_API_BASE_URL || !process.env.VME_API_TOKEN) {
+            throw new Error('VME API credentials not configured. Please check your .env file.');
+        }
+        _api = axios.create({
+            baseURL: process.env.VME_API_BASE_URL,
+            headers: {
+                Authorization: `Bearer ${process.env.VME_API_TOKEN}`,
+                "Content-Type": "application/json"
+            }
+        });
     }
-});
+    return _api;
+}
+export const api = {
+    get: (url) => createApiInstance().get(url),
+    post: (url, data) => createApiInstance().post(url, data),
+    put: (url, data) => createApiInstance().put(url, data),
+    delete: (url) => createApiInstance().delete(url)
+};
 // Helper function to get available cluster nodes (hypervisor hosts, not VMs)
-async function getClusterNodes() {
+export async function getClusterNodes() {
     try {
         // Get actual cluster hypervisor nodes from /clusters endpoint
-        const clusters = await exports.api.get("/clusters");
+        const clusters = await api.get("/clusters");
         let allNodes = [];
         if (clusters.data.clusters) {
             for (const cluster of clusters.data.clusters) {
@@ -41,14 +53,13 @@ async function getClusterNodes() {
     console.warn('Using fallback hypervisor nodes [1, 2, 3] - could not detect cluster hosts');
     return [1, 2, 3];
 }
-exports.getClusterNodes = getClusterNodes;
 // Resolve user input parameters to VME API resource IDs
-async function resolveInput({ group, cloud, template, size }) {
+export async function resolveInput({ group, cloud, template, size }) {
     const [groups, zones, instanceTypes, servicePlans] = await Promise.all([
-        exports.api.get("/groups"),
-        exports.api.get("/zones"),
-        exports.api.get("/instance-types"),
-        exports.api.get("/service-plans")
+        api.get("/groups"),
+        api.get("/zones"),
+        api.get("/instance-types"),
+        api.get("/service-plans")
     ]);
     // Find group (case-insensitive)
     const foundGroup = groups.data.groups.find((g) => g.name.toLowerCase() === group.toLowerCase());
@@ -61,7 +72,7 @@ async function resolveInput({ group, cloud, template, size }) {
     let selectedImage;
     const templateLower = template.toLowerCase();
     // Get available images to find the right one
-    const images = await exports.api.get("/virtual-images");
+    const images = await api.get("/virtual-images");
     if (templateLower.includes('ubuntu')) {
         // Find Ubuntu images using osType.category and prefer latest version
         const ubuntuImages = images.data.virtualImages.filter((img) => img.osType && img.osType.category === 'ubuntu').sort((a, b) => {
@@ -156,18 +167,17 @@ async function resolveInput({ group, cloud, template, size }) {
         availableZones: zones.data.zones.map((z) => z.name)
     };
 }
-exports.resolveInput = resolveInput;
 // Unified resource discovery function
-async function getResources(type, intent, role) {
+export async function getResources(type, intent, role) {
     try {
         // Fetch all resource types in parallel for comprehensive discovery
         const [groups, zones, instanceTypes, servicePlans, virtualImages, clusters] = await Promise.all([
-            exports.api.get("/groups"),
-            exports.api.get("/zones"),
-            exports.api.get("/instance-types"),
-            exports.api.get("/service-plans"),
-            exports.api.get("/virtual-images"),
-            exports.api.get("/clusters")
+            api.get("/groups"),
+            api.get("/zones"),
+            api.get("/instance-types"),
+            api.get("/service-plans"),
+            api.get("/virtual-images"),
+            api.get("/clusters")
         ]);
         const allResources = {
             groups: groups.data.groups || [],
@@ -261,4 +271,3 @@ async function getResources(type, intent, role) {
         };
     }
 }
-exports.getResources = getResources;

package/dist/lib/capability-cache.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.capabilityCache = exports.SmartCapabilityCache = void 0;
-const api_utils_js_1 = require("./api-utils.js");
+import { api } from "./api-utils.js";
 // Smart capability cache with field-level TTL
-class SmartCapabilityCache {
+export class SmartCapabilityCache {
     constructor() {
         this.cache = new Map();
         // TTL configuration based on VME resource change patterns
@@ -34,7 +31,7 @@ class SmartCapabilityCache {
         // Fetch fresh data from VME API
         const endpoint = this.getEndpointForField(fieldName);
         try {
-            const response = await api_utils_js_1.api.get(endpoint);
+            const response = await api.get(endpoint);
             // Store in cache with appropriate TTL
             const cacheEntry = {
                 data: response.data,
@@ -126,6 +123,5 @@ class SmartCapabilityCache {
         return endpointMap[fieldName] || `/${fieldName}`;
     }
 }
-exports.SmartCapabilityCache = SmartCapabilityCache;
 // Global cache instance
-exports.capabilityCache = new SmartCapabilityCache();
+export const capabilityCache = new SmartCapabilityCache();

package/dist/lib/capability-discovery.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.capabilityDiscovery = exports.CapabilityDiscoveryEngine = void 0;
-const capability_cache_js_1 = require("./capability-cache.js");
+import { capabilityCache } from "./capability-cache.js";
 // Capability discovery engine
-class CapabilityDiscoveryEngine {
+export class CapabilityDiscoveryEngine {
     /**
      * Discover capabilities for specified domains
      */
@@ -108,10 +105,10 @@ class CapabilityDiscoveryEngine {
     // Private discovery methods for each domain
     async discoverComputeCapabilities(forceRefresh = false) {
         const [clusters, servicePlans, instanceTypes, virtualImages] = await Promise.all([
-            capability_cache_js_1.capabilityCache.getField("clusters", forceRefresh),
-            capability_cache_js_1.capabilityCache.getField("service_plans", forceRefresh),
-            capability_cache_js_1.capabilityCache.getField("instance_types", forceRefresh),
-            capability_cache_js_1.capabilityCache.getField("virtual_images", forceRefresh),
+            capabilityCache.getField("clusters", forceRefresh),
+            capabilityCache.getField("service_plans", forceRefresh),
+            capabilityCache.getField("instance_types", forceRefresh),
+            capabilityCache.getField("virtual_images", forceRefresh),
         ]);
         // Derive hypervisors from cluster data
         const hypervisors = new Set();
@@ -172,8 +169,8 @@ class CapabilityDiscoveryEngine {
     }
     async discoverNetworkingCapabilities(forceRefresh = false) {
         const [zones, networks] = await Promise.all([
-            capability_cache_js_1.capabilityCache.getField("zones", forceRefresh),
-            capability_cache_js_1.capabilityCache.getField("networks", forceRefresh).catch(() => null), // Optional
+            capabilityCache.getField("zones", forceRefresh),
+            capabilityCache.getField("networks", forceRefresh).catch(() => null), // Optional
         ]);
         const zoneList = zones?.zones?.map((zone) => ({
             id: zone.id,
@@ -189,7 +186,7 @@ class CapabilityDiscoveryEngine {
     }
     async discoverStorageCapabilities(forceRefresh = false) {
         // Get real data from VME API
-        const servicePlans = await capability_cache_js_1.capabilityCache.getField("service_plans", forceRefresh);
+        const servicePlans = await capabilityCache.getField("service_plans", forceRefresh);
         // Derive storage capabilities from actual service plans and other data
         const storageTypes = new Set();
         let maxVolumeSize = "1TB"; // Default
@@ -214,7 +211,7 @@ class CapabilityDiscoveryEngine {
         };
     }
     async discoverPlatformCapabilities(forceRefresh = false) {
-        const groups = await capability_cache_js_1.capabilityCache.getField("groups", forceRefresh);
+        const groups = await capabilityCache.getField("groups", forceRefresh);
         const groupList = groups?.groups?.map((group) => ({
             id: group.id,
             name: group.name,
@@ -227,7 +224,7 @@ class CapabilityDiscoveryEngine {
         };
     }
     getCacheStatusSummary() {
-        const statuses = capability_cache_js_1.capabilityCache.getCacheStatus();
+        const statuses = capabilityCache.getCacheStatus();
         return statuses.map(status => ({
             field: status.field_name,
             fresh: status.is_fresh,
@@ -235,6 +232,5 @@ class CapabilityDiscoveryEngine {
         }));
     }
 }
-exports.CapabilityDiscoveryEngine = CapabilityDiscoveryEngine;
 // Global discovery engine instance
-exports.capabilityDiscovery = new CapabilityDiscoveryEngine();
+export const capabilityDiscovery = new CapabilityDiscoveryEngine();

package/dist/lib/intent-recognition.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseVMIntent = void 0;
-const vm_parsing_js_1 = require("./vm-parsing.js");
+import { parseVMNames } from "./vm-parsing.js";
 // Intent recognition system for natural language processing
-function parseVMIntent(naturalLanguageInput) {
+export function parseVMIntent(naturalLanguageInput) {
     const input = naturalLanguageInput.toLowerCase().trim();
     const result = {
         action: 'unknown',
@@ -71,7 +68,7 @@ function parseVMIntent(naturalLanguageInput) {
             const match = input.match(pattern);
             if (match) {
                 const nameInput = match[1] || match[2];
-                result.entities.vmNames = (0, vm_parsing_js_1.parseVMNames)(nameInput);
+                result.entities.vmNames = parseVMNames(nameInput);
                 break;
             }
         }
@@ -156,4 +153,3 @@ function parseVMIntent(naturalLanguageInput) {
     }
     return result;
 }
-exports.parseVMIntent = parseVMIntent;

package/dist/lib/name-resolver.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nameResolver = exports.NameResolver = void 0;
-const capability_discovery_js_1 = require("./capability-discovery.js");
+import { capabilityDiscovery } from "./capability-discovery.js";
 // Generic name->ID resolver using capability discovery data
-class NameResolver {
+export class NameResolver {
     constructor() {
         this.capabilitiesCache = null;
         this.cacheTimestamp = 0;
@@ -12,7 +9,7 @@ class NameResolver {
     async getCapabilities() {
         const now = Date.now();
         if (!this.capabilitiesCache || (now - this.cacheTimestamp) > this.CACHE_TTL) {
-            this.capabilitiesCache = await capability_discovery_js_1.capabilityDiscovery.discoverCapabilities(['all']);
+            this.capabilitiesCache = await capabilityDiscovery.discoverCapabilities(['all']);
             this.cacheTimestamp = now;
         }
         return this.capabilitiesCache;
@@ -169,6 +166,5 @@ class NameResolver {
         return results;
     }
 }
-exports.NameResolver = NameResolver;
 // Global resolver instance
-exports.nameResolver = new NameResolver();
+export const nameResolver = new NameResolver();

package/dist/lib/session.js

@@ -1,27 +1,23 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.logInteraction = exports.generateSessionId = void 0;
-const fs_1 = require("fs");
-const path_1 = require("path");
+import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
 // AI Training Data Collection Configuration
 const AI_TRAINING_ENABLED = process.env.ENABLE_AI_TRAINING_DATA === 'true';
 const AI_TRAINING_FIELDS = (process.env.AI_TRAINING_DATA_FIELDS || 'user_input,parsed_output,success_metrics').split(',');
 const AI_TRAINING_RETENTION_DAYS = parseInt(process.env.AI_TRAINING_DATA_RETENTION_DAYS || '30');
 // Generate session ID for interaction tracking
-function generateSessionId() {
+export function generateSessionId() {
     return `session-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
 }
-exports.generateSessionId = generateSessionId;
 // Privacy-aware interaction logging
-function logInteraction(interaction) {
+export function logInteraction(interaction) {
     if (!AI_TRAINING_ENABLED) {
         return; // Respect user privacy choice
     }
     try {
         // Ensure logs directory exists
-        const logsDir = (0, path_1.join)(process.cwd(), 'ai-training-logs');
-        if (!(0, fs_1.existsSync)(logsDir)) {
-            (0, fs_1.mkdirSync)(logsDir, { recursive: true });
+        const logsDir = join(process.cwd(), 'ai-training-logs');
+        if (!existsSync(logsDir)) {
+            mkdirSync(logsDir, { recursive: true });
         }
         // Filter fields based on user preferences
         const filteredInteraction = {
@@ -47,13 +43,12 @@ function logInteraction(interaction) {
             filteredInteraction.timing = interaction.timing;
         }
         // Append to daily log file (JSONL format)
-        const logFile = (0, path_1.join)(logsDir, `interactions-${new Date().toISOString().split('T')[0]}.jsonl`);
+        const logFile = join(logsDir, `interactions-${new Date().toISOString().split('T')[0]}.jsonl`);
         const logEntry = JSON.stringify(filteredInteraction) + '\n';
-        (0, fs_1.writeFileSync)(logFile, logEntry, { flag: 'a' });
+        writeFileSync(logFile, logEntry, { flag: 'a' });
     }
     catch (error) {
         // Fail silently to not disrupt user experience
         console.warn('AI training data logging failed:', error);
     }
 }
-exports.logInteraction = logInteraction;

package/dist/lib/vm-parsing.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateNodeAssignments = exports.parseVMNames = void 0;
 // Helper function to parse VM name patterns
-function parseVMNames(nameInput, count) {
+export function parseVMNames(nameInput, count) {
     // Handle letter range patterns like "ws-a->ws-x" or "ws-a -> ws-x"
     const letterRangeMatch = nameInput.match(/^(.+?)([a-z])\s*->\s*(.+?)([a-z])$/i);
     if (letterRangeMatch) {
@@ -62,9 +59,8 @@ function parseVMNames(nameInput, count) {
     // Single VM
     return [nameInput];
 }
-exports.parseVMNames = parseVMNames;
 // Determine node assignment strategy for VMs
-function calculateNodeAssignments(vmNames, nodes, distribution) {
+export function calculateNodeAssignments(vmNames, nodes, distribution) {
     let nodeAssignments = [];
     if (distribution === 'spread' || (vmNames.length > 1 && !distribution)) {
         // Distribute VMs across all available nodes
@@ -87,4 +83,3 @@ function calculateNodeAssignments(vmNames, nodes, distribution) {
     }
     return nodeAssignments;
 }
-exports.calculateNodeAssignments = calculateNodeAssignments;