Jenkins MCP Server
A Model Context Protocol (MCP) server that exposes a Jenkins controller's RESTAPI to MCP-compatible clients such as Claude Desktop. Built on theMCP Python SDK (1.27+,protocol 2025-11-25) using FastMCP with httpx for async HTTP andpydantic-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
