@rishibhushan/jenkins-mcp-server 1.0.3 → 1.0.5

package/README.md

@@ -346,6 +346,72 @@ Add to `claude_desktop_config.json`:
 
 ---
 
+## 🏢 Corporate Network / Proxy Setup
+
+If you're behind a corporate proxy or firewall:
+
+### Option 1: Set Environment Variables (Recommended)
+```bash
+# Set proxy environment variables
+export HTTP_PROXY=http://your-proxy:8080
+export HTTPS_PROXY=http://your-proxy:8080
+export NO_PROXY=localhost,127.0.0.1
+
+# Run the server (wrapper will auto-detect proxy)
+npx @rishibhushan/jenkins-mcp-server --env-file .env
+```
+
+### Option 2: Configure npm and pip
+```bash
+# Configure npm proxy
+npm config set proxy http://your-proxy:8080
+npm config set https-proxy http://your-proxy:8080
+
+# Configure pip proxy (for SSL issues)
+pip config set global.proxy http://your-proxy:8080
+pip config set global.trusted-host "pypi.org pypi.python.org files.pythonhosted.org"
+
+# Run the server
+npx @rishibhushan/jenkins-mcp-server --env-file .env
+```
+
+### Option 3: Claude Desktop with Proxy
+
+Add proxy settings to your `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "jenkins": {
+      "command": "npx",
+      "args": [
+        "@rishibhushan/jenkins-mcp-server",
+        "--env-file",
+        "/path/to/.env"
+      ],
+      "env": {
+        "HTTP_PROXY": "http://your-proxy:8080",
+        "HTTPS_PROXY": "http://your-proxy:8080",
+        "NO_PROXY": "localhost,127.0.0.1"
+      }
+    }
+  }
+}
+```
+
+### SSL Certificate Issues
+
+If you encounter SSL certificate errors:
+```bash
+# Disable SSL verification for pip (one-time setup)
+pip config set global.trusted-host "pypi.org pypi.python.org files.pythonhosted.org"
+
+# Or use environment variable
+export PIP_TRUSTED_HOST="pypi.org pypi.python.org files.pythonhosted.org"
+```
+
+The Node.js wrapper automatically handles SSL certificate issues when it detects proxy environment variables.
+
+---
 ## 💡 Usage Examples
 
 ### Natural Language Commands

package/bin/jenkins-mcp.js

