Jenkins API MCP Server

Jenkins API MCP Server

site icon
2025.04.09 0
JavaJenkins 任务管理自动化构建开发效率
Jenkins API MCP Server 是一个基于 Spring AI 的 MCP 服务,用于通过 Jenkins Rest API 调用,提供常见的 Jenkins 任务操作接口。
View on GitHub

Overview

基本能力

产品定位

Jenkins API MCP Server 是一个用于管理和操作 Jenkins 任务的中间件服务,旨在简化 Jenkins 任务的自动化管理流程。

核心功能

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

适用场景

  • 持续集成/持续部署 (CI/CD):自动化构建和部署流程。
  • 任务监控:实时获取任务状态和构建日志。
  • 任务配置管理:批量更新或修改任务配置。

工具列表

  • Jenkins REST API Client:用于与 Jenkins 服务器交互。
  • Spring Boot:提供基础的 Web 服务框架。
  • Spring AI MCP Server:提供 MCP 服务支持。

常见问题解答

  • 如何配置 Jenkins 服务器信息?:通过 mcp.json 配置文件中的 JENKINS_API_SERVER_URIJENKINS_API_USERNAMEJENKINS_API_TOKEN 环境变量配置。
  • 如何启动服务?:使用 java -jar 命令启动生成的 JAR 文件。

使用教程

使用依赖

  • JDK 17+:确保已安装 JDK 17 或更高版本。
  • Maven 3.6+:确保已安装 Maven 3.6 或更高版本。
  • Jenkins 服务器:确保 Jenkins 服务器已启用 "Remote Access API"。

安装教程

  1. 克隆仓库并进入项目目录: bash git clone [repository-url] cd jenkins-mcp-server
  2. 使用 Maven 打包项目: bash mvn package
  3. 生成的 JAR 文件位于 /target 目录,路径为 {your_path}\\mcp-jenkins-server-0.0.1-SNAPSHOT.jar

调试方式

  1. 启动服务: bash java -jar {your_path}\\mcp-jenkins-server-0.0.1-SNAPSHOT.jar
  2. 检查日志输出,确保服务正常启动并无错误信息。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。