MCP ExplorerExplorer

Jenkins Mcp

@kjozsaon a year ago
8 Apache-2.0
FreeCommunity
AI Systems
Jenkins MCP is a server for managing Jenkins operations, including job listing and build triggering.

Overview

What is Jenkins Mcp

jenkins-mcp is an MCP server designed for managing Jenkins operations, allowing users to interact with Jenkins jobs and builds efficiently.

Use cases

Use cases for jenkins-mcp include automating build processes, monitoring build statuses, and managing Jenkins jobs programmatically.

How to use

To use jenkins-mcp, you can install it via Smithery using the command npx -y @smithery/cli install @kjozsa/jenkins-mcp --client claude or manually with uvx install jenkins-mcp. Configuration requires adding a JSON snippet with your Jenkins server details.

Key features

Key features of jenkins-mcp include listing Jenkins jobs, triggering builds with optional parameters, and checking build statuses.

Where to use

jenkins-mcp can be used in software development environments where Jenkins is utilized for continuous integration and deployment processes.

Content

Jenkins MCP

smithery badge
MCP server for managing Jenkins operations.

Jenkins MCP server

Installation

Installing via Smithery

To install Jenkins MCP for Claude Desktop automatically via Smithery:

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

Installing Manually

uvx install jenkins-mcp

Configuration

Add the MCP server using the following JSON configuration snippet:

{
  "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"
      }
    }
  }
}

CSRF Crumb Handling

Jenkins implements CSRF protection using “crumbs” - tokens that must be included with POST requests. This MCP server handles CSRF crumbs in two ways:

  1. Default Mode: Automatically fetches and includes CSRF crumbs with build requests

    • Uses session cookies to maintain the web session
    • Handles all the CSRF protection behind the scenes
  2. API Token Mode: Uses Jenkins API tokens which are exempt from CSRF protection

    • Set JENKINS_USE_API_TOKEN=true
    • Set JENKINS_PASSWORD to your API token instead of password
    • Works with Jenkins 2.96+ which doesn’t require crumbs for API token auth

You can generate an API token in Jenkins at: User → Configure → API Token → Add new Token

Features

  • List Jenkins jobs
  • Trigger builds with optional parameters
  • Check build status
  • CSRF crumb handling for secure API access

Development

# Install dependencies
uv pip install -r requirements.txt

# Run in dev mode with Inspector
mcp dev jenkins_mcp/server.py

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers