Jenkins Server MCP

Instructions

Implementation Reference

• src/index.ts:150-170 (handler)

  The handler function that executes the get_build_status tool: fetches build status from Jenkins API using axios and returns formatted JSON content.

  private async getBuildStatus(args: any) {
    const buildNumber = args.buildNumber || 'lastBuild';
    const response = await this.axiosInstance.get<BuildStatus>(
      `/${args.jobPath}/${buildNumber}/api/json`
    );
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({
            building: response.data.building,
            result: response.data.result,
            timestamp: response.data.timestamp,
            duration: response.data.duration,
            url: response.data.url,
          }, null, 2),
        },
      ],
    };
  }

• src/index.ts:62-79 (registration)

  Tool registration in the ListTools handler, defining name, description, and input schema.

  {
    name: 'get_build_status',
    description: 'Get the status of a Jenkins build',
    inputSchema: {
      type: 'object',
      properties: {
        jobPath: {
          type: 'string',
          description: 'Path to the Jenkins job (e.g., "view/xxx_debug")',
        },
        buildNumber: {
          type: 'string',
          description: 'Build number (use "lastBuild" for most recent)',
        },
      },
      required: ['jobPath'],
    },
  },

• src/index.ts:16-22 (schema)

  TypeScript interface defining the structure of the Jenkins build status response used in the handler.

  interface BuildStatus {
    building: boolean;
    result: string | null;
    timestamp: number;
    duration: number;
    url: string;
  }