Jenkins作业管理服务

基于Spring AI的Jenkins API MCP服务器,提供Jenkins作业的创建、删除、构建、信息查询和配置管理等核心功能,适用于持续集成和自动化构建场景。

  • by ProgrammerAgua
  • Java
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ProgrammerAgua/jenkins-mcp-server

使用说明

英语| 中文

Jenkins API MCP服务器

这是一个基于Spring AI的MCP服务器服务,用于Jenkins Rest API调用,为Jenkins作业提供通用操作接口。

特性

  • 作业管理:创建、删除、启用/禁用、重命名作业
  • 作业构建:触发构建、使用参数构建、停止构建
  • 作业信息:获取作业信息、构建信息、构建日志
  • 作业配置:获取和更新作业配置

技术栈

  • 弹簧靴3.3.6
  • Jenkins REST API客户端
  • Spring AI MCP服务器

快速开始

需求

  • JDK 17+
  • Maven 3.6+
  • Jenkins服务器(启用“远程访问API”)

生成项目

克隆存储库并导航到项目目录:

git clone [repository-url]
cd jenkins-mcp-server

在运行项目之前,您需要使用Maven对其进行打包:

mvn package

成功构建后,一个名为 mcp-jenkins-server-0.0.1-SNAPSHOT.jar 将在 /target 目录。在您的 mcp.json 配置:

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

mcp.json配置

{
  "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"
      }
    }
  }
}

API文档

作业管理

  • createJob:创建一个新的Jenkins作业
  • deleteJob:删除现有的Jenkins作业
  • enableJob:启用禁用的Jenkins作业
  • disableJob:禁用已启用的Jenkins作业
  • renameJob:重命名现有的Jenkins作业

就业建设

  • buildJob:触发Jenkins作业的构建
  • buildJobWithParams:使用参数触发构建
  • killJob:停止正在运行的构建

工作信息

  • getJobInfo:获取有关作业的详细信息
  • getBuildInfo:获取特定构建的信息
  • getBuildLog:获取构建的控制台输出
  • getLastBuildNumber:获取最后一个内部版本号
  • getLastBuildTimestamp:获取上次构建的时间戳

作业配置

  • getJobConfig:获取作业的配置XML
  • updateJobConfig:更新作业的配置