@rishibhushan/jenkins-mcp-server 1.0.3 → 1.0.4

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

@@ -172,13 +172,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 +209,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');
 }
 
 /**

package/package.json

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