READMEmain

Jenkins MCP Server

A Model Context Protocol (MCP) server that exposes a Jenkins controller's REST API to MCP-compatible clients such as Claude Desktop. Built on the MCP Python SDK (1.27+, protocol 2025-11-25) using FastMCP with httpx for async HTTP and pydantic-settings for configuration.

Features

HTTP basic authentication using a Jenkins username + API token
Automatic CSRF crumb fetch and cache for POST requests
Works with nested folder job paths (team/app/main)
Tools for jobs, builds, console logs, queue, nodes and plugins

Installation

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Configuration

All configuration is read from environment variables prefixed with JENKINS_.

Variable	Default	Description
`JENKINS_BASE_URL`	`http://localhost:8080`	Base URL of the Jenkins controller
`JENKINS_USERNAME`	(empty)	Jenkins user for HTTP basic auth
`JENKINS_API_TOKEN`	(empty)	Jenkins API token (create in user settings)
`JENKINS_VERIFY_SSL`	`true`	Verify TLS certificates
`JENKINS_TIMEOUT`	`30`	HTTP timeout in seconds

A .env file in the working directory is also picked up automatically.

Running

jenkins-mcp

Claude Desktop configuration

Add an entry to claude_desktop_config.json:

{
  "mcpServers": {
    "jenkins": {
      "command": "jenkins-mcp",
      "env": {
        "JENKINS_BASE_URL": "https://jenkins.example.com",
        "JENKINS_USERNAME": "your-username",
        "JENKINS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Tools

Tool	Description
`list_jobs`	List jobs (optionally scoped to a folder)
`get_job`	Return full job metadata
`trigger_build`	Trigger a build, optionally with parameters
`get_build`	Return metadata for a specific build
`get_build_log`	Fetch the console text for a build
`stop_build`	Stop a running build
`list_builds`	List recent builds (`limit` defaults to 20)
`list_queue`	List queued build items
`cancel_queue_item`	Cancel a queue item by id
`list_nodes`	List Jenkins nodes / agents
`get_plugin_list`	List installed Jenkins plugins

Development

Run tests with:

pytest -x --tb=short

Lint with:

ruff check src tests

jenkins-mcp-server