Jenkins MCP Server

An enterprise-grade MCP (Model Context Protocol) server for seamless Jenkins CI/CD integration. Enables AI assistants like Claude to interact with Jenkins through a comprehensive, production-ready API.

🚀 Quick Start

npm Installation (Recommended)

# Global installation
npm install -g @ashwinighuge/jenkins-mcp-server

# Or use directly with npx
npx @ashwinighuge/jenkins-mcp-server --help

Claude Desktop Integration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jenkins": {
      "command": "jenkins-mcp",
      "env": {
        "JENKINS_URL": "http://your-jenkins-server:8080",
        "JENKINS_USER": "your-username",
        "JENKINS_API_TOKEN": "your-api-token"
      }
    }
  }
}

✨ Features

• 🔧 Job Management: Trigger, list, search, and monitor Jenkins jobs with full folder support
• 📊 Build Status: Real-time build status tracking and console log streaming
• 🔄 Pipeline Support: Stage-by-stage pipeline execution monitoring with detailed logs
• 📦 Artifact Management: List, download, and search build artifacts across multiple builds
• ⚡ Batch Operations: Parallel job execution with intelligent priority queuing
• 🚀 Performance Caching: Multi-tier intelligent caching system with automatic invalidation
• 🔍 Advanced Filtering: Filter jobs by status, results, dates, and more with regex support
• 📋 Queue Management: Real-time build queue monitoring and management
• 🔒 Enterprise Security: CSRF protection, 2FA support, and secure authentication
• 🌐 Cross-Platform: Works on Windows, macOS, and Linux
• 🔄 Retry Logic: Built-in exponential backoff for improved reliability
• 📡 Transport Flexibility: Supports both STDIO and HTTP transports
• ✅ Input Validation: Robust Pydantic-based validation and error handling

📋 Prerequisites

• Node.js: 14.0.0 or higher
• Python: 3.12 or higher
• Jenkins: 2.401+ (recommended)
• Jenkins API Token: For authentication

🛠 Installation Methods

Method 1: npm (Recommended)

# Install globally for system-wide access
npm install -g @ashwinighuge/jenkins-mcp-server

# Verify installation
jenkins-mcp --help

Method 2: Development Setup

# Clone the repository
git clone https://github.com/AshwiniGhuge3012/jenkins-mcp-server
cd jenkins-mcp-server

# Install Node.js dependencies
npm install

# Install Python dependencies
pip install -r requirements.txt  # or use uv pip install

# Run locally
node bin/jenkins-mcp.js --help

🔐 Configuration

Environment Variables

Create a .env file in your working directory:

# Required Jenkins Configuration
JENKINS_URL="http://your-jenkins-server:8080"
JENKINS_USER="your-username"
JENKINS_API_TOKEN="your-api-token"

# Optional: Server Configuration
MCP_PORT=8010
MCP_HOST=0.0.0.0

# Optional: Retry Configuration
JENKINS_MAX_RETRIES=3
JENKINS_RETRY_BASE_DELAY=1.0
JENKINS_RETRY_MAX_DELAY=60.0
JENKINS_RETRY_BACKOFF_MULTIPLIER=2.0

# Optional: Performance Cache Configuration
JENKINS_CACHE_STATIC_TTL=3600        # 1 hour
JENKINS_CACHE_SEMI_STATIC_TTL=300    # 5 minutes
JENKINS_CACHE_DYNAMIC_TTL=30         # 30 seconds
JENKINS_CACHE_SHORT_TTL=10           # 10 seconds
JENKINS_CACHE_STATIC_SIZE=1000       # Max cached items
JENKINS_CACHE_SEMI_STATIC_SIZE=500
JENKINS_CACHE_DYNAMIC_SIZE=200
JENKINS_CACHE_PERMANENT_SIZE=2000
JENKINS_CACHE_SHORT_SIZE=100