theBansal/mcp-server-mvps
If you are the rightful owner of mcp-server-mvps and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Jenkins MCP Server is a lightweight Model Context Protocol server designed to integrate and automate Jenkins operations, facilitating seamless interaction with Claude Desktop.
Jenkins MCP Server
A lightweight MCP (Model Context Protocol) server to integrate and automate Jenkins operations, designed for seamless interaction with Claude Desktop.
Table of Contents
- Overview
- Prerequisites
- Installation
- Running the MCP Server
- Integrating with Claude Desktop
- Usage
- Troubleshooting
- FAQ
Overview
This project provides an MCP (Model Context Protocol) server that acts as a bridge between Jenkins and Claude Desktop, enabling you to trigger builds, read logs, monitor jobs, and more via natural language commands.
Prerequisites
- Docker (for running Jenkins locally)
- Python 3.8+
uv
(a fast Python package installer and runner)- Jenkins API token and user credentials
Installation
1. Set Up Jenkins (Local Demo)
You can quickly spin up a local Jenkins server using Docker:
docker run -p 8080:8080 -p 50000:50000 jenkins/jenkins:lts
- Access Jenkins at http://localhost:8080
- Create a user and generate an API token for that user (Manage Jenkins → Manage Users → Your User → Configure → API Token)
2. Install uv
uv
is a fast Python package manager and runner, serving as a drop-in replacement for pip and venv. It ensures reproducible, isolated environments.
Install uv
:
curl -Ls https://astral.sh/uv/install.sh | sh
Or, if you have pipx:
pipx install uv
3. Install Project Dependencies
Inside the project directory, run:
uv pip install -r requirements.txt
This will create a virtual environment and install all required dependencies.
Running the MCP Server
-
Set Environment Variables
- Copy
.env.example
to.env
and fill in your Jenkins server details and credentials, or set them manually in your shell.
- Copy
-
Start the Server
uv run jenkins-mcp-server.py
Keep this server running to allow communication with Claude Desktop.
Integrating with Claude Desktop
- Install Claude Desktop (from here or your preferred source)
- Open Settings → Developer → MCP Server → Edit Config
- Replace the
clause_desktop_config.json
file with the one provided in this repo, or merge its contents into your existing config.- Ensure the path to
jenkins-mcp-server.py
is correct in the config.
- Ensure the path to
- Restart Claude Desktop to apply changes.
Usage
Once setup is complete, you can interact with Claude Desktop to:
- Trigger Jenkins builds
- Read build logs
- Monitor job statuses
- And much more, all via natural language
Troubleshooting
-
Connectivity Issues:
If Claude Desktop cannot connect to Jenkins via the MCP server, check the MCP server logs for errors. -
Missing Packages:
If you see errors about missing packages, install them in the environment where Claude Desktop is running.uv pip install <missing-package>
-
Jenkins API Issues:
Ensure your Jenkins user has the correct permissions and the API token is valid.
FAQ
Q: What is uv
and why use it?
A: uv
is a fast, modern Python package manager and runner. It creates isolated environments and installs dependencies much faster than pip, making setup and reproducibility easier.
Q: Can I use pip/venv instead of uv?
A: Yes, but uv
is recommended for speed and simplicity. If you prefer pip, use python -m venv venv
and pip install -r requirements.txt
.
For further questions or issues, please open an issue in this repository.