Jenkins

You can leverage this MCP server to integrate Jenkins into your workflow, enabling you to query server info, inspect jobs and builds, view logs, manage views, and trigger builds directly through your MCP client. This makes automating Jenkins tasks simpler and more consistent across tools and teams.

How to use

Connect to the MCP server from your MCP client using the stdio configuration provided. This server exposes tools to get Jenkins information, list and inspect jobs, retrieve recent builds, fetch build details and console output, manage views, and trigger builds with parameters. Use the functions in your client to perform common Jenkins operations without leaving your MCP environment.

How to install

Prerequisites you need before running the MCP Jenkins Server:

• Python 3.10+
• A Jenkins server with API access
• A Jenkins API token or credentials for authentication

Install the MCP Jenkins Server runtime and dependencies with these steps.

pip install -r requirements.txt

Configuration

Create a configuration file for your MCP client to connect to Jenkins through this MCP server. You will specify how to launch the MCP server and the credentials needed to access Jenkins.

JENKINS_URL=https://your-jenkins-server
JENKINS_USER=your-username
JENKINS_TOKEN=your-api-token

CLI configuration

To add this MCP server to your CLI, configure the following snippet. Copy the content exactly and place it where your MCP client reads server configurations.

{
  "mcpServers": {
    "mcp-jenkins-server": {
      "command": "/Users/username/.local/bin/uv -> //uv full path", 
      "args": [
        "--directory", 
        "/Users/username/Desktop/mcp-jenkins-server -> //project path ", 
        "run",
        "server.py"
      ],
      "env": {
        "JENKINS_URL": "http://localhost:8080",
        "JENKINS_USERNAME": "xx",
        "JENKINS_PASSWORD": "xx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available tools

get_jenkins_info

Retrieve Jenkins server information such as version, URL, and basic capabilities.

list_jobs

List all Jenkins jobs available on the connected Jenkins server.

get_job_info

Fetch detailed information about a specific job, including configuration and status.

get_last_builds

Get a summary of the most recent builds for a given job, with an optional count parameter.

get_build_info

Retrieve detailed information about a specific build for a given job.

get_build_console_output

Fetch the console output for a specific build to review logs and errors.

get_views

List all Jenkins views configured in the server.

trigger_job_build

Trigger a build for a specified job, with optional parameters.