使用说明
英语| 中文
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:更新作业的配置