Jenkins MCP Server

Instructions

Implementation Reference

• src/tools/job-info.js:15-31 (handler)

  The handler function that implements the core logic for the 'getJob' tool. It retrieves information about a specific Jenkins job by making an API call to `/job/{jobPath}/api/json`.

  export async function getJob(client, args) {
  	const { jobFullName } = args;
  	if (!jobFullName) return failure("getJob", "jobFullName is required");
  	const jobPath = encodeJobPath(jobFullName);
  
  	try {
  		const response = await client.get(`/job/${jobPath}/api/json`);
  		if (response.status === 200) {
  			return success("getJob", { job: response.data });
  		}
  		return failure("getJob", `Job not found: ${jobFullName}`, {
  			statusCode: response.status,
  		});
  	} catch (error) {
  		return formatError(error, "getJob");
  	}
  }

• src/tools/index.js:133-147 (registration)

  The registration entry for the 'getJob' tool in the central tool registry, including name, description, input schema, and reference to the handler function.

  getJob: {
  	name: "getJob",
  	description: "Get information about a Jenkins job",
  	inputSchema: {
  		type: "object",
  		properties: {
  			jobFullName: {
  				type: "string",
  				description: "Full path of the Jenkins job",
  			},
  		},
  		required: ["jobFullName"],
  	},
  	handler: getJob,
  },

• src/tools/index.js:136-145 (schema)

  The input schema definition for the 'getJob' tool, specifying the required 'jobFullName' parameter.

  inputSchema: {
  	type: "object",
  	properties: {
  		jobFullName: {
  			type: "string",
  			description: "Full path of the Jenkins job",
  		},
  	},
  	required: ["jobFullName"],
  },