Jenkins Api MCP Server

🚀 Jenkins API MCP Server

This is an MCP service based on Spring AI, designed to handle Jenkins REST API calls and provide common operation interfaces for managing Jenkins jobs.

✨ Features

• Job Management: Create, delete, enable/disable, and rename jobs.
• Job Building: Trigger builds, build with parameters, and stop builds.
• Job Information: Retrieve job information, build information, and build logs.
• Job Configuration: Get and update job configurations.

🔧 Technical Details

• Spring Boot 3.3.6
• Jenkins REST API Client
• Spring AI MCP Server

🚀 Quick Start

Prerequisites

• JDK version 17 or higher.
• Maven version 3.6 or higher.
• A Jenkins server with "Remote access API" enabled.

Build the Project

Clone the repository and navigate to the project directory:

git clone [Repository URL]
cd jenkins-mcp-server

Before running the project, build it using Maven:

mvn package

After a successful build, a file named mcp-jenkins-server-0.0.1-SNAPSHOT.jar will be generated in the /target directory. Add the full path of this file to your mcp.json configuration file:

{your_path}\\mcp-jenkins-server-0.0.1-SNAPSHOT.jar

mcp.json Configuration

{
  "mcpServers": {
    "jenkins-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "{your_path}\\mcp-jenkins-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "JENKINS_API_SERVER_URI": "jenkins-uri",
        "JENKINS_API_USERNAME": "Username", 
        "JENKINS_API_TOKEN": "Password/Token"
      }
    }
  }
}

📚 Documentation

Job Management

• createJob: Create a new Jenkins job.
• deleteJob: Delete an existing Jenkins job.
• enableJob: Enable a disabled Jenkins job.
• disableJob: Disable an enabled Jenkins job.
• renameJob: Rename an existing Jenkins job.

Job Building

• buildJob: Trigger a job build.
• buildJobWithParams: Trigger a build with parameters.
• killJob: Stop a running build.

Job Information

• getJobInfo: Get detailed information about a job.
• getBuildInfo: Get information about a specific build.
• getBuildLog: Get the console output log of a build.
• getLastBuildNumber: Get the number of the last build.
• getLastBuildTimestamp: Get the timestamp of the last build.

Job Configuration

• getJobConfig: Get the XML configuration of a job.
• updateJobConfig: Update the configuration of a job.