本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# MCP 工具規格
<a name="mcp-tools-specification"></a>

分散式負載測試解決方案公開了一組 MCP 工具，可讓 AI 代理器與測試案例和結果互動。這些工具提供高階的抽象功能，符合 AI 代理器處理資訊的方式，讓他們專注於分析和洞見，而不是詳細的 API 合約。

**注意**  
所有 MCP 工具都提供對解決方案資料的唯讀存取。不支援透過 MCP 介面修改測試案例或組態。

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

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

此`list_scenarios`工具會擷取所有可用測試案例的清單，其中包含基本中繼資料。

### Endpoint
<a name="list-scenarios-tool-endpoint"></a>

 `GET /scenarios` 

### Parameters
<a name="list-scenarios-tool-parameters"></a>

無

### 回應
<a name="list-scenarios-tool-response"></a>


| 名稱 | 描述 | 
| --- | --- | 
|   `testId`   |  測試案例的唯一識別符  | 
|   `testName`   |  測試案例的名稱  | 
|   `status`   |  測試案例的目前狀態  | 
|   `startTime`   |  測試建立或上次執行的時間  | 
|   `testDescription`   |  測試案例的描述  | 

## get\$1scenario\$1details
<a name="get-scenario-details-tool"></a>

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

此`get_scenario_details`工具會擷取單一測試案例的測試組態和最新的測試執行。

### Endpoint
<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\$1test\$1runs
<a name="list-test-runs-tool"></a>

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

此`list_test_runs`工具會擷取特定測試案例的測試執行清單，將最新到最舊排序。傳回最多 30 個結果。

### Endpoint
<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\$1test\$1run
<a name="get-test-run-tool"></a>

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

此`get_test_run`工具會擷取具有區域和端點明細的單一測試執行的詳細結果。

### Endpoint
<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\$1latest\$1test\$1run
<a name="get-latest-test-run-tool"></a>

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

此`get_latest_test_run`工具會擷取特定測試案例的最新測試執行。

### Endpoint
<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\$1baseline\$1test\$1run
<a name="get-baseline-test-run-tool"></a>

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

此`get_baseline_test_run`工具會擷取特定測試案例的基準測試執行。基準用於效能比較目的。

### Endpoint
<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\$1test\$1run\$1artifacts
<a name="get-test-run-artifacts-tool"></a>

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

此`get_test_run_artifacts`工具會擷取 Amazon S3 儲存貯體資訊，以存取測試成品，包括日誌、錯誤檔案和結果。

### Endpoint
<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 端點。不需要修改基礎 APIs即可支援 MCP 功能。