Jenkins MCP Tool

Instructions

Args:
    server_name: Jenkins server name
    job_full_name: Full job name
    build_number: Build number

Returns:
    Build log text

Implementation Reference

• src/jenkins/tools/mcp_tools.py:235-249 (handler)

  MCP tool handler and registration for 'get_build_log'. Creates JenkinsAPIClient instance and calls its get_build_log method to retrieve the build console log.

  @mcp.tool()
  def get_build_log(server_name: str, job_full_name: str, build_number: int) -> str:
      """Get Jenkins build log.
  
      Args:
          server_name: Jenkins server name
          job_full_name: Full job name
          build_number: Build number
  
      Returns:
          Build log text
      """
      client = JenkinsAPIClient(server_name)
      return client.get_build_log(job_full_name, build_number)

• src/jenkins/tools/client.py:474-499 (helper)

  Core implementation of get_build_log in JenkinsAPIClient. Fetches the build console log text from the Jenkins API endpoint /{build_number}/consoleText, handling 404 errors by raising JenkinsBuildNotFoundError.

  def get_build_log(self, job_full_name: str, build_number: int) -> str:
      """Get build log.
  
      Args:
          job_full_name: Full job name
          build_number: Build number
  
      Returns:
          Build log text
  
      Raises:
          JenkinsBuildNotFoundError: Build not found
          JenkinsError: API request failed
      """
      job_url = self._build_job_url(job_full_name)
      log_url = f"{job_url}/{build_number}/consoleText"
  
      response = self._make_request("GET", log_url)
  
      if response.status_code == 404:
          raise JenkinsBuildNotFoundError(
              build_number, job_full_name, self.server_name
          )
  
      response.raise_for_status()
      return response.text