@rishibhushan/jenkins-mcp-server 1.1.0 → 1.1.3

package/bin/jenkins-mcp.js

@@ -5,7 +5,8 @@
  * This wrapper handles:
  * - Python version detection (cross-platform)
  * - Virtual environment creation
- * - Dependency installation
+ * - Smart proxy detection and handling (auto-detects corporate vs public networks)
+ * - Dependency installation with retry logic
  * - Server execution
  *
  * Supports: Windows, macOS, Linux
@@ -26,7 +27,9 @@ const colors = {
   green: '\x1b[32m',
   yellow: '\x1b[33m',
   red: '\x1b[31m',
-  blue: '\x1b[34m'
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  bold: '\x1b[1m'
 };
 
 function log(message, color = 'reset') {
@@ -40,6 +43,149 @@ function error(message) {
   console.error(`${colors.red}ERROR: ${message}${colors.reset}`);
 }
 
+function warning(message) {
+  console.error(`${colors.yellow}WARNING: ${message}${colors.reset}`);
+}
+
+function info(message) {
+  console.error(`${colors.cyan}ℹ ${message}${colors.reset}`);
+}
+
+/**
+ * Detect and display proxy configuration
+ * @returns {Object} Proxy configuration details
+ */
+function detectProxyConfig() {
+  const proxyVars = [
+    'HTTP_PROXY', 'http_proxy',
+    'HTTPS_PROXY', 'https_proxy',
+    'ALL_PROXY', 'all_proxy',
+    'NO_PROXY', 'no_proxy'
+  ];
+
+  const activeProxies = {};
+  for (const varName of proxyVars) {
+    if (process.env[varName]) {
+      activeProxies[varName] = process.env[varName];
+    }
+  }
+
+  return activeProxies;
+}
+
+/**
+ * Check npm config for proxy settings
+ * @returns {Object} npm proxy configuration
+ */
+function checkNpmProxy() {
+  try {
+    const result = spawnSync('npm', ['config', 'list'], {
+      stdio: 'pipe',
+      encoding: 'utf-8'
+    });
+
+    if (result.status === 0) {
+      const output = result.stdout || '';
+      const proxyLines = output.split('\n').filter(line =>
+        line.toLowerCase().includes('proxy') && !line.includes('; ///')
+      );
+
+      if (proxyLines.length > 0) {
+        return {
+          found: true,
+          config: proxyLines.join('\n')
+        };
+      }
+    }
+  } catch (e) {
+    // npm not available or error
+  }
+  return { found: false };
+}
+
+/**
+ * Check pip config for proxy settings
+ * @returns {Object} pip proxy configuration
+ */
+function checkPipProxy() {
+  try {
+    const result = spawnSync('pip3', ['config', 'list'], {
+      stdio: 'pipe',
+      encoding: 'utf-8'
+    });
+
+    if (result.status === 0) {
+      const output = result.stdout || '';
+      if (output.toLowerCase().includes('proxy')) {
+        return {
+          found: true,
+          config: output
+        };
+      }
+    }
+  } catch (e) {
+    // pip not available or error
+  }
+  return { found: false };
+}
+
+/**
+ * Test if proxy is reachable
+ * @param {string} proxyUrl - Proxy URL to test
+ * @returns {boolean} True if proxy is reachable
+ */
+function testProxyConnectivity(proxyUrl) {
+  try {
+    // Try to parse proxy URL
+    const url = new URL(proxyUrl);
+
+    // Use curl to test proxy connectivity (cross-platform)
+    const testCmd = isWindows
+      ? `curl -s -o NUL -w "%{http_code}" --proxy ${proxyUrl} --max-time 5 https://pypi.org/simple/`
+      : `curl -s -o /dev/null -w "%{http_code}" --proxy ${proxyUrl} --max-time 5 https://pypi.org/simple/`;
+
+    const result = spawnSync(isWindows ? 'cmd' : 'sh',
+      isWindows ? ['/c', testCmd] : ['-c', testCmd],
+      {
+        stdio: 'pipe',
+        encoding: 'utf-8',
+        timeout: 6000
+      }
+    );
+
+    const httpCode = result.stdout?.trim();
+    return httpCode === '200' || httpCode === '301' || httpCode === '302';
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * Test if PyPI is directly accessible (without proxy)
+ * @returns {boolean} True if PyPI is accessible
+ */
+function testDirectPyPIAccess() {
+  try {
+    const testCmd = isWindows
+      ? 'curl -s -o NUL -w "%{http_code}" --max-time 5 https://pypi.org/simple/'
+      : 'curl -s -o /dev/null -w "%{http_code}" --max-time 5 https://pypi.org/simple/';
+
+    const result = spawnSync(isWindows ? 'cmd' : 'sh',
+      isWindows ? ['/c', testCmd] : ['-c', testCmd],
+      {
+        stdio: 'pipe',
+        encoding: 'utf-8',
+        timeout: 6000
+      }
+    );
+
+    const httpCode = result.stdout?.trim();
+    return httpCode === '200' || httpCode === '301' || httpCode === '302';
+  } catch (e) {
+    return false;
+  }
+}
+
 /**
  * Check for Python 3 installation
  * @returns {string} Python command name
@@ -157,7 +303,115 @@ function dependenciesInstalled(pipPath) {
 }
 
 /**
- * Install Python dependencies
+ * Show helpful guidance for proxy-related installation failures
+ */
+function showProxyTroubleshooting(activeProxies, canAccessDirectly, proxyWorks) {
+  console.error('\n' + '='.repeat(70));
+  console.error(colors.bold + colors.yellow + 'INSTALLATION FAILED - NETWORK CONFIGURATION ISSUE' + colors.reset);
+  console.error('='.repeat(70));
+
+  // Check npm and pip config
+  const npmProxy = checkNpmProxy();
+  const pipProxy = checkPipProxy();
+
+  if (npmProxy.found) {
+    console.error('\n' + colors.red + '⚠️  FOUND PROXY IN NPM CONFIG!' + colors.reset);
+    console.error(colors.cyan + npmProxy.config + colors.reset);
+    console.error('\n' + colors.yellow + 'This is likely the cause of your issue!' + colors.reset);
+    console.error('\n' + colors.bold + 'FIX (run these commands):' + colors.reset);
+    console.error(colors.cyan + '  npm config delete proxy' + colors.reset);
+    console.error(colors.cyan + '  npm config delete https-proxy' + colors.reset);
+    console.error(colors.cyan + '  npm config delete http-proxy' + colors.reset);
+    console.error(colors.cyan + '  npm config --global delete proxy' + colors.reset);
+    console.error(colors.cyan + '  npm config --global delete https-proxy' + colors.reset);
+    console.error('\nThen run your command again.\n');
+  }
+
+  if (pipProxy.found) {
+    console.error('\n' + colors.red + '⚠️  FOUND PROXY IN PIP CONFIG!' + colors.reset);
+    console.error(colors.cyan + pipProxy.config + colors.reset);
+    console.error('\n' + colors.bold + 'FIX (run these commands):' + colors.reset);
+    console.error(colors.cyan + '  pip3 config unset global.proxy' + colors.reset);
+    console.error(colors.cyan + '  pip3 config unset user.proxy' + colors.reset);
+    console.error('\nOr edit/delete: ~/.config/pip/pip.conf\n');
+  }
+
+  if (Object.keys(activeProxies).length > 0) {
+    console.error('\n📡 Active proxy environment variables found:');
+    for (const [key, value] of Object.entries(activeProxies)) {
+      console.error(`   ${colors.cyan}${key}${colors.reset} = ${value}`);
+    }
+
+    if (!proxyWorks && canAccessDirectly) {
+      // Proxy is set but doesn't work, and direct access works
+      console.error('\n' + colors.red + '❌ Proxy is NOT reachable' + colors.reset);
+      console.error(colors.green + '✓ Direct internet access IS available' + colors.reset);
+      console.error('\n' + colors.yellow + '⚠️  You\'re on a PUBLIC network but have proxy settings from a corporate/VPN network!' + colors.reset);
+      console.error('\n💡 SOLUTION:\n');
+      console.error(colors.bold + 'Remove the proxy settings:' + colors.reset);
+      console.error(colors.cyan + '   unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy ALL_PROXY all_proxy' + colors.reset);
+      console.error('   Then run the command again.\n');
+
+    } else if (proxyWorks && !canAccessDirectly) {
+      // Proxy works, direct access doesn't
+      console.error('\n' + colors.green + '✓ Proxy IS reachable' + colors.reset);
+      console.error(colors.red + '❌ Direct internet access is NOT available' + colors.reset);
+      console.error('\n' + colors.blue + 'You\'re on a CORPORATE network - proxy is required.' + colors.reset);
+      console.error('\n💡 SOLUTION:\n');
+      console.error('The proxy should work. The error may be due to:');
+      console.error('1. SSL certificate issues - contact your IT department');
+      console.error('2. Authentication required - check if proxy needs username/password');
+      console.error('3. Specific packages blocked - contact your IT department\n');
+
+    } else if (!proxyWorks && !canAccessDirectly) {
+      // Neither works
+      console.error('\n' + colors.red + '❌ Proxy is NOT reachable' + colors.reset);
+      console.error(colors.red + '❌ Direct internet access is NOT available' + colors.reset);
+      console.error('\n💡 SOLUTIONS:\n');
+      console.error('1. Check your internet connection');
+      console.error('2. If on corporate network, verify proxy settings with IT');
+      console.error('3. Try a different network (mobile hotspot, home WiFi)');
+      console.error('4. Check firewall/antivirus settings\n');
+
+    } else {
+      // Both work (unusual case)
+      console.error('\n' + colors.green + '✓ Proxy IS reachable' + colors.reset);
+      console.error(colors.green + '✓ Direct internet access IS available' + colors.reset);
+      console.error('\nThe issue may be:');
+      console.error('1. SSL certificate problems');
+      console.error('2. Intermittent connectivity');
+      console.error('3. Package-specific blocking\n');
+    }
+
+    console.error(colors.bold + 'Additional options:' + colors.reset);
+    console.error('• Check system proxy settings:');
+    if (!isWindows) {
+      console.error('  macOS: System Settings → Network → Advanced → Proxies');
+    } else {
+      console.error('  Windows: Settings → Network & Internet → Proxy');
+    }
+    console.error('• Try manual installation (see TROUBLESHOOTING.md)');
+
+  } else {
+    console.error('\n💡 No proxy environment variables detected.\n');
+    console.error('POSSIBLE CAUSES:');
+    console.error('• Network connectivity issues');
+    console.error('• Firewall blocking PyPI access');
+    console.error('• DNS resolution problems');
+    console.error('• System-level proxy (not in environment variables)\n');
+
+    console.error('SOLUTIONS TO TRY:');
+    console.error('1. Check your internet connection');
+    console.error('2. Try: curl https://pypi.org/simple/');
+    console.error('3. Check firewall/antivirus settings');
+    console.error('4. Check system proxy settings (not environment variables)\n');
+  }
+
+  console.error('='.repeat(70) + '\n');
+}
+
+/**
+ * Install Python dependencies with smart proxy detection
  * @param {string} venvPath - Path to virtual environment
  */
 function installDependencies(venvPath) {
@@ -171,11 +425,10 @@ function installDependencies(venvPath) {
   if (fs.existsSync(wheelsPath)) {
     console.error('Using pre-packaged wheels (no internet required)...');
 
-    // Install from local wheels (fast, no network needed)
     const installReqs = spawnSync(pip, [
       'install',
-      '--no-index',  // Don't use PyPI
-      '--find-links', wheelsPath,  // Use local wheels
+      '--no-index',
+      '--find-links', wheelsPath,
       '-r', requirementsPath
     ], {
       cwd: projectRoot,
@@ -186,38 +439,111 @@ function installDependencies(venvPath) {
       error('Failed to install from wheels');
       process.exit(1);
     }
+
+    log('✓ Requirements installed', 'green');
   } else {
-    // Fallback to normal install with proxy support
+    // Need network - detect proxy configuration intelligently
     console.error('Downloading from PyPI...');
+
+    const activeProxies = detectProxyConfig();
+    const hasProxyVars = Object.keys(activeProxies).length > 0;
+
+    let proxyToUse = null;
+    let useNoProxy = false;
+
+    if (hasProxyVars) {
+      const proxyUrl = process.env.HTTP_PROXY || process.env.http_proxy ||
+                       process.env.HTTPS_PROXY || process.env.https_proxy;
+
+      info('Proxy environment variables detected. Testing connectivity...');
+
+      // Test proxy connectivity
+      const proxyWorks = proxyUrl && proxyUrl.startsWith('http') && testProxyConnectivity(proxyUrl);
+      const directWorks = testDirectPyPIAccess();
+
+      if (proxyWorks && !directWorks) {
+        // Corporate network - use proxy
+        info('Corporate network detected. Using proxy.');
+        proxyToUse = proxyUrl;
+      } else if (!proxyWorks && directWorks) {
+        // Public network with stale proxy vars - ignore proxy
+        warning('Proxy unreachable but direct access available. Ignoring proxy settings.');
+        useNoProxy = true;
+      } else if (proxyWorks && directWorks) {
+        // Both work - prefer direct
+        info('Both proxy and direct access available. Using direct connection.');
+        useNoProxy = true;
+      } else {
+        // Neither works - will fail but try direct
+        warning('Neither proxy nor direct access working. Attempting direct connection...');
+        useNoProxy = true;
+      }
+    }
+
+    // Build pip arguments
     const pipArgs = ['install', '-r', requirementsPath];
 
-    const proxyFriendlyArgs = [
+    // Trusted hosts for SSL-friendly installation
+    const trustedHostArgs = [
       '--trusted-host', 'pypi.org',
       '--trusted-host', 'pypi.python.org',
       '--trusted-host', 'files.pythonhosted.org'
     ];
+    pipArgs.push(...trustedHostArgs);
+
+    // Add proxy if needed
+    if (proxyToUse && !useNoProxy) {
+      info(`Using proxy: ${proxyToUse}`);
+      pipArgs.push('--proxy', proxyToUse);
+    }
 
-    const proxy = process.env.HTTP_PROXY || process.env.http_proxy;
-    if (proxy) {
-      pipArgs.push('--proxy', proxy);
+    // Set up environment (potentially removing proxy vars)
+    const pipEnv = { ...process.env };
+    if (useNoProxy) {
+      // Remove proxy environment variables for this pip call
+      delete pipEnv.HTTP_PROXY;
+      delete pipEnv.HTTPS_PROXY;
+      delete pipEnv.http_proxy;
+      delete pipEnv.https_proxy;
+      delete pipEnv.ALL_PROXY;
+      delete pipEnv.all_proxy;
     }
-    pipArgs.push(...proxyFriendlyArgs);
 
     const installReqs = spawnSync(pip, pipArgs, {
       cwd: projectRoot,
-      stdio: 'inherit'
+      stdio: 'inherit',
+      env: pipEnv
     });
 
     if (installReqs.status !== 0) {
-      error('Failed to install dependencies');
+      error('Failed to install dependencies from PyPI');
+
+      // Show intelligent troubleshooting
+      const proxyUrl = process.env.HTTP_PROXY || process.env.http_proxy;
+      const proxyWorks = proxyUrl ? testProxyConnectivity(proxyUrl) : false;
+      const directWorks = testDirectPyPIAccess();
+
+      showProxyTroubleshooting(activeProxies, directWorks, proxyWorks);
       process.exit(1);
     }
-  }
 
-  console.error('✓ Requirements installed');
+    log('✓ Requirements installed', 'green');
+  }
 
   // Install package itself
   console.error('Installing jenkins-mcp-server package...');
+
+  // Verify pyproject.toml exists
+  const pyprojectPath = path.join(projectRoot, 'pyproject.toml');
+  if (!fs.existsSync(pyprojectPath)) {
+    error('pyproject.toml not found in project root');
+    console.error('\nProject root:', projectRoot);
+    console.error('Expected file:', pyprojectPath);
+    console.error('\nThis may be due to npx cache issues with special characters.');
+    console.error('Try clearing npx cache: npx clear-npx-cache');
+    process.exit(1);
+  }
+
   const packageArgs = ['install', '-e', '.'];
 
   const installPkg = spawnSync(pip, packageArgs, {
@@ -227,10 +553,24 @@ function installDependencies(venvPath) {
 
   if (installPkg.status !== 0) {
     error('Failed to install package');
+    console.error('\nProject root:', projectRoot);
+    console.error('Files in project root:');
+    try {
+      const files = fs.readdirSync(projectRoot);
+      console.error(files.join(', '));
+    } catch (e) {
+      console.error('Could not list files');
+    }
+
+    console.error('\n💡 TROUBLESHOOTING:');
+    console.error('1. The npx cache may have issues with the @ symbol in package name');
+    console.error('2. Try: npx clear-npx-cache && rm -rf ~/.npm/_npx');
+    console.error('3. Or install globally: npm install -g @rishibhushan/jenkins-mcp-server');
+    console.error('   Then run: jenkins-mcp-server --env-file /path/to/.env');
     process.exit(1);
   }
 
-  console.error('✓ Package installed');
+  log('✓ Package installed successfully', 'green');
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rishibhushan/jenkins-mcp-server",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "AI-enabled Jenkins automation via Model Context Protocol (MCP)",
   "main": "bin/jenkins-mcp.js",
   "bin": {
@@ -9,13 +9,15 @@
   "scripts": {
     "start": "node bin/jenkins-mcp.js",
     "test": "python -m pytest tests/",
-    "build": "python -m build"
+    "build": "python -m build",
+    "prepack": "npm run clean",
+    "clean": "find . -type d -name '__pycache__' -exec rm -rf {} + 2>/dev/null || true; find . -type d -name '*.egg-info' -exec rm -rf {} + 2>/dev/null || true"
   },
   "files": [
     "bin/",
-    "src/",
+    "src/**/*.py",
+    "pyproject.toml",
     "requirements.txt",
-    "wheels/",
     "README.md",
     "LICENSE"
   ],

package/pyproject.toml

@@ -0,0 +1,190 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jenkins-mcp-server"
+version = "1.0.0"
+description = "AI-enabled Jenkins automation via Model Context Protocol (MCP)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Rishi Bhushan", email = "rishibharat2007@gmail.com"}
+]
+maintainers = [
+    {name = "Rishi Bhushan", email = "rishibharat2007@example.com"}
+]
+keywords = [
+    "mcp",
+    "jenkins",
+    "ai",
+    "automation",
+    "ci-cd",
+    "devops",
+    "model-context-protocol",
+    "llm"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+dependencies = [
+    "mcp>=1.0.0",
+    "python-jenkins>=1.8.0",
+    "requests>=2.28.0",
+    "pydantic>=2.0.0",
+    "pydantic-settings>=2.0.0",
+    "python-dotenv>=1.0.0",
+    "urllib3>=2.0.0"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0"
+]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/rishibhushan/jenkins_mcp_server"
+Documentation = "https://github.com/rishibhushan/jenkins_mcp_server#readme"
+Repository = "https://github.com/rishibhushan/jenkins_mcp_server.git"
+"Bug Tracker" = "https://github.com/rishibhushan/jenkins_mcp_server/issues"
+Changelog = "https://github.com/rishibhushan/jenkins_mcp_server/releases"
+
+[project.scripts]
+jenkins-mcp-server = "jenkins_mcp_server:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["jenkins_mcp_server*"]
+exclude = ["tests*"]
+
+[tool.setuptools.package-data]
+jenkins_mcp_server = ["py.typed"]
+
+# Black configuration
+[tool.black]
+line-length = 100
+target-version = ['py38', 'py39', 'py310', 'py311']
+include = '\.pyi?$'
+extend-exclude = '''
+/(
+  # directories
+  \.eggs
+  | \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | build
+  | dist
+)/
+'''
+
+# Ruff configuration (fast linter)
+[tool.ruff]
+line-length = 100
+target-version = "py38"
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = [
+    "E501",  # line too long (handled by black)
+    "B008",  # do not perform function calls in argument defaults
+    "C901",  # too complex
+]
+
+[tool.ruff.per-file-ignores]
+"__init__.py" = ["F401"]  # unused imports in __init__.py
+
+# MyPy configuration
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+strict_equality = true
+
+[[tool.mypy.overrides]]
+module = [
+    "jenkins",
+    "mcp.*"
+]
+ignore_missing_imports = true
+
+# Pytest configuration
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+    "--showlocals",
+    "--tb=short"
+]
+testpaths = ["tests"]
+pythonpath = ["src"]
+asyncio_mode = "auto"
+
+# Coverage configuration
+[tool.coverage.run]
+source = ["src"]
+branch = true
+omit = [
+    "*/tests/*",
+    "*/__pycache__/*",
+    "*/.venv/*"
+]
+
+[tool.coverage.report]
+precision = 2
+show_missing = true
+skip_covered = false
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod"
+]