vme-mcp-server 0.1.12 → 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"**

package/dist/server.js

@@ -8,6 +8,41 @@ import { join } from "path";
 import { homedir } from "os";
 import { readFileSync } from "fs";
 import { allTools, toolHandlers } from "./tools/index.js";
+// Parse command line arguments
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === '--endpoint' || arg === '-e') && i + 1 < args.length) {
+            result.endpoint = args[i + 1];
+            i++; // Skip next arg since we consumed it
+        }
+        else if ((arg === '--token' || arg === '-t') && i + 1 < args.length) {
+            result.token = args[i + 1];
+            i++; // Skip next arg since we consumed it
+        }
+        else if (arg === '--help' || arg === '-h') {
+            console.log(`VME MCP Server - Natural Language Infrastructure Management
+
+Usage: vme-mcp-server [options]
+
+Options:
+  -e, --endpoint <url>    VME API endpoint URL
+  -t, --token <token>     VME API bearer token
+  -h, --help             Show this help message
+
+Environment Variables:
+  VME_ENDPOINT           VME API endpoint URL
+  VME_TOKEN             VME API bearer token
+
+Note: Command line arguments take precedence over environment variables.
+      If no configuration is provided, the server will look for .env files.`);
+            process.exit(0);
+        }
+    }
+    return result;
+}
 // Get version from package.json
 function getPackageVersion() {
     const packagePath = new URL('../package.json', import.meta.url);
@@ -15,7 +50,7 @@ function getPackageVersion() {
     return packageJson.version;
 }
 // Load environment variables from multiple locations for global install support
-function loadEnvironmentConfig() {
+function loadEnvironmentConfig(cliArgs) {
     // Priority order for .env file locations:
     const envPaths = [
         // 1. Current working directory (for local development)
@@ -32,13 +67,27 @@ function loadEnvironmentConfig() {
         if (existsSync(envPath)) {
             dotenv.config({ path: envPath });
             console.error(`VME MCP: Loaded config from ${envPath}`);
-            return;
+            break;
         }
     }
-    // If no .env file found, that's okay - environment variables may be set directly
-    console.error('VME MCP: No .env file found, using direct environment variables');
+    // Command line arguments take highest priority - override any env vars
+    if (cliArgs.endpoint) {
+        process.env.VME_ENDPOINT = cliArgs.endpoint;
+        console.error('VME MCP: Using endpoint from command line argument');
+    }
+    if (cliArgs.token) {
+        process.env.VME_TOKEN = cliArgs.token;
+        console.error('VME MCP: Using token from command line argument');
+    }
+    // If no configuration found at all, warn the user
+    if (!process.env.VME_ENDPOINT || !process.env.VME_TOKEN) {
+        console.error('VME MCP: Warning - Missing VME_ENDPOINT or VME_TOKEN configuration');
+        console.error('VME MCP: Use --endpoint and --token arguments or set environment variables');
+    }
 }
-loadEnvironmentConfig();
+// Parse CLI arguments and load configuration
+const cliArgs = parseArgs();
+loadEnvironmentConfig(cliArgs);
 // Disable TLS verification for VME API (if needed)
 process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
 // Create VME MCP server with modular architecture

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vme-mcp-server",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "",
   "main": "dist/server.js",
   "bin": {