Jenkins MCP Server

🚀 Jenkins MCP Server

A Model Context Protocol (MCP) server that provides access to Jenkins data and functionality, serving Large Language Models (LLMs) through standardized interfaces.

🚀 Quick Start

This project implements an MCP server that connects to a Jenkins instance, enabling large language models to:

• Access Jenkins job data as resources.
• Perform Jenkins-related operations via tools.
• Utilize predefined prompts for common Jenkins interactions.

📦 Installation

Prerequisites

• Python 3.8+
• Access to a Jenkins instance

Set up the environment using uv

We recommend using uv to manage your Python environment:

# If uv is not installed, run the following command to install it
curl -sSf https://install.ultraviolet.dev | sh

# Create a new project
uv init jenkins-mcp-server
cd jenkins-mcp-server

# Add dependencies
uv add "mcp[cli]"
uv add python-jenkins

Environment Variables

Create a .env file and enter your Jenkins configuration information:

# Create the .env file
cat > .env << EOL
JENKINS_URL=https://your-jenkins-instance.com
JENKINS_USERNAME=your_username
JENKINS_API_TOKEN=your_api_token
EOL

# Load the environment variables in your shell
source .env

💻 Usage Examples

Run the Server

Start the server in development mode:

uv run mcp dev server.py

✨ Features

• Resources: Access Jenkins job configurations, build histories, and status information.
• Tools: Trigger builds, update job configurations, and manage Jenkins tasks.
• Prompts: Predefined interaction patterns for common Jenkins operations.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is under the MIT License. See the LICENSE file for details.