@rishibhushan/jenkins-mcp-server 1.1.17 → 1.2.0

package/README.md

@@ -1,5 +1,10 @@
+
 # 🧠 Jenkins MCP Server
 
+![Build Status](https://img.shields.io/github/actions/workflow/status/rishibhushan/jenkins_mcp_server/docker-publish.yml?branch=main)
+![npm version](https://img.shields.io/npm/v/@rishibhushan/jenkins-mcp-server)
+![Docker](https://img.shields.io/badge/docker-ghcr.io%2Frishibhushan%2Fjenkins--mcp--server-blue)
+
 **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:
@@ -33,7 +38,6 @@ Designed to work seamlessly with automation clients such as:
 - 📊 **Console improvements** - Line-based truncation with tail mode
 - 🎨 **Structured logging** - Better debugging with JSON logs
 
----
 
 ## ✨ About codebase
 
@@ -46,7 +50,6 @@ Designed to work seamlessly with automation clients such as:
 - ✅ **Performance** - 10x faster with intelligent caching and optimization
 - ✅ **Reliability** - Comprehensive input validation and error handling
 
----
 
 ## 📦 Features
 
@@ -114,7 +117,6 @@ This project includes:
 
 For detailed technical documentation, see [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
 
----
 
 ## 🚀 Quick Start
 
@@ -175,7 +177,6 @@ npm -v
 ```
 </details>
 
----
 
 ## ⚙️ Configuration
 
@@ -246,7 +247,6 @@ Settings are loaded in this order (later overrides earlier):
 5. Give it a name and click **Generate**
 6. Copy the token (⚠️ it won't be shown again!)
 
----
 
 ## 🚀 Installation/Running the Server
 
@@ -320,7 +320,100 @@ Options:
   --help, -h         Show help message
 ```
 
----
+## 🐳 Run with Docker (Standalone / CI / Headless environments)
+
+Docker support allows you to run the MCP server without installing Node
+or Python locally.
+
+### 📦 Build the image
+
+``` bash
+docker build -t jenkins-mcp-server .
+```
+
+
+
+
+### ▶️ Run the container
+
+``` bash
+docker run -it --rm \
+  -p 3000:3000 \
+  -e JENKINS_URL=http://your-jenkins:8080 \
+  -e JENKINS_USERNAME=your_username \
+  -e JENKINS_TOKEN=your_token \
+  jenkins-mcp-server
+```
+
+### 📥 Pull Prebuilt Image (Recommended)
+
+Instead of building locally, you can pull the official image:
+
+```bash
+docker pull ghcr.io/rishibhushan/jenkins-mcp-server:latest
+```
+
+### 🔌 MCP Client Configuration (Docker)
+
+Example configuration for MCP clients:
+
+```json
+{
+  "jenkins": {
+    "command": "docker",
+    "args": [
+      "run",
+      "-i",
+      "--rm",
+      "-e",
+      "JENKINS_URL",
+      "-e",
+      "JENKINS_USERNAME",
+      "-e",
+      "JENKINS_TOKEN",
+      "ghcr.io/rishibhushan/jenkins-mcp-server:latest"
+    ]
+  }
+}
+```
+
+### 🔑 Required Environment Variables
+| Variable | Description |
+|---|---|
+|  JENKINS_URL  |  Jenkins base URL  |
+|  JENKINS_USERNAME  |  Jenkins username  |
+|  JENKINS_TOKEN  |  API token (recommended) |
+|  JENKINS_PASSWORD  |  Password (if not using token)  |
+
+### 🧠 When to use Docker
+
+Docker is recommended when running the MCP server:
+
+-   In CI/CD pipelines
+-   On Jenkins agents
+-   As a shared service
+-   Outside VS Code
+-   In production-like environments
+
+
+
+## ⚙️ Configuration Priority
+
+The server resolves configuration in this order:
+
+1️⃣ Environment variables\
+2️⃣ `.env` file\
+3️⃣ VS Code `settings.json`
+
+
+
+## 🧪 Verify Server is Running
+
+After starting, you should see logs indicating:
+
+-   Jenkins configuration loaded
+-   MCP server started
+-   Listening on port `3000`
 
 ## 🔌 Integration with VSCode
 
@@ -427,7 +520,6 @@ Common issues:
 - **No tools appear:** Check the config file path and restart Claude Desktop
 - **Connection timeout:** Verify Jenkins URL is accessible from your network
 
----
 
 
 ## 🏢 Corporate Network / Proxy Setup
@@ -495,7 +587,7 @@ 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
@@ -551,7 +643,6 @@ if result['build_number']:
     print(output)
 ```
 
----
 
 ## 🔍 Quick Troubleshooting
 
@@ -581,7 +672,6 @@ npx --yes @rishibhushan/jenkins-mcp-server --env-file /path/to/.env
 - ✅ Clear npm cache: `npm cache clean --force`
 - ✅ Try with latest version: `npx --yes @rishibhushan/jenkins-mcp-server@latest`
 
----
 
 ## 🔧 Troubleshooting
 
@@ -1169,7 +1259,7 @@ Run with verbose flag to see detailed logs:
 jenkins-mcp-server --verbose
 ```
 
----
+
 
 ## 🧪 Development & Testing
 
@@ -1208,7 +1298,6 @@ pip install -e .
 jenkins-mcp-server --verbose
 ```
 
----
 
 ## 📚 Project Structure
 
@@ -1227,11 +1316,10 @@ jenkins_mcp_server/
 │       └── server.py           # MCP server implementation (26 tools)
 ├── tests/                      # Test suite
 ├── requirements.txt            # Python dependencies
-├── package.json               # Node.js configuration (ES modules)
-└── README.md                  # This file
+├── package.json                # Node.js configuration (ES modules)
+└── README.md                   # This file
 ```
 
----
 
 ## 🔒 Security Best Practices
 
@@ -1242,7 +1330,6 @@ jenkins_mcp_server/
 5. **Review permissions** - Only grant necessary Jenkins permissions
 6. **Keep dependencies updated** - Run `pip install --upgrade -r requirements.txt`
 
----
 
 ## 🤝 Contributing
 
@@ -1254,13 +1341,11 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 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
 
@@ -1268,14 +1353,12 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - 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
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rishibhushan/jenkins-mcp-server",
   "type": "module",
-  "version": "1.1.17",
+  "version": "1.2.0",
   "description": "AI-enabled Jenkins automation via Model Context Protocol (MCP)",
   "main": "bin/jenkins-mcp.js",
   "bin": {

package/src/jenkins_mcp_server/__init__.py

@@ -11,6 +11,7 @@ import sys
 
 from .config import get_settings, get_default_settings
 from .verbose import set_verbose, vprint
+from .version import __version__
 from . import server
 
 
@@ -83,7 +84,7 @@ Configuration Priority:
     parser.add_argument(
         '--version',
         action='version',
-        version='jenkins-mcp-server 1.1.16'
+        version=f'jenkins-mcp-server {__version__}'
     )
 
     parser.add_argument(
@@ -122,7 +123,8 @@ Configuration Priority:
             logger.error("  1. .env file (JENKINS_URL, JENKINS_USERNAME, JENKINS_TOKEN)")
             logger.error("  2. VS Code settings.json")
             logger.error("  3. Environment variables")
-            logger.error("\nFor help, run: %(prog)s --help" % {'prog': parser.prog})
+            # logger.error("\nFor help, run: %(prog)s --help" % {'prog': parser.prog})
+            logger.error("\nFor help, run: %(prog)s --help" % {'prog': "jenkins-mcp-server"})
             sys.exit(1)
 
         # Log configuration summary
@@ -154,5 +156,4 @@ Configuration Priority:
 
 
 # Package metadata
-__version__ = "1.1.16"
-__all__ = ['main', 'server']
+__all__ = ['main', 'server', '__version__']

package/src/jenkins_mcp_server/server.py

@@ -27,6 +27,7 @@ from .config import JenkinsSettings, get_default_settings
 from .jenkins_client import get_jenkins_client
 from .metrics import get_metrics_collector, record_tool_execution
 from .verbose import vprint, _VERBOSE
+from .version import __version__
 
 # Configure logging
 logger = logging.getLogger(__name__)
@@ -1916,7 +1917,7 @@ async def main():
             sys.exit(1)
 
         vprint(f"=== About to log startup message ===")
-        logger.info(f"Starting Jenkins MCP Server v1.1.16")
+        logger.info(f"Starting Jenkins MCP Server v{__version__}")
         logger.info(f"Connected to: {settings.url}")
         vprint(f"=== Startup messages logged ===")
 
@@ -1934,7 +1935,7 @@ async def main():
             print(f"Press Ctrl+C to stop the server")
             print(f"----------------------------------------")
             if _VERBOSE:
-                vprint(f"Jenkins MCP Server v1.1.16")
+                vprint(f"Jenkins MCP Server v{__version__}")
                 vprint(f"Connected to: {settings.url}")
 
             await server.run(
@@ -1942,7 +1943,7 @@ async def main():
                 write_stream,
                 InitializationOptions(
                     server_name="jenkins-mcp-server",
-                    server_version="1.1.16",
+                    server_version=__version__,
                     capabilities=server.get_capabilities(
                         notification_options=NotificationOptions(),
                         experimental_capabilities={},

package/src/jenkins_mcp_server/version.py

@@ -0,0 +1,33 @@
+"""Version management - reads from package.json"""
+import json
+import os
+from pathlib import Path
+
+
+def get_version() -> str:
+    """
+    Read version from package.json.
+    Falls back to a default if package.json is not found.
+    """
+    try:
+        # Get the project root (3 levels up from this file)
+        # src/jenkins_mcp_server/version.py -> project root
+        current_file = Path(__file__)
+        project_root = current_file.parent.parent.parent
+        package_json_path = project_root / "package.json"
+
+        if package_json_path.exists():
+            with open(package_json_path, 'r') as f:
+                package_data = json.load(f)
+                return package_data.get('version', '0.0.0')
+        else:
+            # Fallback if package.json not found
+            return '0.0.0'
+
+    except Exception:
+        # If anything goes wrong, return a safe default
+        return '0.0.0'
+
+
+# Module-level constant
+__version__ = get_version()