Jenkins Mcp

English | 中文

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：更新任务配置