@rishibhushan/jenkins-mcp-server 1.1.1 → 1.1.3

package/bin/jenkins-mcp.js

@@ -73,6 +73,62 @@ function detectProxyConfig() {
   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
@@ -254,6 +310,32 @@ function showProxyTroubleshooting(activeProxies, canAccessDirectly, proxyWorks)
   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)) {
@@ -450,6 +532,18 @@ function installDependencies(venvPath) {
 
   // 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, {
@@ -459,6 +553,20 @@ 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);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rishibhushan/jenkins-mcp-server",
-  "version": "1.1.1",
+  "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"
+]

package/src/jenkins_mcp_server/jenkins_client.py

@@ -40,12 +40,14 @@ class JenkinsClient:
     timeout support.
     """
 
-    def __init__(self, settings: Optional[JenkinsSettings] = None):
+    def __init__(self, settings: Optional[JenkinsSettings] = None, test_connection: bool = False):
         """
         Initialize Jenkins client.
 
         Args:
             settings: JenkinsSettings instance. If None, uses default settings.
+            test_connection: If True, test connection during initialization.
+                            Set to False for MCP list_resources to avoid blocking.
 
         Raises:
             JenkinsConnectionError: If unable to connect to Jenkins
@@ -72,8 +74,10 @@ class JenkinsClient:
         # Cache for python-jenkins server instance
         self._server: Optional[jenkins.Jenkins] = None
 
-        # Test connection
-        self._test_connection()
+        # Only test connection if explicitly requested
+        # This prevents blocking during MCP initialization
+        if test_connection:
+            self._test_connection()
 
     def _test_connection(self) -> None:
         """Test connection to Jenkins server (with configurable timeout)"""
@@ -475,12 +479,16 @@ class JenkinsClient:
 _default_client: Optional[JenkinsClient] = None
 
 
-def get_jenkins_client(settings: Optional[JenkinsSettings] = None) -> JenkinsClient:
+def get_jenkins_client(
+        settings: Optional[JenkinsSettings] = None,
+        test_connection: bool = False
+) -> JenkinsClient:
     """
     Get Jenkins client instance.
 
     Args:
         settings: Optional JenkinsSettings. If None, uses default settings.
+        test_connection: If True, test connection during initialization.
 
     Returns:
         JenkinsClient instance
@@ -492,16 +500,10 @@ def get_jenkins_client(settings: Optional[JenkinsSettings] = None) -> JenkinsCli
 
     if settings is not None:
         # Always create new client with custom settings
-        return JenkinsClient(settings)
+        return JenkinsClient(settings, test_connection=test_connection)
 
     # Use cached default client
     if _default_client is None:
-        _default_client = JenkinsClient()
+        _default_client = JenkinsClient(test_connection=test_connection)
 
     return _default_client
-
-
-def reset_default_client() -> None:
-    """Reset the default client (useful for testing or reconfiguration)"""
-    global _default_client
-    _default_client = None

package/src/jenkins_mcp_server/server.py

@@ -120,10 +120,15 @@ async def handle_list_resources() -> list[types.Resource]:
     """
     List available Jenkins resources.
     Each job is exposed as a resource with jenkins:// URI scheme.
