Jenkins API MCP 服务器

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

功能特性

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

技术栈

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

快速开始

环境要求

• JDK 17+
• Maven 3.6+
• Jenkins 服务器（启用 "Remote Access API"）

构建项目

克隆仓库并导航到项目目录：

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

在运行项目之前，需要使用 Maven 打包：

mvn package

成功构建后，将在 /target 目录中生成一个名为 mcp-jenkins-server-0.0.1-SNAPSHOT.jar 的文件。在您的 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 : 更新一个作业的配置