项目简介
本项目是一个 Model Context Protocol (MCP) 服务器,旨在为 AI 助手提供与 Jenkins CI/CD 服务器集成的能力。通过此服务器,AI 助手可以方便地查询 Jenkins 构建状态、触发新的构建任务以及获取构建日志,从而实现更智能的自动化流程。
主要功能点
- 获取构建状态 (get_build_status): 查询指定 Jenkins 项目的构建状态,例如成功、失败、构建中等。
- 触发构建 (trigger_build): 启动一个新的 Jenkins 构建任务,并可以传递构建参数。
- 获取构建日志 (get_build_log): 获取指定 Jenkins 构建的完整控制台输出日志。
安装步骤
-
克隆仓库:
git clone https://github.com/hekmon8/Jenkins-server-mcp.git cd Jenkins-server-mcp -
安装依赖:
npm install -
构建项目:
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" 部分的说明和示例代码。
信息
分类
开发者工具