jenkins-server-mcp

Jenkins MCP 服务器 — 让 AI 编程助手直接操作 Jenkins CI/CD 流水线。

安装

npm install -g jenkins-server-mcp

或通过 npx 直接使用：

npx -y jenkins-server-mcp

前置条件

在 Jenkins 上生成 API Token：

1. 登录 Jenkins → 右上角用户名 → Configure（设置）
2. 找到 API Token → Add new Token → 生成并复制

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | JENKINS_URL | 是 | Jenkins 地址，如 http://jenkins.sx1211.cn | | JENKINS_USER | 是 | Jenkins 用户名 | | JENKINS_API_TOKEN | 是 | Jenkins API Token |

也兼容 MCP_JENKINS_URL / MCP_JENKINS_USER / MCP_JENKINS_API_TOKEN。

配置

Cursor

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["-y", "jenkins-server-mcp"],
      "env": {
        "JENKINS_URL": "http://jenkins.sx1211.cn",
        "JENKINS_USER": "你的用户名",
        "JENKINS_API_TOKEN": "你的API Token"
      }
    }
  }
}

Claude Code

claude mcp add --transport stdio --scope user jenkins \
  --env JENKINS_URL=http://jenkins.sx1211.cn \
  --env JENKINS_USER=你的用户名 \
  --env JENKINS_API_TOKEN=你的Token \
  -- npx -y jenkins-server-mcp

可用工具

| 工具 | 说明 | |------|------| | jenkins_get_server_info | 获取 Jenkins 服务器信息 | | jenkins_list_jobs | 列出任务（支持文件夹层级） | | jenkins_get_job | 获取任务详情 | | jenkins_list_builds | 列出最近构建 | | jenkins_get_build | 获取单次构建详情 | | jenkins_get_build_log | 获取构建控制台日志 | | jenkins_trigger_build | 触发构建（支持参数） | | jenkins_stop_build | 停止运行中的构建 | | jenkins_get_queue | 查看构建队列 | | jenkins_cancel_queue_item | 取消队列任务 | | jenkins_list_nodes | 列出 Jenkins 节点 | | jenkins_search_jobs | 按关键词搜索任务 |

任务路径说明

jobPath 使用 / 分隔文件夹层级，例如：

• 根目录任务：web/home
• 中文任务名：云朵用户线索数据推送系统
• 嵌套文件夹：folder/subfolder/jobname

本地开发

cd jenkins-server-mcp
npm install
JENKINS_URL=http://jenkins.sx1211.cn JENKINS_USER=xxx JENKINS_API_TOKEN=xxx node index.js

测试

npm test

License

MIT