Jenkins MCP Server

     ██╗███████╗███╗   ██╗██╗  ██╗██╗███╗   ██╗███████╗    ███╗   ███╗ ██████╗██████╗
     ██║██╔════╝████╗  ██║██║ ██╔╝██║████╗  ██║██╔════╝    ████╗ ████║██╔════╝██╔══██╗
     ██║█████╗  ██╔██╗ ██║█████╔╝ ██║██╔██╗ ██║███████╗    ██╔████╔██║██║     ██████╔╝
██   ██║██╔══╝  ██║╚██╗██║██╔═██╗ ██║██║╚██╗██║╚════██║    ██║╚██╔╝██║██║     ██╔═══╝
╚█████╔╝███████╗██║ ╚████║██║  ██╗██║██║ ╚████║███████║    ██║ ╚═╝ ██║╚██████╗██║
 ╚════╝ ╚══════╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚══════╝    ╚═╝     ╚═╝ ╚═════╝╚═╝

A Jenkins MCP server with 25+ tools for managing jobs, builds, and CI/CD workflows

Features • Quick Start • Installation • Tools • Development

</div>

🌟 Features

🔐 Flexible Authentication - Bearer tokens, Basic auth, OAuth support
⚙️ Flexible Configuration - CLI args, MCPJENKINS_, or JENKINS__ env vars (priority-based)
🔀 Multi-Instance Support - Connect to multiple Jenkins servers in one MCP entry, select per tool call
🛠️ 25+ Tools - Complete Jenkins API coverage
⚡ Modern Stack - TypeScript 5.3+, ES2023, Native Fetch API
📦 MCP Protocol - Native integration with Claude Desktop, Claude Code CLI
🔄 Real-time Monitoring - Build status, queue management, pipeline stages
🧪 Test Results - View test pass/fail counts and suites
🎯 Job Control - Enable/disable, trigger, stop, replay builds
📊 System Info - Nodes, plugins, version info
🔍 Debug Tools - MCP inspector for testing

🚀 Quick Start

Prerequisites

Node.js 20+
Jenkins API token (how to get one)

Installation

Option 1: Via npm (recommended once published):

# No installation needed! Just use npx in your MCP config
npx --yes @kud/mcp-jenkins@latest

Option 2: Local installation:

git clone https://github.com/yourusername/mcp-jenkins.git
cd mcp-jenkins
npm install
npm run build

Configuration Priority

The server supports 3 ways to provide configuration (highest to lowest priority):

CLI arguments - --url, --user, --api-token, --bearer-token
MCPJENKINS* environment variables - MCP_JENKINS_URL, MCP_JENKINS_USER, etc.
JENKINS_* environment variables - JENKINS_URL, JENKINS_USER, etc.

Quick Setup Example (Claude CLI)

Using CLI arguments (recommended for AI assistants like Copilot):

claude mcp add --transport stdio --scope user jenkins \
  -- npx --yes @kud/mcp-jenkins@latest \
  --url https://your-jenkins.com \
  --user your_username \
  --api-token your_token

Using environment variables:

claude mcp add --transport stdio --scope user jenkins \
  --env JENKINS_URL=https://your-jenkins.com \
  --env JENKINS_USER=your_username \
  --env JENKINS_API_TOKEN=your_token \
  -- npx --yes @kud/mcp-jenkins@latest

If installed locally:

claude mcp add --transport stdio --scope user jenkins \
  -- node ~/path/to/mcp-jenkins/dist/index.js \
  --url https://your-jenkins.com \
  --user your_username \
  --api-token your_token

✅ Done! Now you can use Jenkins commands in your AI assistant.

📚 Installation Guides

Choose your development environment:

Claude Code CLI - Command line interface
Claude Code Web - Browser-based Claude
Claude Desktop - Desktop application
VSCode - With Cline, Claude Dev, Continue
Cursor - AI-first IDE
Windsurf - AI-powered code editor
GitHub Copilot - In VSCode or standalone
GitHub Copilot CLI - Terminal tool
JetBrains IDEs - IntelliJ, WebStorm, PyCharm, GoLand, etc.

🎯 Claude Code CLI

For: Claude AI via command line interface

<details> <summary>Click to expand Claude Code CLI setup</summary>

Add the Jenkins MCP server to Claude CLI:

Via npm with CLI args (recommended):

claude mcp add --transport stdio --scope user jenkins \
  -- npx --yes @kud/mcp-jenkins@latest \
  --url https://pipeline.yourcompany.com \
  --user your_username \
  --api-token your_api_token

Via npm with env vars:

claude mcp add --transport stdio --scope user jenkins \
  --env JENKINS_URL=https://pipeline.yourcompany.com \
  --env JENKINS_USER=your_username \
  --env JENKINS_API_TOKEN=your_api_token \
  -- npx --yes @kud/mcp-jenkins@latest

