AI导哈

Jenkins CI/CD 服务器交互工具

一个提供与Jenkins CI/CD服务器（包括CloudBees CI）交互工具的模型上下文协议（MCP）服务器，使AI助手能够通过标准化接口检查构建状态、触发构建、停止构建和检索构建日志。

  • by grysonbaltazar
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 grysonbaltazar/jenkins-server-mcp

使用说明

Jenkins服务器MCP

一个模型上下文协议（MCP）服务器，提供与Jenkins CI/CD服务器（包括CloudBees CI）交互的工具。该服务器使AI助手能够通过标准化的界面检查构建状态、触发构建、停止构建和检索构建日志。

特性

  • ✅ 获取构建状态 -检索详细的构建信息，包括构建编号、状态、时间和结果
  • ✅ 触发器构建 -使用或不使用参数启动构建（自动检测构建类型）
  • ✅ 停止构建 -停止当前运行的构建
  • ✅ 列表构建 -获取任何作业的最新版本列表
  • ✅ 获取构建日志 -从构建中检索控制台输出
  • ✅ CloudBees CI支持 -适用于标准Jenkins和CloudBees CI

安装

  1. 克隆此存储库：
git clone https://github.com/grysonbaltazar/jenkins-server-mcp.git
cd jenkins-server-mcp
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

内置服务器将在 build/index.js.

配置

服务器需要以下环境变量：

  • JENKINS_URL：Jenkins服务器的URL（例如。， https://jenkins.example.com)
  • JENKINS_USER：用于身份验证的Jenkins用户名
  • JENKINS_TOKEN：用于身份验证的Jenkins API令牌

获取您的Jenkins API代币

  1. 登录您的Jenkins服务器
  2. 点击右上角的用户名
  3. 单击“配置”（或转到用户→ 配置）
  4. 向下滚动至“API代币”部分
  5. 点击“添加新令牌”或“生成”
  6. 为其命名（例如，“mcp服务器”）
  7. 点击“生成” 立即复制令牌 （不会再显示）

用于游标IDE

编辑 ~/.cursor/mcp_config.json （如果它不存在，请创建它）：

{
  "mcpServers": {
    "jenkins-server": {
      "command": "node",
      "args": ["/path/to/jenkins-server-mcp/build/index.js"],
      "env": {
        "JENKINS_URL": "https://your-jenkins-server.com",
        "JENKINS_USER": "your-username",
        "JENKINS_TOKEN": "your-api-token"
      }
    }
  }
}

保存配置文件后，重新启动Cursor以使更改生效。

适用于克劳德桌面

MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jenkins-server": {
      "command": "node",
      "args": ["/path/to/jenkins-server-mcp/build/index.js"],
      "env": {
        "JENKINS_URL": "https://your-jenkins-server.com",
        "JENKINS_USER": "your-username",
        "JENKINS_TOKEN": "your-api-token"
      }
    }
  }
}

保存配置文件后，重新启动Claude Desktop以使更改生效。

工具和用法

配置后，您可以在AI助手中使用Jenkins工具：

1.获取构建状态

获取有关Jenkins构建的详细状态信息，包括构建号、状态、结果、时间等。

2.触发器构建

触发一个新的Jenkins构建。支持参数化和非参数化构建。

3.停止构建

停止当前正在运行的Jenkins构建。

4.列表构建

列出Jenkins作业的最新版本。

5.获取构建日志

检索Jenkins构建的控制台输出。

发展

建筑

npm run build

自动重建开发

npm run watch

调试

由于MCP服务器通过stdio进行通信，您可以使用MCP检查器进行调试：

npm run inspector

这将提供一个URL，用于访问浏览器中的调试工具。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP