Jenkins MCP Server

An MCP (Model Context Protocol) server for interacting with Jenkins instances protected by Cloudflare Access. Built for use with Kiro and other MCP-compatible AI coding tools.

Prerequisites

• Node.js (v18+)

• cloudflared CLI installed

• A Jenkins API token (generate one from Jenkins → Your User → Configure → API Token)

Related MCP server: Jenkins MCP Server

Installation

1. Clone this repo:

git clone https://github.com/kmlarso6/jenkins-mcp-server.git
cd jenkins-mcp-server

2. Install dependencies:

npm install

MCP Configuration

Add the following to your Kiro MCP config at ~/.kiro/settings/mcp.json (or your workspace .kiro/settings/mcp.json):

{
  "mcpServers": {
    "Jenkins": {
      "command": "node",
      "args": ["/path/to/jenkins-mcp-server/index.mjs"],
      "env": {
        "JENKINS_URL": "https://jenkins.devops.asu.edu",
        "JENKINS_USER": "{YOUR_EXCEPTION_ASURITE}",
        "JENKINS_TOKEN": "{YOUR_API_KEY}"
      },
      "disabled": false,
      "autoApprove": [
        "get_build",
        "get_build_log",
        "get_job",
        "list_builds",
        "get_test_results",
        "get_artifact",
        "download_test_results",
        "list_stages",
        "get_stage_log",
        "get_failed_tests",
        "compare_builds"
      ]
    }
  }
}

Replace:

• /path/to/jenkins-mcp-server/index.mjs with the absolute path to your cloned copy

• {YOUR_EXCEPTION_ASURITE} with your Jenkins username (exception ASURITE)

• {YOUR_API_KEY} with your Jenkins API token

Cloudflare Access Authentication

The Jenkins instance is behind Cloudflare Access. Before using the MCP tools, you need a valid Cloudflare token.

Initial Login

cloudflared access login "https://jenkins.devops.asu.edu"

This prints an authorization URL. Open it in your browser, complete ASU SSO login, and the token is cached automatically at ~/.cloudflared/.

Token Verification

cloudflared access token -app=https://jenkins.devops.asu.edu

If this returns a JWT string, you're authenticated.

Token Expiry

Tokens expire after several hours. If MCP tool calls start failing with Cloudflare errors, re-run the login command above.

Installing the Kiro Skill

This repo includes a Kiro skill that helps the AI agent manage the Cloudflare auth flow automatically.

To install it, copy the skill into your Kiro skills directory:

cp -r skills/jenkins-access ~/.kiro/skills/

Once installed, Kiro will activate the skill when Jenkins access is needed or when auth errors occur.

Available Tools

Job Path Format

Jenkins job paths follow the pattern: <GitHub-Org>/<repo-name>/<branch>

For example: MyOrg/my-repo/main