기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# MCP 도구 사양
<a name="mcp-tools-specification"></a>

분산 로드 테스트 솔루션은 AI 에이전트가 테스트 시나리오 및 결과와 상호 작용할 수 있는 일련의 MCP 도구를 제공합니다. 이러한 도구는 AI 에이전트가 정보를 처리하는 방식에 맞는 상위 수준의 추상화된 기능을 제공하므로 세부 API 계약이 아닌 분석 및 인사이트에 집중할 수 있습니다.

**참고**  
모든 MCP 도구는 솔루션 데이터에 대한 읽기 전용 액세스를 제공합니다. MCP 인터페이스를 통해 테스트 시나리오 또는 구성을 수정할 수 없습니다.

## list\_scenarios
<a name="list-scenarios-tool"></a>

### 설명
<a name="list-scenarios-tool-description"></a>

이 `list_scenarios` 도구는 기본 메타데이터를 사용하여 사용 가능한 모든 테스트 시나리오 목록을 검색합니다.

### 엔드포인트
<a name="list-scenarios-tool-endpoint"></a>

 `GET /scenarios` 

### 파라미터
<a name="list-scenarios-tool-parameters"></a>

없음

### 응답
<a name="list-scenarios-tool-response"></a>


| 이름 | 설명 | 
| --- | --- | 
|  `testId`  | 테스트 시나리오의 고유 식별자 | 
|  `testName`  | 테스트 시나리오의 이름 | 
|  `status`  | 테스트 시나리오의 현재 상태 | 
|  `startTime`  | 테스트가 생성되거나 마지막으로 실행된 시간 | 
|  `testDescription`  | 테스트 시나리오에 대한 설명 | 

## get\_scenario\_details
<a name="get-scenario-details-tool"></a>

### 설명
<a name="get-scenario-details-tool-description"></a>

`get_scenario_details` 도구는 단일 테스트 시나리오에 대한 테스트 구성과 최신 테스트 실행을 검색합니다.

### 엔드포인트
<a name="get-scenario-details-tool-endpoint"></a>

 `GET /scenarios/<test_id>?history=false&results=false` 

### 요청 파라미터
<a name="get-scenario-details-tool-request"></a>

 `test_id`   
+ 테스트 시나리오의 고유 식별자

  유형: 문자열

  필수 항목 여부: 예

### 응답
<a name="get-scenario-details-tool-response"></a>


| 이름 | 설명 | 
| --- | --- | 
|  `testTaskConfigs`  | 각 리전에 대한 작업 구성 | 
|  `testScenario`  | 테스트 정의 및 파라미터 | 
|  `status`  | 현재 테스트 상태 | 
|  `startTime`  | 테스트 시작 타임스탬프 | 
|  `endTime`  | 테스트 종료 타임스탬프(완료된 경우) | 

## list\_test\_runs
<a name="list-test-runs-tool"></a>

### 설명
<a name="list-test-runs-tool-description"></a>

이 `list_test_runs` 도구는 최신에서 오래된 것으로 정렬된 특정 테스트 시나리오에 대한 테스트 실행 목록을 검색합니다. 최대 30개의 결과를 반환합니다.

### 엔드포인트
<a name="list-test-runs-tool-endpoint"></a>

 `GET /scenarios/<testid>/testruns/?limit=<limit>` 

또는

 `GET /scenarios/<testid>/testruns/?limit=30&start_date=<start_date>&end_date=<end_date>` 

### 요청 파라미터
<a name="list-test-runs-tool-request"></a>

 `test_id`   
+ 테스트 시나리오의 고유 식별자

  유형: 문자열

  필수 항목 여부: 예

 `limit`   
+ 반환할 최대 테스트 실행 수

  유형: 정수

  기본값: 20

  최대: 30

  필수 여부: 아니요

 `start_date`   
+ 특정 날짜부터 실행을 필터링하는 ISO 8601 타임스탬프

  유형: 문자열(날짜-시간 형식)

  필수 여부: 아니요

 `end_date`   
+ 특정 날짜까지 실행을 필터링하는 ISO 8601 타임스탬프

  유형: 문자열(날짜-시간 형식)

  필수 여부: 아니요

### 응답
<a name="list-test-runs-tool-response"></a>


| 이름 | 설명 | 
| --- | --- | 
|  `testRuns`  | 각 실행에 대한 성능 지표 및 백분위수가 포함된 테스트 실행 요약 배열 | 

## get\_test\_run
<a name="get-test-run-tool"></a>

### 설명
<a name="get-test-run-tool-description"></a>

