Jenkins操作管理服务

Jenkins MCP是一个用于管理Jenkins操作的服务,支持自动处理CSRF保护、列出任务、触发构建和检查构建状态等功能。

  • by kjozsa
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 kjozsa/jenkins-mcp

使用说明

詹金斯MCP

用于管理Jenkins操作的MCP服务器。

安装

通过Smithery安装

通过以下方式自动安装Jenkins MCP for Claude Desktop 史密瑟里:

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"
      }
    }
  }
}

CSRF碎屑处理

Jenkins使用“面包屑”(必须包含在POST请求中的令牌)实现CSRF保护。此MCP服务器以两种方式处理CSRF面包屑:

  1. 默认模式:自动获取CSRF面包屑并将其包含在构建请求中

    • 使用会话Cookie来维护网络会话
    • 在幕后处理所有CSRF保护
  2. API令牌模式:使用不受CSRF保护的Jenkins API令牌

    • 集 JENKINS_USE_API_TOKEN=true
    • 集 JENKINS_PASSWORD 到API令牌而不是密码
    • 与Jenkins 2.96+一起使用,这不需要API令牌身份验证的碎屑

您可以在Jenkins中生成API令牌:User→ 配置→ API代币→ 添加新令牌

特性

  • 列出Jenkins工作
  • 使用可选参数构建触发器
  • 检查构建状态
  • 用于安全访问API的CSRF碎屑处理

发展

# Install dependencies
uv pip install -r requirements.txt

# Run in dev mode with Inspector
mcp dev jenkins_mcp/server.py