Jenkins MCP Tool

Returns:
    List of server names

Important: For any deployment-related task, this function should be called first instead of directly using search_jobs.
This function returns a pre-configured scenario list, each containing the correct server and job path configuration.

Returns:
    List of scenarios, each containing:
        - index: Scenario index (string)
        - name: Scenario name
        - description: Scenario description
        - server: Jenkins server name
        - job_path: Job path

Workflow:
1. Call this function to get the scenario list
2. Let the user select a scenario
3. Use search_jobs_by_scenario(scenario) to get the specific job
4. Use trigger_build() to execute deployment

Args:
    scenario: Scenario name or index

Returns:
    List of job info matching the scenario

Note: For deployment tasks, it is recommended to use get_scenario_list() and search_jobs_by_scenario().

Args:
    server_name: Jenkins server name
    keyword: Search keyword

Returns:
    List of matching jobs

Args:
    server_name: Jenkins server name
    job_full_name: Full job name

Returns:
    List of parameter definitions, including parameter name, type, default value, and options (if choice parameter)

Automatically determines parameter requirements and waits to obtain build_number.

Args:
    server_name: Jenkins server name
    job_full_name: Full job name
    params: Optional parameter dict
    ctx: MCP context (for logging)

Returns:
    Dict containing build_number or queue_id

Raises:
    JenkinsParameterError: Missing required parameters
    JenkinsError: Trigger failed

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

Returns:
    Build status info

Intelligently handles permission errors and will automatically check build status to confirm if it has already been terminated.

Args:
    server_name: Jenkins server name
    job_full_name: Full job name
    build_number: Build number
    ctx: MCP context (for logging)

Returns:
    Stop result

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

Returns:
    Build log text

Returns:
    Validation result, including error list and status

Args:
    server_name: Jenkins server name
    job_name: Name for the job (create if not exists, update if exists)
    jenkinsfile_content: Content of the Jenkinsfile (pipeline script)
    description: Optional job description
    ctx: MCP context (for logging)

Returns:
    Dict containing job creation/update result with status and job_url

Raises:
    JenkinsError: Job creation/update failed