젠킨스 서버 MCP
Jenkins CI/CD 서버와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 어시스턴트는 표준화된 인터페이스를 통해 빌드 상태를 확인하고, 빌드를 트리거하고, 빌드 로그를 검색할 수 있습니다.
설치
이 저장소를 복제하세요:
지엑스피1
종속성 설치:
npm install프로젝트를 빌드하세요:
npm run buildRelated MCP server: MCP Toolkit
구성
서버에는 다음과 같은 환경 변수가 필요합니다.
JENKINS_URL: Jenkins 서버의 URL(기본값은 ' http://sohoci.rd.tp-link.net/jenkins ')JENKINS_USER: 인증을 위한 Jenkins 사용자 이름JENKINS_TOKEN: 인증을 위한 Jenkins API 토큰
MCP 설정 파일에서 다음을 구성하세요.
클로드 데스크탑용
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"jenkins-server": {
"command": "node",
"args": ["/path/to/jenkins-server-mcp/build/index.js"],
"env": {
"JENKINS_URL": "https://your-jenkins-server.com",
"JENKINS_USER": "your-username",
"JENKINS_TOKEN": "your-api-token"
}
}
}
}도구 및 사용법
1. 빌드 상태 가져오기
Jenkins 빌드 상태를 가져옵니다.
// Example usage
const result = await mcpClient.useTool("jenkins-server", "get_build_status", {
jobPath: "view/xxx_debug",
buildNumber: "lastBuild" // Optional, defaults to lastBuild
});입력 스키마:
{
"jobPath": "string", // Path to Jenkins job
"buildNumber": "string" // Optional, build number or "lastBuild"
}2. 트리거 빌드
매개변수를 사용하여 새로운 Jenkins 빌드를 트리거합니다.
// Example usage
const result = await mcpClient.useTool("jenkins-server", "trigger_build", {
jobPath: "view/xxx_debug",
parameters: {
BRANCH: "main",
BUILD_TYPE: "debug"
}
});입력 스키마:
{
"jobPath": "string", // Path to Jenkins job
"parameters": {
// Build parameters as key-value pairs
}
}3. 빌드 로그 가져오기
Jenkins 빌드의 콘솔 출력을 검색합니다.
// Example usage
const result = await mcpClient.useTool("jenkins-server", "get_build_log", {
jobPath: "view/xxx_debug",
buildNumber: "lastBuild"
});입력 스키마:
{
"jobPath": "string", // Path to Jenkins job
"buildNumber": "string" // Build number or "lastBuild"
}개발
자동 재빌드를 사용한 개발의 경우:
npm run watch디버깅
MCP 서버는 stdio를 통해 통신하므로 MCP Inspector를 사용하여 디버깅할 수 있습니다.
npm run inspector이렇게 하면 브라우저에서 디버깅 도구에 액세스할 수 있는 URL이 제공됩니다.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.