Jenkins MCP

Jenkins MCP

site icon
2025.04.07 7
PythonJenkins 管理CI/CD 自动化开发效率
Jenkins MCP 是一个用于管理 Jenkins 操作的服务。它提供了与 Jenkins 交互的功能,包括列出 Jenkins 任务、触发构建、检查构建状态以及处理 CSRF 保护机制。
View on GitHub

Overview

基本能力

产品定位

Jenkins MCP 是一个专门用于管理和操作 Jenkins 服务的 MCP 服务器。

核心功能

  • 列出 Jenkins 任务
  • 触发带有可选参数的构建
  • 检查构建状态
  • 处理 CSRF crumb 以确保安全的 API 访问

适用场景

  • 自动化 Jenkins 任务管理
  • 集成 Jenkins 到其他自动化流程中
  • 安全地与 Jenkins API 交互

工具列表

  • uvx: 用于安装和运行 Jenkins MCP
  • mcp dev: 用于开发模式运行服务

常见问题解答

  • CSRF Crumb 处理: Jenkins MCP 提供了两种处理 CSRF 保护的方式:默认模式和 API 令牌模式。
  • 默认模式自动获取并包含 CSRF crumbs
  • API 令牌模式使用 Jenkins API 令牌,不受 CSRF 保护限制

使用教程

使用依赖

无特别说明的前置依赖。

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @kjozsa/jenkins-mcp --client claude

手动安装

uvx install jenkins-mcp

配置

添加以下 JSON 配置片段以配置 MCP 服务器:

{
  "mcpServers": {
    "jenkins-mcp": {
      "command": "uvx",
      "args": ["jenkins-mcp"],
      "env": {
        "JENKINS_URL": "https://your-jenkins-server/",
        "JENKINS_USERNAME": "your-username",
        "JENKINS_PASSWORD": "your-password",
        "JENKINS_USE_API_TOKEN": "false"
      }
    }
  }
}

调试方式

开发模式运行

# 安装依赖
uv pip install -r requirements.txt

# 在开发模式下运行
mcp dev jenkins_mcp/server.py

许可证

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