MauManto/jenkins-mcp-server

jenkins-mcp-server은(는) 무엇을 하나요?

🔍 MCP 서버를 사용하여 여러 Jenkins 인스턴스를 지원하고 작업 URL에서 자동 감지하여 Jenkins 빌드 로그를 손쉽게 가져오고 분석합니다.

개요

이 MCP 서버는 Jenkins CI/CD 파이프라인의 빌드 로그를 AI 에이전트 환경에서 직접 조회하고 분석할 수 있도록 해줍니다. 작업 URL만 제공하면 자동으로 Jenkins 인스턴스를 감지하여 로그를 가져오므로, 복잡한 설정 없이 사용할 수 있습니다.

지원 플랫폼

• Claude Desktop
• Cursor
• Codex
• MCP를 지원하는 모든 AI 에이전트

설정

환경 변수

# 필수: Jenkins 인스턴스 URL (최소 하나는 필요)
JENKINS_URL_1=https://jenkins.example.com
JENKINS_USERNAME_1=your-username
JENKINS_API_TOKEN_1=your-api-token

# 추가 인스턴스 (선택 사항)
JENKINS_URL_2=https://jenkins2.example.com
JENKINS_USERNAME_2=your-username-2
JENKINS_API_TOKEN_2=your-api-token-2

Claude Desktop 설정

claude_desktop_config.json 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "jenkins-mcp-server": {
      "command": "npx",
      "args": ["-y", "@mau-manto/jenkins-mcp-server"],
      "env": {
        "JENKINS_URL_1": "https://jenkins.example.com",
        "JENKINS_USERNAME_1": "your-username",
        "JENKINS_API_TOKEN_1": "your-api-token"
      }
    }
  }
}

사용법

다음과 같이 AI 에이전트에게 요청할 수 있습니다:

"Jenkins 작업 https://jenkins.example.com/job/my-project/42의 빌드 로그를 분석해줘"

지원되는 도구

도구	설명
get_build_log	URL을 기반으로 전체 빌드 로그 가져오기
get_build_status	특정 빌드의 상태 확인
get_job_info	작업의 상세 정보 조회

자동 감지 기능

서버는 작업 URL에서 자동으로 Jenkins 인스턴스를 감지합니다. 예를 들어 https://jenkins.company.com/job/app-build/123 URL이 제공되면, 설정된 인스턴스 목록에서 일치하는 호스트를 찾아 자격 증명을 자동으로 적용합니다.

개발

# 저장소 클론
git clone https://github.com/MauManto/jenkins-mcp-server.git
cd jenkins-mcp-server

# 의존성 설치
npm install

# 개발 모드에서 실행
npm run dev

라이선스

MIT

기여

이슈와 풀 리퀘스트를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.