jenkins-mcp

基于 Node.js 的 jenkins MCP 服务，使用 stdio 作为传输层，暴露为 4 个 MCP tools:

• list_jobs 获取所有job列表，无输入，输出为name列表
• list_job_build 获取job的构建信息，输入两个参数name和limit，name为job名称, limit默认为5，输出build列表，build中包括number、revision、result、inProgress、timestamp
  • result：构建进行中时为 null，完成后为 "SUCCESS" / "FAILURE" / "ABORTED"
• start_job_build 启动构建，输入1个参数name，name为job名称，无输出
• stop_job_build 停止构建，输入2个参数name和number，name为job名称，number为构建号，无输出

环境变量

| 变量 | 说明 | |------|------| | JENKINS_URL | Jenkins 服务地址，如 http://jenkins.example.com:8080 | | JENKINS_USER | Jenkins 用户名 | | JENKINS_TOKEN | Jenkins API Token |

运行

# 安装依赖
npm install

# 构建
npm run build

# 启动服务
JENKINS_URL=http://your-jenkins JENKINS_USER=admin JENKINS_TOKEN=your-token npm start

安装

npm install npm run build

npm config set //registry.npmjs.org/:_authToken=npm_token npm publish --access public --loglevel verbose

Inspector 测试

JENKINS_URL=http://your-jenkins JENKINS_USER=admin JENKINS_TOKEN=your-token npm run inspect

启动后浏览器会自动打开 Inspector 界面，可以交互式测试各个 MCP tool。

Inspector CLI 测试

npm config set registry https://registry.npmjs.org/

npx -y -p @massapi/jenkins-mcp -p @modelcontextprotocol/inspector mcp-inspector --cli \
  -e JENKINS_URL=http://jenkins.example.com:8080 \
  -e JENKINS_USER=admin \
  -e JENKINS_TOKEN=your-api-token \
  jenkins-mcp \
  --method tools/call \
  --tool-name list_jobs

npx -y -p @massapi/jenkins-mcp -p @modelcontextprotocol/inspector mcp-inspector --cli \
  -e JENKINS_URL=http://jenkins.example.com:8080 \
  -e JENKINS_USER=admin \
  -e JENKINS_TOKEN=your-api-token \
  jenkins-mcp \
  --method tools/call \
  --tool-name list_job_build \
  --tool-arg name=prj0 \
  --tool-arg limit=3

npx -y -p @massapi/jenkins-mcp -p @modelcontextprotocol/inspector mcp-inspector --cli \
  -e JENKINS_URL=http://jenkins.example.com:8080 \
  -e JENKINS_USER=admin \
  -e JENKINS_TOKEN=your-api-token \
  jenkins-mcp \
  --method tools/call \
  --tool-name start_job_build \
  --tool-arg name=prj0

npx -y -p @massapi/jenkins-mcp -p @modelcontextprotocol/inspector mcp-inspector --cli \
  -e JENKINS_URL=http://jenkins.example.com:8080 \
  -e JENKINS_USER=admin \
  -e JENKINS_TOKEN=your-api-token \
  jenkins-mcp \
  --method tools/call \
  --tool-name stop_job_build \
  --tool-arg name=prj0 \
  --tool-arg number=510