# avisangle/jenkins-mcp-server [Health: Active]

**Category:** ☁️ Cloud Platforms  
**Repository:** https://github.com/avisangle/jenkins-mcp-server  
**GitHub Stars:** 4  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/avisangle-jenkins-mcp-server

## Description
Enterprise-grade Jenkins CI/CD integration with multi-tier caching, pipeline monitoring, artifact management, and batch operations. Features 21 MCP tools for job management, build status tracking, and queue management with CSRF protection and 2FA support.

## Tools
Capabilities this server exposes over MCP:

- **trigger_job** — Trigger a Jenkins job with optional parameters.
- **get_job_info** — Get detailed information about a Jenkins job.
- **list_jobs** — List Jenkins jobs with advanced filtering.
- **search_jobs** — Search for Jenkins jobs by pattern.
- **search_and_trigger** — Search for jobs and trigger all matches.
- **get_folder_info** — Get information about a Jenkins folder.
- **get_build_status** — Get status of a specific build.
- **get_console_log** — Get console output from a build.
- **summarize_build_log** — Get a summarized version of build console log.
- **get_pipeline_status** — Get detailed pipeline execution status with stage information.
- **list_build_artifacts** — List all artifacts from a build.
- **download_build_artifact** — Download a specific build artifact.
- **search_build_artifacts** — Search for artifacts across multiple builds.
- **batch_trigger_jobs** — Trigger multiple jobs in parallel with priority queuing.
- **batch_monitor_jobs** — Monitor the status of a batch operation.
- **batch_cancel_jobs** — Cancel a batch operation.
- **get_queue_info** — Get information about the Jenkins build queue.
- **server_info** — Get basic Jenkins server information.
- **get_cache_statistics** — Get statistics about the caching system.
- **clear_cache** — Clear cached data.
- **warm_cache** — Pre-populate cache with commonly used data.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "jenkins-mcp-server": {
    "command": "npx",
    "args": ["-y","avisangle-jenkins-mcp-server"],
    "env": {
      "JENKINS_URL": "",
      "JENKINS_USER": "",
      "JENKINS_API_TOKEN": "",
      "JENKINS_MAX_RETRIES": "",
      "JENKINS_RETRY_BASE_DELAY": "",
      "JENKINS_RETRY_MAX_DELAY": "",
      "MCP_PORT": "",
      "MCP_HOST": ""
    }
  }
}
```

**Requires environment variables:** `JENKINS_URL`, `JENKINS_USER`, `JENKINS_API_TOKEN`, `JENKINS_MAX_RETRIES`, `JENKINS_RETRY_BASE_DELAY`, `JENKINS_RETRY_MAX_DELAY`, `MCP_PORT`, `MCP_HOST` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What avisangle/jenkins-mcp-server MCP server does

The avisangle/jenkins-mcp-server MCP server exposes Jenkins CI/CD operations as MCP tools. It can list, search, inspect, and trigger jobs, including jobs organized inside nested folders. Job searches support wildcard patterns, optional regular expressions, job-type filters, folder-depth limits, status filters, build-result filters, and enabled-only filtering.

Build-focused tools retrieve build status, duration, timestamps, executor details, console output, and summarized logs. Pipeline jobs can be inspected stage by stage, including stage status, duration, and logs. Artifact tools list files from a build, download a selected artifact, or search for matching artifacts across multiple builds.

## How it works

The server authenticates to Jenkins with a Jenkins URL, username, and API token. It handles Jenkins CSRF crumb tokens automatically and includes retry behavior with exponential backoff. Input validation is provided through Pydantic-based validation.

MCP clients can communicate with the server over STDIO, the default transport intended for local clients such as Claude Desktop, or over Streamable HTTP. HTTP mode accepts host and port settings and is intended for MCP gateways or remote connections. Batch tools can trigger multiple jobs in parallel, monitor a batch operation, and cancel one. Queue tools provide information about pending Jenkins builds.

Caching is divided into five tiers for different data lifetimes. The server also provides tools to inspect cache statistics, clear cached data, and warm the cache with commonly used information.

## Setup and configuration

Running the avisangle/jenkins-mcp-server MCP server requires Node.js 14 or newer, Python 3.12 or newer, and a Jenkins installation; Jenkins 2.401 or newer is recommended. The repository installation process uses `npm install`, followed by `pip install -e .` or an equivalent editable installation with `uv`.

Set `JENKINS_URL`, `JENKINS_USER`, and `JENKINS_API_TOKEN` before starting the server. Optional settings control retry limits and delays, cache time-to-live values and sizes, log and content limits, artifact download size, and the HTTP host and port. A Jenkins API token is created from the user's Jenkins configuration page.

The documented STDIO entry point is `node bin/jenkins-mcp.js`. Streamable HTTP can be selected with `--transport streamable-http`, along with `--port` and `--host` options. The README includes a Claude Desktop configuration that starts this entry point and passes the Jenkins settings as environment variables.

## Tools and capabilities

The avisangle/jenkins-mcp-server MCP server provides tools for:

- Triggering one job, searching and triggering matching jobs, or triggering multiple jobs in parallel.
- Listing jobs recursively, searching by pattern, and inspecting job or folder details.
- Reading build status, console logs, summarized logs, and pipeline stage status.
- Listing, downloading, and searching build artifacts.
- Monitoring and canceling batch operations and inspecting the Jenkins queue.
- Reading Jenkins server information and managing cache statistics, contents, and warm-up operations.

## Limitations and notes

Jenkins credentials are required, and the server depends on access to the target Jenkins instance. Artifact downloads have a configurable maximum size, with a documented default of 50 MB. Console and general content responses also have configurable size limits. The README documents 21 tools, so the available operations are centered on the listed Jenkins job, build, pipeline, artifact, queue, batch, and cache functions rather than general Jenkins administration.

_Full upstream README: https://allmcps.com/mcp/avisangle-jenkins-mcp-server/readme_