🏗️ Jenkins MCP Server

MCP server for Jenkins CI/CD operations — 53 tools for job management, builds, pipelines, nodes, credentials, plugins, and more.

A comprehensive Model Context Protocol (MCP) server that exposes the full Jenkins REST API as AI-ready tools. Connect your AI assistant (Cursor, Claude Desktop, or any MCP client) to manage Jenkins servers through natural language.

Author: Pawan Gunjkar (pawangunjkar@gmail.com)

📥 Install

Option 1: PyPI / uvx (Recommended)

uvx pawangunjkar-jenkins-mcp

Cursor / Claude Desktop — add to .cursor/mcp.json:

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["pawangunjkar-jenkins-mcp"],
      "env": {
        "JENKINS_URL": "http://localhost:8080",
        "JENKINS_USERNAME": "admin",
        "JENKINS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Option 2: Smithery

npx -y @smithery/cli install jenkins-mcp --client cursor

Option 3: Clone from GitHub

git clone https://github.com/Pawangunjkar/jenkins-mcp.git
cd jenkins-mcp
uv sync
uv run server.py

See PUBLISHING.md for full publishing steps.

✨ Features

• 🔌 53 tools across 10 categories — full Jenkins API coverage
• 🔐 Secure authentication — API token-based auth with CSRF crumb handling
• 💾 Credential caching — auto-connect from env vars or cached credentials
• 📁 Folder support — navigate and manage jobs in nested folder structures
• 🔀 Pipeline support — view stages, replay builds, and inspect pipeline runs
• 🧩 Plugin management — list, install, and inspect plugins
• 🖥️ Node management — monitor agents, executors, and system health
• 🎯 Zero configuration — just set env vars and run

🚀 Quick Start

Prerequisites

• Python 3.10+
• uv package manager
• Jenkins server with API access enabled

1. Clone & Install

cd jenkins-mcp
uv sync

2. Configure Jenkins Credentials

Option A: Environment Variables (Recommended)

# Copy and edit the example file
cp .env.example .env

# Set your Jenkins details
JENKINS_URL=http://localhost:8080
JENKINS_USERNAME=admin
JENKINS_API_TOKEN=your-api-token-here

Option B: Connect via chat

Just start the server and use the jenkins_connect tool:

jenkins_connect(url="http://localhost:8080", username="admin", api_token="your-token")

3. Generate a Jenkins API Token

1. Log in to Jenkins
2. Click your username → Configure
3. Under API Token → Add new Token
4. Give it a name → Click Generate
5. Copy the token value

4. Run the Server

# For Cursor / Claude Desktop (stdio transport)
uv run server.py

# For testing with MCP Inspector
uv run mcp dev server.py

🛠️ Tool Reference (53 Tools)

Category 1: Connection & Authentication (4 tools)

Category 2: Job Management (10 tools)

Category 3: Build Operations (8 tools)

Category 4: Build Queue (3 tools)

Category 5: Node/Agent Management (6 tools)

Category 6: View Management (5 tools)

Category 7: Credentials Management (4 tools)

Category 8: Plugin Management (4 tools)

Category 9: Pipeline & Folder Operations (4 tools)

Category 10: System & Administration (5 tools)

⚙️ Configuration

Environment Variables

Cursor Integration

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["pawangunjkar-jenkins-mcp"],
      "env": {
        "JENKINS_URL": "http://localhost:8080",
        "JENKINS_USERNAME": "admin",
        "JENKINS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Desktop Integration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["pawangunjkar-jenkins-mcp"],
      "env": {
        "JENKINS_URL": "http://localhost:8080",
        "JENKINS_USERNAME": "admin",
        "JENKINS_API_TOKEN": "your-api-token"
      }
    }
  }
}

💡 Example Usage

Managing Jobs

"List all Jenkins jobs"
→ jenkins_list_jobs()

"Show me details about the 'deploy-prod' job"
→ jenkins_get_job(job_name="deploy-prod")

"Create a copy of 'deploy-prod' called 'deploy-staging'"
→ jenkins_copy_job(source_job="deploy-prod", new_name="deploy-staging")

"Disable the test job while we fix the flaky tests"
→ jenkins_disable_job(job_name="test-suite")

Building & Monitoring

"Build the deploy pipeline with BRANCH=main"
→ jenkins_build(job_name="deploy-prod", parameters='{"BRANCH": "main"}')

"Show me the console output of the last build"
→ jenkins_get_build_log(job_name="deploy-prod")

"Stop build #42 — it's hanging"
→ jenkins_stop_build(job_name="deploy-prod", build_number=42)

"Show me the pipeline stages for the last build"
→ jenkins_get_pipeline_stages(job_name="deploy-prod")

System Administration

"What's the status of all Jenkins nodes?"
→ jenkins_list_nodes()

"Take node 'agent-1' offline for maintenance"
→ jenkins_disable_node(node_name="agent-1", reason="Scheduled maintenance")

"List all installed plugins"
→ jenkins_list_plugins()

"Restart Jenkins safely after builds complete"
→ jenkins_restart(safe=True)

"Run a Groovy script to list all users"
→ jenkins_run_groovy_script(script="Jenkins.instance.securityRealm.getAllUsers().each { println it.id }")

📁 Project Structure

jenkins-mcp/
├── server.py              # Main MCP server — 53 tool definitions
├── jenkins_client.py      # Jenkins REST API client (HTTP, auth, CSRF)
├── credential_store.py    # Credential caching (env vars, memory, file)
├── pyproject.toml         # Project metadata & dependencies
├── .env.example           # Example environment variables
├── .gitignore             # Python gitignore
├── LICENSE                # MIT license
└── README.md              # This file

🔒 Security Notes

• API tokens are stored in ~/.jenkins-mcp-cache/credentials.json with restrictive file permissions (600)
• Never commit .env files or credentials to version control
• Use API tokens (not passwords) for authentication — tokens can be revoked individually
• The server supports SSL verification — only disable for self-signed certs in development

📄 License

MIT License — see LICENSE for details.