项目简介

本项目是一个 Model Context Protocol (MCP) 服务器,旨在为 AI 助手提供与 Jenkins CI/CD 服务器集成的能力。通过此服务器,AI 助手可以方便地查询 Jenkins 构建状态、触发新的构建任务以及获取构建日志,从而实现更智能的自动化流程。

主要功能点

  • 获取构建状态 (get_build_status): 查询指定 Jenkins 项目的构建状态,例如成功、失败、构建中等。
  • 触发构建 (trigger_build): 启动一个新的 Jenkins 构建任务,并可以传递构建参数。
  • 获取构建日志 (get_build_log): 获取指定 Jenkins 构建的完整控制台输出日志。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/hekmon8/Jenkins-server-mcp.git
    cd Jenkins-server-mcp
  2. 安装依赖:

    npm install
  3. 构建项目:

    npm run build

服务器配置

要将此 MCP 服务器连接到 MCP 客户端(例如 Claude),您需要在客户端的 MCP 服务器配置文件中添加以下配置。请根据您的实际情况修改以下参数:

{
  "mcpServers": {
    "jenkins-server": {
      "command": "node",
      "args": ["/path/to/jenkins-server-mcp/build/index.js"],
      "env": {
        "JENKINS_URL": "YOUR_JENKINS_URL",  // 您的 Jenkins 服务器 URL,例如 "https://your-jenkins-server.com"
        "JENKINS_USER": "YOUR_JENKINS_USERNAME", // 您的 Jenkins 用户名
        "JENKINS_TOKEN": "YOUR_JENKINS_API_TOKEN"  // 您的 Jenkins API Token,请在 Jenkins 用户设置中生成
      }
    }
  }
}

请注意:

  • 将 '"/path/to/jenkins-server-mcp/build/index.js"' 替换为实际的 'index.js' 文件路径。
  • 将 'YOUR_JENKINS_URL', 'YOUR_JENKINS_USERNAME', 和 'YOUR_JENKINS_API_TOKEN' 替换为您的 Jenkins 服务器的真实信息。Jenkins API Token 需要在 Jenkins 用户设置中创建。

基本使用方法

配置完成后,您的 MCP 客户端即可通过 'jenkins-server' 这个服务器名来调用预定义的工具。例如,在 Claude 中,您可以指示 Claude 使用 'jenkins-server' 服务器的 'get_build_status' 工具来查询构建状态。

具体的工具调用方式和参数,请参考仓库 'README.md' 文件中 "Tools and Usage" 部分的说明和示例代码。

信息

分类

开发者工具