# MCP ツールの仕様
<a name="mcp-tools-specification"></a>

分散負荷テストソリューションは、AI エージェントがテストシナリオと結果を操作できるようにする一連の MCP ツールを公開します。これらのツールは、AI エージェントが情報を処理する方法に沿った高レベルの抽象化された機能を提供し、詳細な API 契約ではなく分析とインサイトに集中できるようにします。

**注記**  
すべての MCP ツールは、ソリューションのデータへの読み取り専用アクセスを提供します。MCP インターフェイスを介してのテストシナリオや設定の変更はサポートされていません。

## list\$1scenarios
<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>

なし

### [Response] (レスポンス)
<a name="list-scenarios-tool-response"></a>


| 名前 | 説明 | 
| --- | --- | 
|   `testId`   |  テストシナリオの一意の識別子  | 
|   `testName`   |  テストシナリオの名前  | 
|   `status`   |  テストシナリオの現在のステータス  | 
|   `startTime`   |  テストがいつ作成されたか、または最後に実行されたか  | 
|   `testDescription`   |  テストシナリオの説明  | 

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

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

この `get_test_run` ツールは、リージョンとエンドポイントの内訳を含む 1 回のテスト実行の詳細な結果を取得します。

### エンドポイント
<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>

### 説明
<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\$1baseline\$1test\$1run
<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\$1test\$1run\$1artifacts
<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 機能をサポートするのに、基盤となる API を変更する必要はありません。