Jenkins MCP

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

<a href="https://glama.ai/mcp/servers/7j3zk84u5p"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=1527443531,2110480253&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Jenkins MCP 服务器" /> </a>

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Jenkins MCP 到 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 Cookie 处理

Jenkins 使用“crumbs”（小块）实现 CSRF 保护——这些是必须包含在 POST 请求中的令牌。此 MCP 服务器以两种方式处理 CSRF 小块：

1. 默认模式：自动获取并包含构建请求中的 CSRF 小块

   • 使用会话 cookie 维护 Web 会话
   • 在后台处理所有 CSRF 保护

2. API Token 模式：使用 Jenkins API 令牌，这些令牌免受 CSRF 保护

   • 设置 JENKINS_USE_API_TOKEN=true
   • 将 JENKINS_PASSWORD 设置为您的 API 令牌而不是密码
   • 适用于 Jenkins 2.96+ 版本，该版本不需要 crumbs 进行 API 令牌认证

您可以在 Jenkins 中生成 API 令牌：用户 → 配置 → API 令牌 → 添加新令牌

功能

• 列出 Jenkins 作业
• 触发带有可选参数的构建
• 检查构建状态
• 为安全 API 访问处理 CSRF 小块

开发

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

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