Jenkins

Provides an MCP interface to manage Jenkins jobs, trigger builds, and monitor status with optional CSRF handling.

python

9

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kjozsa-jenkins-mcp": {
      "command": "uvx",
      "args": [
        "jenkins-mcp"
      ],
      "env": {
        "JENKINS_URL": "https://your-jenkins-server/",
        "JENKINS_PASSWORD": "your-password",
        "JENKINS_USERNAME": "your-username",
        "JENKINS_USE_API_TOKEN": "false"
      }
    }
  }
}

Jenkins MCP lets you manage Jenkins operations through a dedicated MCP server. You can list jobs, trigger builds with parameters, check build status, and securely handle CSRF protection when interacting with Jenkins APIs. This server acts as a bridge between your MCP client and your Jenkins instance, simplifying automation and integration.

How to use

You connect to Jenkins MCP from your MCP client and use its built-in actions to manage your Jenkins jobs. Typical workflows include listing available jobs, triggering a build with optional parameters, and polling for the current build status. If your Jenkins instance requires CSRF protection, you can rely on the server to handle crumbs automatically in default mode, or switch to API token mode for token-based authentication that bypasses crumbs.

How to install

Prerequisites you need before you install and run Jenkins MCP:

Node.js and npm should be installed on your system if you plan to use the Smithery installation flow.
Python and uvx are not strictly required for the MCP client, but may be part of your environment for other tools.

Install via Smithery to add Jenkins MCP for Claude Desktop automatically:

npx -y @smithery/cli install @kjozsa/jenkins-mcp --client claude

Or install manually using the MCP runtime command shown in the configuration flow:

uvx install jenkins-mcp

Configuration

Add the MCP server using the following configuration snippet. This enables the server to run locally and connect to your Jenkins instance using environment variables for credentials.

{
  "mcpServers": {
    "jenkins-mcp": {
      "command": "uvx",
      "args": ["jenkins-mcp"],
      "env": {
        "JENKINS_URL": "https://your-jenkins-server/",
        "JENKINS_USERNAME": "your-username",
        "JENKINS_PASSWORD": "your-password",
        "JENKINS_USE_API_TOKEN": "false"
      }
    }
  }
}

Available tools

List jobs

Retrieve the available Jenkins jobs to understand what can be built or managed.

Trigger build

Start a Jenkins build with optional parameters to customize the run.

Check build status

Poll or query the status of a running or completed build to track progress.

CSRF crumb handling

Automatically handle CSRF crumbs in default mode or switch to API token mode for token-based authentication.