+
+    Enhanced with timeout to prevent MCP initialization delays.
     """
     try:
-        client = get_jenkins_client(get_settings())
-        jobs = client.get_jobs()
+        # Wrap in async timeout to prevent blocking MCP initialization
+        async with asyncio.timeout(3):  # 3 second timeout
+            client = get_jenkins_client(get_settings())
+            # Run blocking get_jobs() in thread pool
+            jobs = await asyncio.to_thread(client.get_jobs)
 
         return [
             types.Resource(
@@ -134,13 +139,24 @@ async def handle_list_resources() -> list[types.Resource]:
             )
             for job in jobs
         ]
+    except asyncio.TimeoutError:
+        # Jenkins server not reachable (probably not on VPN/corporate network)
+        logger.warning("Jenkins server not reachable within 3 seconds - likely not on corporate network")
+        return [
+            types.Resource(
+                uri=AnyUrl("jenkins://offline"),
+                name="Jenkins Server Offline",
+                description="Jenkins server not reachable. Connect to VPN/corporate network and restart. Tools will still work when connected.",
+                mimeType="text/plain",
+            )
+        ]
     except Exception as e:
         logger.error(f"Failed to list resources: {e}")
         return [
             types.Resource(
                 uri=AnyUrl("jenkins://error"),
                 name="Error connecting to Jenkins",
-                description=f"Error: {str(e)}",
+                description=f"Error: {str(e)}. Check your configuration and network connection.",
                 mimeType="text/plain",
             )
         ]

package/src/jenkins_mcp_server.egg-info/PKG-INFO

@@ -1,624 +0,0 @@
-Metadata-Version: 2.4
-Name: jenkins-mcp-server
-Version: 1.0.0
-Summary: AI-enabled Jenkins automation via Model Context Protocol (MCP)
-Author-email: Rishi Bhushan <rishibharat2007@gmail.com>
-Maintainer-email: Rishi Bhushan <rishibharat2007@example.com>
-License: MIT
-Project-URL: Homepage, https://github.com/rishibhushan/jenkins_mcp_server
-Project-URL: Documentation, https://github.com/rishibhushan/jenkins_mcp_server#readme
-Project-URL: Repository, https://github.com/rishibhushan/jenkins_mcp_server.git
-Project-URL: Bug Tracker, https://github.com/rishibhushan/jenkins_mcp_server/issues
-Project-URL: Changelog, https://github.com/rishibhushan/jenkins_mcp_server/releases
-Keywords: mcp,jenkins,ai,automation,ci-cd,devops,model-context-protocol,llm
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: System :: Systems Administration
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: mcp>=1.0.0
-Requires-Dist: python-jenkins>=1.8.0
-Requires-Dist: requests>=2.28.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: pydantic-settings>=2.0.0
-Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: urllib3>=2.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Provides-Extra: test
-Requires-Dist: pytest>=7.0.0; extra == "test"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
-Requires-Dist: pytest-cov>=4.0.0; extra == "test"
-
-# 🧠 Jenkins MCP Server
-
-**Jenkins MCP Server** is an AI-enabled Model Context Protocol (MCP) server that exposes Jenkins automation through natural-language commands.
-
-Designed to work seamlessly with automation clients such as:
-- 🖥️ **VS Code MCP** - Direct integration with Claude in VS Code
-- 🔌 **Any MCP-compatible client** - Universal compatibility
-
-## ✨ About codebase
-
-- ✅ **Codebase** - cleaner, more maintainable
-- ✅ **Error messages** - Know exactly what's wrong and how to fix it
-- ✅ **Flexible configuration** - Multiple ways to configure (VS Code, .env, environment)
-- ✅ **Cross-platform** - Seamless support for Windows, macOS, and Linux
-- ✅ **Logging** - Professional logging with `--verbose` flag
-- ✅ **Dependency management** - Automatic detection and installation
-
----
-
-## 📦 Features
-
-This project includes:
-- 🐍 Python backend powered by `python-jenkins`
-- 📦 Node.js `npx` wrapper for zero-install execution
-- 🔄 Automatic virtual environment creation + dependency installation
-- 🌐 Corporate proxy/certificate auto-detection support
-- 🪟 Windows, macOS, and Linux support
-- 🛠️ **20 Jenkins management tools**
-
-### 🧩 Build Operations
-| Tool Name | Description | Required Fields | Optional Fields |
-|---|---|---|---|
-| `trigger-build` | Trigger a Jenkins job build with optional parameters | `job_name` | `parameters` |
-| `stop-build` | Stop a running Jenkins build | `job_name`, `build_number` | *(none)* |
-
-### 📊 Job Information
-| Tool Name | Description | Required Fields | Optional Fields |
-|---|---|---|---|
-| `list-jobs` | List all Jenkins jobs with optional filtering | *(none)* | `filter` |
-| `get-job-details` | Get detailed information about a Jenkins job | `job_name` | *(none)* |
-
-### 🛠️ Build Information
-| Tool Name | Description | Required Fields | Optional Fields |
-|---|---|---|---|
-| `get-build-info` | Get information about a specific build | `job_name`, `build_number` | *(none)* |
-| `get-build-console` | Get console output from a build | `job_name`, `build_number` | *(none)* |
-| `get-last-build-number` | Get the last build number for a job | `job_name` | *(none)* |
-| `get-last-build-timestamp` | Get the timestamp of the last build | `job_name` | *(none)* |
-
-### 🧩 Job Management
-| Tool Name | Description | Required Fields | Optional Fields |
-|---|---|---|---|
-| `create-job` | Create a new Jenkins job with XML configuration | `job_name`, `config_xml` | *(none)* |
-| `create-job-from-copy` | Create a new job by copying an existing one | `new_job_name`, `source_job_name` | *(none)* |
-| `create-job-from-data` | Create a job from structured data (auto-generated XML) | `job_name`, `config_data` | `root_tag` |
-| `delete-job` | Delete an existing job | `job_name` | *(none)* |
-| `enable-job` | Enable a disabled Jenkins job | `job_name` | *(none)* |
-| `disable-job` | Disable a Jenkins job | `job_name` | *(none)* |
-| `rename-job` | Rename an existing Jenkins job | `job_name`, `new_name` | *(none)* |
-
-### ⚙️ Job Configuration
-| Tool Name | Description | Required Fields | Optional Fields |
-|---|---|---|---|
-| `get-job-config` | Fetch job XML configuration | `job_name` | *(none)* |
-| `update-job-config` | Update job XML configuration | `job_name`, `config_xml` | *(none)* |
-
-### 🖥️ System Information
-| Tool Name | Description | Required Fields | Optional Fields |
-|---|---|---|---|
-| `get-queue-info` | Get Jenkins build queue info | *(none)* | *(none)* |
-| `list-nodes` | List all Jenkins nodes | *(none)* | *(none)* |
-| `get-node-info` | Get information about a Jenkins node | `node_name` | *(none)* |
-
----
-
-## 🚀 Quick Start
-
-### Prerequisites
-
-**Node.js** (v14 or higher) is required for the npx wrapper.
-
-<details>
-<summary><b>Windows Installation</b></summary>
-
-```powershell
-# Using winget (recommended)
-winget install OpenJS.NodeJS.LTS
-
-# Verify installation
-node -v
-npm -v
-```
-
-Or download manually from https://nodejs.org/
-</details>
-
-<details>
-<summary><b>macOS Installation</b></summary>
-
-```bash
-# Install nvm (Node Version Manager)
-curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
-
-# Reload shell
-source ~/.nvm/nvm.sh
-
-# Install Node LTS
-nvm install --lts
-nvm use --lts
-
-# Verify installation
-node -v
-npm -v
-```
-</details>
-
-<details>
-<summary><b>Linux Installation</b></summary>
-
-```bash
-# Ubuntu/Debian
-curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
-sudo apt-get install -y nodejs
-
-# Fedora/RHEL
-curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
-sudo dnf install -y nodejs
-
-# Verify installation
-node -v
-npm -v
-```
-</details>
-
----
-
-## ⚙️ Configuration
-
-Jenkins MCP Server supports multiple configuration methods. Choose the one that works best for you:
-
-### Option 1: VS Code Settings (Recommended)
-
-Add to your VS Code `settings.json`:
-
-```json
-{
-  "jenkins-mcp-server": {
-    "jenkins": {
-      "url": "http://jenkins.example.com:8080",
-      "username": "your-username",
-      "token": "your-api-token"
-    }
-  }
-}
-```
-
-**Where to find settings.json:**
-- **Windows**: `%APPDATA%\Code\User\settings.json`
-- **macOS**: `~/Library/Application Support/Code/User/settings.json`
-- **Linux**: `~/.config/Code/User/settings.json`
-
-### Option 2: Environment File (.env)
-
-Rename `.env.template` to `.env`
-```bash
-cp .env.template .env
-```
-
-In the `.env` file in your project directory:
-
-```bash
-JENKINS_URL=http://jenkins.example.com:8080
-JENKINS_USERNAME=your-username
-JENKINS_TOKEN=your-api-token
-```
-
-**Note**: Use API token instead of password for better security.
-
-### Option 3: Environment Variables
-
-```bash
-# Linux/macOS
-export JENKINS_URL=http://jenkins.example.com:8080
-export JENKINS_USERNAME=your-username
-export JENKINS_TOKEN=your-api-token
-
-# Windows (PowerShell)
-$env:JENKINS_URL="http://jenkins.example.com:8080"
-$env:JENKINS_USERNAME="your-username"
-$env:JENKINS_TOKEN="your-api-token"
-```
-
-### Configuration Priority
-
-Settings are loaded in this order (later overrides earlier):
-1. Default `.env` file
-2. Environment variables
-3. Custom `.env` file (via `--env-file`)
-4. VS Code settings
-5. Direct parameters
-
-### Getting Your Jenkins API Token
-
-1. Log into Jenkins
-2. Click your name (top right) → **Configure**
-3. Scroll to **API Token** section
-4. Click **Add new Token**
-5. Give it a name and click **Generate**
-6. Copy the token (⚠️ it won't be shown again!)
-
----
-
-## 🚀 Installation/Running the Server
-
-### Option 1: Using npx (No Installation Required)
-```bash
-npx @rishibhushan/jenkins-mcp-server --env-file .env
-```
-
-### Option 2: Global Installation
-```bash
-# Install globally
-npm install -g @rishibhushan/jenkins-mcp-server
-
-# Run
-jenkins-mcp-server --env-file .env
-```
-
-### Option 3: From GitHub
-```bash
-npx github:rishibhushan/jenkins_mcp_server --env-file .env
-```
-
-[//]: # ([![npm version]&#40;https://badge.fury.io/js/jenkins-mcp-server.svg&#41;]&#40;https://www.npmjs.com/package/@rishibhushan/jenkins-mcp-server&#41;)
-
-[//]: # ([![npm downloads]&#40;https://img.shields.io/npm/dm/jenkins-mcp-server.svg&#41;]&#40;https://www.npmjs.com/package/@rishibhushan/jenkins-mcp-server&#41;)
-
----
-
-This automatically:
-- ✅ Installs all dependencies
-- ✅ Starts the Jenkins MCP server
-
-### Method 2: Direct Python Execution
-
-```bash
-# Create virtual environment
-python3 -m venv .venv
-
-# Activate virtual environment
-# Linux/macOS:
-source .venv/bin/activate
-# Windows:
-.venv\Scripts\activate
-
-# Install dependencies
-pip install -r requirements.txt
-
-# Run the server
-python -m jenkins_mcp_server --env-file /path/to/.env
-```
-
-### Command-Line Options
-
-```
-jenkins-mcp-server [options]
-
-Options:
-  --env-file PATH    Path to custom .env file
-  --verbose, -v      Enable verbose/debug logging
-  --no-vscode        Skip loading VS Code settings
-  --version          Show version information
-  --help, -h         Show help message
-```
-
----
-
-## 🔌 Integration Examples
-
-### VS Code MCP Client
-
-Add to your VS Code `mcp.json`:
-
-```json
-{
-  "servers": {
-    "jenkins": {
-      "type": "stdio",
-      "command": "npx",
-      "args": [
-        "@rishibhushan/jenkins-mcp-server"
-      ]
-    }
-  }
-}
-```
-
-Or `setting.json` with `.env` file and proxy settings:
-```json
-{
-  "mcp": {
-    "servers": {
-      "jenkins": {
-        "type": "stdio",
-        "command": "npx",
-        "args": [
-          "@rishibhushan/jenkins-mcp-server",
-          "--verbose",
-          "--env-file",
-          "/path/to/.env"
-        ],
-        "env": {
-          "HTTP_PROXY": "http://proxy.example.com:8080",
-          "HTTPS_PROXY": "http://proxy.example.com:8080",
-          "NO_PROXY": "localhost,127.0.0.1,.example.com"
-        }
-      }
-    }
-  }
-}
-```
-
-### Claude Desktop
-
-Add to `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "jenkins": {
-      "command": "npx",
-      "args": [
-        "@rishibhushan/jenkins-mcp-server",
-        "--env-file",
-        "/path/to/.env"
-      ]
-    }
-  }
-}
-```
-
-**Where to find claude_desktop_config.json:**
-- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Linux**: `~/.config/Claude/claude_desktop_config.json`
-
----
-
-## 💡 Usage Examples
-
-### Natural Language Commands
-
-Once configured, you can use natural language with your MCP client:
-
-```
-"List all Jenkins jobs"
-"List jobs with 'backend' in the name"  - # Filter jobs containing "backend"
-"Show me all production jobs"  - # Filter jobs containing "prod"
-"Show me the last build of my-project"
-"Trigger a build for deploy-prod with parameter env=production"
-"What's in the build queue?"
-"Show me the console output of build #42 for backend-service"
-"Create a new job called test-job by copying prod-job"
-"Disable the old-job"
-```
-
-### Programmatic Usage (Python)
-
-```python
-from config import get_settings
-from jenkins_client import get_jenkins_client
-
-# Load settings
-settings = get_settings()
-
-# Create client
-client = get_jenkins_client(settings)
-
-# List jobs
-all_jobs = client.get_jobs()
-for job in all_jobs:
-    print(f"Job: {job['name']} - Status: {job['color']}")
-
-# Filter in Python
-backend_jobs = [job for job in all_jobs if 'backend' in job['name'].lower()]
-
-# Trigger a build
-result = client.build_job(
-    "my-job",
-    parameters={"BRANCH": "main", "ENV": "staging"}
-)
-print(f"Build queued: {result['queue_id']}")
-print(f"Build number: {result['build_number']}")
-
-# Get console output
-if result['build_number']:
-    output = client.get_build_console_output(
-        "my-job",
-        result['build_number']
-    )
-    print(output)
-```
-
----
-
-## 🔧 Troubleshooting
-
-### Python Not Found
-```
-Error: Python 3 is required but not found.
-```
-**Solution**: Install Python 3.8+ from https://www.python.org/downloads/
-
-### Configuration Issues
-```
-ERROR: Jenkins configuration is incomplete!
-```
-**Solution**: Verify you have set `JENKINS_URL`, `JENKINS_USERNAME`, and `JENKINS_TOKEN`
-
-Check your configuration:
-```bash
-# View .env file
-cat .env
-
-# Check environment variables
-env | grep JENKINS
-
-# Check VS Code settings
-cat ~/.config/Code/User/settings.json | grep jenkins
-```
-
-### Connection Failed
-```
-Failed to connect to Jenkins at http://localhost:8080
-```
-**Solution**: 
-1. Verify Jenkins is running: `curl http://localhost:8080/api/json`
-2. Check firewall settings
-3. Verify URL is correct (include port if needed)
-4. Test authentication credentials
-
-### Dependency Installation Failed
-```
-Failed to install dependencies
-```
-**Solution**:
-1. Check internet connection
-2. If behind a proxy, set `HTTP_PROXY` and `HTTPS_PROXY` environment variables
-3. Try manual installation: `.venv/bin/pip install -r requirements.txt`
-
-### Enable Debug Logging
-
-Run with verbose flag to see detailed logs:
-```bash
-jenkins-mcp-server --verbose
-```
-
----
-
-## 🧪 Development & Testing
-
-### Run Tests
-```bash
-# Install test dependencies
-pip install pytest pytest-asyncio
-
-# Run tests
-pytest tests/ -v
-```
-
-### Build Package
-```bash
-# Install build tools
-pip install build
-
-# Build distribution
-python -m build
-
-# This creates:
-# - dist/jenkins_mcp_server-1.0.0.tar.gz
-# - dist/jenkins_mcp_server-1.0.0-py3-none-any.whl
-```
-
-### Local Development
-```bash
-# Clone repository
-git clone https://github.com/rishibhushan/jenkins_mcp_server.git
-cd jenkins_mcp_server
-
-# Install in editable mode
-pip install -e .
-
-# Make changes, then test
-jenkins-mcp-server --verbose
-```
-
----
-
-## 📚 Project Structure
-
-```
-jenkins_mcp_server/
-├── bin/
-│   └── jenkins-mcp.js          # Node.js wrapper script
-├── src/
-│   └── jenkins_mcp_server/
-│       ├── __init__.py         # Package initialization & main()
-│       ├── __main__.py         # Entry point for python -m
-│       ├── config.py           # Configuration management
-│       ├── jenkins_client.py   # Jenkins API client
-│       └── server.py           # MCP server implementation
-├── tests/                      # Test suite
-├── requirements.txt            # Python dependencies
-├── package.json               # Node.js configuration
-└── README.md                  # This file
-```
-
----
-
-## 🔒 Security Best Practices
-
-1. **Never commit `.env` files** - Add to `.gitignore`
-2. **Use API tokens**, not passwords - More secure and revocable
-3. **Rotate tokens regularly** - Generate new tokens periodically
-4. **Use environment-specific configs** - Separate dev/staging/prod credentials
-5. **Review permissions** - Only grant necessary Jenkins permissions
-6. **Keep dependencies updated** - Run `pip install --upgrade -r requirements.txt`
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to the branch (`git push origin feature/AmazingFeature`)
-5. Open a Pull Request
-
----
-
-## 📝 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
----
-
-## 🙏 Acknowledgments
-
-- Built on the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
-- Powered by [python-jenkins](https://python-jenkins.readthedocs.io/)
-- Inspired by the need for AI-powered DevOps automation
-
----
-
-## 📞 Support
-
-- **Issues**: https://github.com/rishibhushan/jenkins_mcp_server/issues
-- **Discussions**: https://github.com/rishibhushan/jenkins_mcp_server/discussions
-
----
-
-## 🗺️ Roadmap
-
-- [ ] Add pipeline support
-- [ ] Multi-Jenkins instance management
-- [ ] Build artifact management
-- [ ] Advanced filtering and search
-- [ ] Real-time build monitoring
-- [ ] Webhook integration
-- [ ] Docker container support
-
----
-
-**Made with ❤️ by [Rishi Bhushan](https://github.com/rishibhushan)**

package/src/jenkins_mcp_server.egg-info/SOURCES.txt

@@ -1,13 +0,0 @@
-README.md
-pyproject.toml
-src/jenkins_mcp_server/__init__.py
-src/jenkins_mcp_server/__main__.py
-src/jenkins_mcp_server/config.py
-src/jenkins_mcp_server/jenkins_client.py
-src/jenkins_mcp_server/server.py
-src/jenkins_mcp_server.egg-info/PKG-INFO
-src/jenkins_mcp_server.egg-info/SOURCES.txt
-src/jenkins_mcp_server.egg-info/dependency_links.txt
-src/jenkins_mcp_server.egg-info/entry_points.txt
-src/jenkins_mcp_server.egg-info/requires.txt
-src/jenkins_mcp_server.egg-info/top_level.txt

package/src/jenkins_mcp_server.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

package/src/jenkins_mcp_server.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-jenkins-mcp-server = jenkins_mcp_server:main

package/src/jenkins_mcp_server.egg-info/requires.txt

@@ -1,20 +0,0 @@
-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
-
-[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

package/src/jenkins_mcp_server.egg-info/top_level.txt

@@ -1 +0,0 @@
-jenkins_mcp_server