get_build_log
Retrieve build logs from Jenkins servers to analyze job execution details, troubleshoot failures, and monitor CI/CD pipeline performance.
Instructions
Get Jenkins build log.
Args:
server_name: Jenkins server name
job_full_name: Full job name
build_number: Build number
Returns:
Build log textInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| server_name | Yes | ||
| job_full_name | Yes | ||
| build_number | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
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