kud/mcp-jenkins

Jenkins MCP 서버 with bearer 토큰 인증 지원

웹 사이트 · 문서

특징

• 38 도구 - Jenkins API의 ~95% 커버 : 작업, 빌드, 노드, 전망, 큐, 플러그인 및 시스템 운영 -Bearer Token auth - 클래식 API 토큰과 현대 바이어 토큰 인증 지원
• **Multiple 인스턴스 ** - comma-separated env vars를 사용하여 여러 Jenkins 서버에 연결
• **Pipeline 인지도 ** - 단계별 파이프라인 상태, 콘솔 로그, 테스트 결과 및 artefacts 구축
• **Node 관리 ** - 목록 에이전트, toggle 노드 온라인/오프라인, 그리고 당신의 AI 클라이언트를 떠나지 않고 시스템 정보를 검사
• Zero-install use - npx --yes @kud/mcp-jenkins@latest 을 통해 직접 실행할 수 없는 로컬 설정

설치

또는 npx를 통해 설치하지 않고 사용 (아래 사용 참조).

사용법

MCP 클라이언트 구성에 서버를 추가합니다. 권장된 접근법은 환경 변수를 사용합니다:

Bearer 토큰 인증을 위해 env 블록을 다음과 같이 교체하십시오.

느린 인스턴스

각 요청이 서버는 1개의 마감일, 30 초에 의해 기본 설정됩니다. 큰 또는 바쁜 Jenkins는 더 긴 단일 통화에 응답 할 수 있습니다.

Features

• 38 tools — covers ~95% of the Jenkins API: jobs, builds, nodes, views, queue, plugins, and system operations
• Bearer token auth — supports both classic API token and modern bearer token authentication
• Multiple instances — connect to several Jenkins servers simultaneously using comma-separated env vars
• Pipeline awareness — retrieve stage-by-stage pipeline status, console logs, test results, and build artefacts
• Node management — list agents, toggle nodes online/offline, and inspect system info without leaving your AI client
• Zero-install usage — run directly via npx --yes @kud/mcp-jenkins@latest with no local setup required

Install

npm install -g @kud/mcp-jenkins

Or use without installing via npx (see Usage below).

Usage

Add the server to your MCP client config. The recommended approach uses environment variables:

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "https://pipeline.yourcompany.com",
        "MCP_JENKINS_USER": "your_username",
        "MCP_JENKINS_API_TOKEN": "your_api_token"
      }
    }
  }
}

For bearer token authentication, replace the env block with:

"env": {
  "MCP_JENKINS_URL": "https://pipeline.yourcompany.com",
  "MCP_JENKINS_BEARER_TOKEN": "your_bearer_token"
}

Slow instances

Every request this server makes is bounded by one deadline, 30 seconds by default. A large or busy Jenkins can spend even longer answering a single call. When that happens, the error you see (Jenkins request timed out) comes from this server giving up, not from Jenkins refusing anything.

Raise it with MCP_JENKINS_TIMEOUT_MS:

"env": {
  "MCP_JENKINS_URL": "https://pipeline.yourcompany.com",
  "MCP_JENKINS_BEARER_TOKEN": "your_bearer_token",
  "MCP_JENKINS_TIMEOUT_MS": "60000"
}

Or on the command line:

mcp-jenkins --url https://pipeline.yourcompany.com --bearer-token abc123 --timeout-ms 60000

One value applies to every configured instance. To find out what your instance actually needs, time the call the server makes:

time curl -u user:token 'https://pipeline.yourcompany.com/job/my-job/api/json'

Environment variables