Local installation with CLI args:

claude mcp add --transport stdio --scope user jenkins \
  -- node $HOME/path/to/mcp-jenkins/dist/index.js \
  --url https://pipeline.yourcompany.com \
  --user your_username \
  --api-token your_api_token

Multiple Jenkins instances:

claude mcp add --transport stdio --scope user jenkins \
  --env MCP_JENKINS_URL="https://pipeline.yourcompany.com,https://scheduler.yourcompany.com" \
  --env MCP_JENKINS_USER="your_username,your_username" \
  --env MCP_JENKINS_API_TOKEN="token1,token2" \
  -- npx --yes @kud/mcp-jenkins@latest
# Instances named "pipeline" and "scheduler" automatically from hostnames

Verify: claude mcp list should show jenkins

</details>

🌐 Claude Code Web

For: Claude.ai in your browser

<details> <summary>Click to expand Claude Web setup</summary>

⚠️ Not supported. Claude.ai web interface doesn't support custom MCP servers yet.

Alternatives:

Use desktop clients (see below)
Use CLI tools (see above)
Test via MCP Inspector: npm run inspect:dev → http://localhost:5173

</details>

🖥️ Claude Desktop

For: Claude AI desktop application

<details> <summary>Click to expand Claude Desktop setup</summary>

1. Open Configuration File

macOS:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

2. Add Configuration

Via npm with CLI args (recommended):

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": [
        "--yes",
        "@kud/mcp-jenkins@latest",
        "--url",
        "https://pipeline.yourcompany.com",
        "--user",
        "your_username",
        "--api-token",
        "your_api_token"
      ]
    }
  }
}

Via npm with env vars:

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "JENKINS_URL": "https://pipeline.yourcompany.com",
        "JENKINS_USER": "your_username",
        "JENKINS_API_TOKEN": "your_api_token"
      }
    }
  }
}

Local installation with CLI args:

{
  "mcpServers": {
    "jenkins": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-jenkins/dist/index.js",
        "--url",
        "https://pipeline.yourcompany.com",
        "--user",
        "your_username",
        "--api-token",
        "your_api_token"
      ]
    }
  }
}

Bearer token example:

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": [
        "--yes",
        "@kud/mcp-jenkins@latest",
        "--url",
        "https://pipeline.yourcompany.com",
        "--bearer-token",
        "your_bearer_token"
      ]
    }
  }
}

Multiple Jenkins instances:

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "https://pipeline.yourcompany.com,https://scheduler.yourcompany.com",
        "MCP_JENKINS_USER": "your_username,your_username",
        "MCP_JENKINS_API_TOKEN": "token1,token2"
      }
    }
  }
}

3. Restart

Quit (Cmd+Q / Alt+F4) and reopen Claude Desktop

</details>

📝 VSCode

For: VSCode with MCP-compatible extensions (Cline, Claude Dev, Continue)

<details> <summary>Click to expand VSCode setup</summary>

Cline:

Settings (Cmd+, / Ctrl+,) → Search "Cline: MCP Settings" → Edit in settings.json:

{
  "cline.mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["@kud/mcp-jenkins"],
      "env": {
        "JENKINS_URL": "https://pipeline.yourcompany.com",
        "JENKINS_USER": "your_username",
        "JENKINS_API_TOKEN": "your_api_token"
      }
    }
  }
}

Multiple Jenkins instances:

{
  "cline.mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["@kud/mcp-jenkins"],
      "env": {
        "MCP_JENKINS_URL": "https://pipeline.yourcompany.com,https://scheduler.yourcompany.com",
        "MCP_JENKINS_USER": "your_username,your_username",
        "MCP_JENKINS_API_TOKEN": "token1,token2"
      }
    }
  }
}

Or for local installation, use "command": "node" and "args": ["/absolute/path/to/mcp-jenkins/dist/index.js"]

Claude Dev / Continue:

Command Palette (Cmd+Shift+P) → "MCP: Edit Config" → Add similar configuration

Reload window after configuration

</details>

🌐 Cursor

For: Cursor IDE with built-in AI

<details> <summary>Click to expand Cursor setup</summary>

Settings (Cmd+, / Ctrl+,) → Search "MCP" → Edit Config or open ~/.cursor/mcp_config.json:

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "JENKINS_URL": "https://pipeline.yourcompany.com",

MCP Jenkins

Install / Use

README

Jenkins MCP Server

🌟 Features

🚀 Quick Start

Prerequisites

Installation

Configuration Priority

Quick Setup Example (Claude CLI)

📚 Installation Guides

🎯 Claude Code CLI

🌐 Claude Code Web

🖥️ Claude Desktop

1. Open Configuration File

2. Add Configuration

3. Restart

📝 VSCode

🌐 Cursor