Jenkins

by kjozsa

8 stars
511 downloads
Not rated
GitHub

About

Integrates with Jenkins CI/CD operations, enabling job listing, build triggering, and status checking for streamlined DevOps automation and pipeline management.

Details

Author
kjozsa
Repository
kjozsa/jenkins-mcp
GitHub stars
8
Downloads
511
License
Apache License 2.0
Categories
Productivity, Design, Developer Tools, AI, Infrastructure, Other
Tags
#integration

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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Jenkins
    Command (node, npx, python, etc.) uvx
    Arguments
    • Argument 1 jenkins-mcp
    Environment
    • JENKINS_URL https://your-jenkins-server/
    • JENKINS_PASSWORD your-password
    • JENKINS_USERNAME your-username
    • JENKINS_USE_API_TOKEN false

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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

To install Jenkins MCP for Claude Desktop automatically via Smithery:

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

uv pip install -r requirements.txt

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Jenkins MCP

smithery badge MCP server for managing Jenkins operations.

<a href="https://glama.ai/mcp/servers/7j3zk84u5p">
Jenkins MCP server
</a>

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

```bash
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.