이 `get_test_run` 도구는 리전 및 엔드포인트 분석을 통해 단일 테스트 실행에 대한 자세한 결과를 검색합니다.

### 엔드포인트
<a name="get-test-run-tool-endpoint"></a>

 `GET /scenarios/<testid>/testruns/<testrunid>` 

### 요청 파라미터
<a name="get-test-run-tool-request"></a>

 `test_id`   
+ 테스트 시나리오의 고유 식별자

  유형: 문자열

  필수 항목 여부: 예

 `test_run_id`   
+ 특정 테스트 실행의 고유 식별자

  유형: 문자열

  필수 항목 여부: 예

### 응답
<a name="get-test-run-tool-response"></a>


| 이름 | 설명 | 
| --- | --- | 
|  `results`  | 리전별 결과 분석, 엔드포인트별 지표, 성능 백분위수(p50, p90, p95, p99), 성공 및 실패 수, 응답 시간 및 지연 시간, 실행에 사용되는 테스트 구성을 포함한 전체 테스트 실행 데이터 | 

## get\_latest\_test\_run
<a name="get-latest-test-run-tool"></a>

### 설명
<a name="get-latest-test-run-tool-description"></a>

`get_latest_test_run` 도구는 특정 테스트 시나리오에 대한 최신 테스트 실행을 검색합니다.

### 엔드포인트
<a name="get-latest-test-run-tool-endpoint"></a>

 `GET /scenarios/<testid>/testruns/?limit=1` 

**참고**  
결과는 글로벌 보조 인덱스(GSI)를 사용하여 시간별로 정렬되므로 가장 최근의 테스트 실행이 반환됩니다.

### 요청 파라미터
<a name="get-latest-test-run-tool-request"></a>

 `test_id`   
+ 테스트 시나리오의 고유 식별자

  유형: 문자열

  필수 항목 여부: 예

### 응답
<a name="get-latest-test-run-tool-response"></a>


| 이름 | 설명 | 
| --- | --- | 
|  `results`  | 와 동일한 형식의 최신 테스트 실행 데이터 `get_test_run`  | 

## get\_baseline\_test\_run
<a name="get-baseline-test-run-tool"></a>

### 설명
<a name="get-baseline-test-run-tool-description"></a>

`get_baseline_test_run` 도구는 특정 테스트 시나리오에 대한 기준 테스트 실행을 검색합니다. 기준은 성능 비교 목적으로 사용됩니다.

### 엔드포인트
<a name="get-baseline-test-run-tool-endpoint"></a>

 `GET /scenarios/<test_id>/baseline` 

### 요청 파라미터
<a name="get-baseline-test-run-tool-request"></a>

 `test_id`   
+ 테스트 시나리오의 고유 식별자

  유형: 문자열

  필수 항목 여부: 예

### 응답
<a name="get-baseline-test-run-tool-response"></a>


| 이름 | 설명 | 
| --- | --- | 
|  `baselineData`  | 지정된 기준 실행의 모든 지표 및 구성을 포함하여 비교를 위한 기준 테스트 실행 데이터 | 

## get\_test\_run\_artifacts
<a name="get-test-run-artifacts-tool"></a>

### 설명
<a name="get-test-run-artifacts-tool-description"></a>

`get_test_run_artifacts` 도구는 로그, 오류 파일 및 결과를 포함한 테스트 아티팩트에 액세스하기 위한 Amazon S3 버킷 정보를 검색합니다.

### 엔드포인트
<a name="get-test-run-artifacts-tool-endpoint"></a>

 `GET /scenarios/<testid>/testruns/<testrunid>` 

### 요청 파라미터
<a name="get-test-run-artifacts-tool-request"></a>

 `test_id`   
+ 테스트 시나리오의 고유 식별자

  유형: 문자열

  필수 항목 여부: 예

 `test_run_id`   
+ 특정 테스트 실행의 고유 식별자

  유형: 문자열

  필수 항목 여부: 예

### 응답
<a name="get-test-run-artifacts-tool-response"></a>


| 이름 | 설명 | 
| --- | --- | 
|  `bucketName`  | 아티팩트가 저장되는 S3 버킷 이름 | 
|  `testRunPath`  | 현재 아티팩트 스토리지의 경로 접두사(버전 4.0 이상) | 
|  `testScenarioPath`  | 레거시 아티팩트 스토리지의 경로 접두사(버전 4.0 이전) | 

**참고**  
모든 MCP 도구는 기존 API 엔드포인트를 활용합니다. MCP 기능을 지원하기 위해 기본 APIs를 수정할 필요가 없습니다.