Jenkins Api MCP Server

🚀 Jenkins API MCP 服務器

這是一個基於 Spring AI 的 MCP 服務，用於處理 Jenkins REST API 調用，為管理 Jenkins 作業提供常用操作接口，能有效提升 Jenkins 作業管理的便捷性和效率。

✨ 主要特性

• 作業管理：可對 Jenkins 作業進行創建、刪除、啟用/禁用、重命名等操作。
• 作業構建：支持觸發構建、帶參數構建以及停止構建等功能。
• 作業信息：能夠獲取作業信息、構建信息以及構建日誌。
• 作業配置：可獲取和更新作業配置。

🔧 技術細節

本項目採用的技術棧如下：

🚀 快速開始

先決條件

• 需要 JDK 17 及以上版本。
• 需安裝 Maven 3.6 及以上版本。
• 要使用啟用了“遠程訪問 API”的 Jenkins 服務器。

構建項目

克隆倉庫並進入項目目錄：

git clone [倉庫地址]
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": "用戶名", 
        "JENKINS_API_TOKEN": "密碼/令牌"
      }
    }
  }
}

📄 API 文檔

作業管理

• createJob：創建一個新的 Jenkins 作業。
• deleteJob：刪除一個現有的 Jenkins 作業。
• enableJob：啟用一個被禁用的 Jenkins 作業。
• disableJob：禁用一個已啟用的 Jenkins 作業。
• renameJob：重命名一個現有的 Jenkins 作業。

作業構建

• buildJob：觸發一個作業的構建。
• buildJobWithParams：帶參數地觸發構建。
• killJob：停止正在運行的構建。

作業信息

• getJobInfo：獲取作業的詳細信息。
• getBuildInfo：獲取特定構建的信息。
• getBuildLog：獲取構建的控制檯輸出日誌。
• getLastBuildNumber：獲取最後一個構建編號。
• getLastBuildTimestamp：獲取最後一個構建的時間戳。

作業配置

• getJobConfig：獲取作業的配置 XML。
• updateJobConfig：更新作業的配置。