@@ -30,9 +30,10 @@ const colors = {
 };
 
 function log(message, color = 'reset') {
-  const colorCode = process.stdout.isTTY ? colors[color] : '';
-  const resetCode = process.stdout.isTTY ? colors.reset : '';
-  console.log(`${colorCode}${message}${resetCode}`);
+  const colorCode = process.stderr.isTTY ? colors[color] : '';
+  const resetCode = process.stderr.isTTY ? colors.reset : '';
+  // CRITICAL: Use stderr for all output, stdout is for JSON-RPC only
+  console.error(`${colorCode}${message}${resetCode}`);
 }
 
 function error(message) {
@@ -172,13 +173,36 @@ function installDependencies(venvPath) {
   log('Installing Python dependencies...', 'yellow');
   log('This may take a minute...', 'blue');
 
-  const result = spawnSync(pip, ['install', '-r', requirementsPath], {
+  // Build pip install command with proxy-friendly options
+  const pipArgs = ['install', '-r', requirementsPath];
+
+  // Add proxy-friendly options to handle corporate networks
+  const proxyFriendlyArgs = [
+    '--trusted-host', 'pypi.org',
+    '--trusted-host', 'pypi.python.org',
+    '--trusted-host', 'files.pythonhosted.org'
+  ];
+
+  // Add proxy if environment variable is set
+  const proxy = process.env.HTTP_PROXY || process.env.http_proxy ||
+                process.env.HTTPS_PROXY || process.env.https_proxy;
+
+  if (proxy) {
+    log(`Using proxy: ${proxy}`, 'blue');
+    pipArgs.push('--proxy', proxy);
+  }
+
+  // Add all proxy-friendly args
+  pipArgs.push(...proxyFriendlyArgs);
+
+  // Install requirements
+  const installReqs = spawnSync(pip, pipArgs, {
     cwd: projectRoot,
     stdio: 'inherit'
   });
 
-  if (result.status !== 0) {
-    error('Failed to install dependencies');
+  if (installReqs.status !== 0) {
+    error('Failed to install dependencies from requirements.txt');
     console.error('\nTroubleshooting:');
     console.error('  1. Check your internet connection');
     console.error('  2. If behind a proxy, set HTTP_PROXY/HTTPS_PROXY env vars');
@@ -186,7 +210,33 @@ function installDependencies(venvPath) {
     process.exit(1);
   }
 
-  log('✓ Dependencies installed', 'green');
+  log('✓ Requirements installed', 'green');
+
+  // Install the package itself in editable mode
+  log('Installing jenkins-mcp-server package...', 'yellow');
+
+  const packageArgs = ['install', '-e', '.'];
+
+  // Add same proxy-friendly options
+  if (proxy) {
+    packageArgs.push('--proxy', proxy);
+  }
+  packageArgs.push(...proxyFriendlyArgs);
+
+  const installPkg = spawnSync(pip, packageArgs, {
+    cwd: projectRoot,
+    stdio: 'inherit'
+  });
+
+  if (installPkg.status !== 0) {
+    error('Failed to install jenkins-mcp-server package');
+    console.error('\nTroubleshooting:');
+    console.error('  1. Ensure pyproject.toml or setup.py exists');
+    console.error('  2. Try manually: .venv/bin/pip install -e .');
+    process.exit(1);
+  }
+
+  log('✓ Package installed', 'green');
 }
 
 /**
@@ -239,27 +289,43 @@ function runServer(venvPath) {
   const env = {
     ...process.env,
     PYTHONPATH: path.join(projectRoot, 'src'),
-    PYTHONUNBUFFERED: '1'  // Ensure output is not buffered
+    PYTHONUNBUFFERED: '1'
   };
 
   const serverArgs = [...entryPoint.args, ...args];
 
+  // All logging to stderr (stdout reserved for JSON-RPC)
+  console.error('=== NODE WRAPPER DEBUG ===');
+  console.error('Project root:', projectRoot);
+  console.error('Python path:', python);
+  console.error('Entry point:', entryPoint);
+  console.error('Server args:', serverArgs);
+  console.error('PYTHONPATH:', env.PYTHONPATH);
+  console.error('=== ATTEMPTING TO START PYTHON ===');
+
   log('Starting Jenkins MCP Server...', 'green');
   log(`Command: ${python} ${serverArgs.join(' ')}`, 'blue');
 
+  // CRITICAL: stdin=pipe, stdout=inherit (for JSON-RPC), stderr=inherit (for logs)
   const server = spawn(python, serverArgs, {
     cwd: projectRoot,
-    stdio: 'inherit',
+    stdio: ['pipe', 'inherit', 'inherit'],
     env: env,
     shell: isWindows
   });
 
   server.on('error', (err) => {
+    console.error('=== SPAWN ERROR ===', err);
     error(`Failed to start server: ${err.message}`);
     process.exit(1);
   });
 
-  server.on('close', (code) => {
+  server.on('spawn', () => {
+    console.error('=== PYTHON PROCESS SPAWNED ===');
+  });
+
+  server.on('close', (code, signal) => {
+    console.error(`=== PYTHON PROCESS CLOSED: code=${code}, signal=${signal} ===`);
     if (code !== 0 && code !== null) {
       log(`Server exited with code ${code}`, 'yellow');
     }
@@ -288,14 +354,14 @@ function main() {
   try {
     // Check for help flag
     if (args.includes('--help') || args.includes('-h')) {
-      console.log('Jenkins MCP Server - Node.js Wrapper');
-      console.log('\nUsage: jenkins-mcp-server [options]');
-      console.log('\nOptions:');
-      console.log('  --env-file PATH    Path to custom .env file');
-      console.log('  --verbose, -v      Enable verbose logging');
-      console.log('  --no-vscode        Skip loading VS Code settings');
-      console.log('  --version          Show version');
-      console.log('  --help, -h         Show this help message');
+      console.error('Jenkins MCP Server - Node.js Wrapper');
+      console.error('\nUsage: jenkins-mcp-server [options]');
+      console.error('\nOptions:');
+      console.error('  --env-file PATH    Path to custom .env file');
+      console.error('  --verbose, -v      Enable verbose logging');
+      console.error('  --no-vscode        Skip loading VS Code settings');
+      console.error('  --version          Show version');
+      console.error('  --help, -h         Show this help message');
       process.exit(0);
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rishibhushan/jenkins-mcp-server",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "AI-enabled Jenkins automation via Model Context Protocol (MCP)",
   "main": "bin/jenkins-mcp.js",
   "bin": {