MCP ツールの仕様 - AWS での分散負荷テストソリューション
list_scenariosget_scenario_detailslist_test_runsget_test_runget_latest_test_runget_baseline_test_runget_test_run_artifacts

MCP ツールの仕様

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

注記

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

list_scenarios

説明

この list_scenarios ツールは、基本的なメタデータを使用して、使用可能なすべてのテストシナリオのリストを取得します。

エンドポイント

GET /scenarios

パラメータ

なし

[Response] (レスポンス)

名前 説明

testId

テストシナリオの一意の識別子

testName

テストシナリオの名前

status

テストシナリオの現在のステータス

startTime

テストがいつ作成されたか、または最後に実行されたか

testDescription

テストシナリオの説明

get_scenario_details

説明

この get_scenario_details ツールは、単一のテストシナリオのテスト設定と最新のテスト実行を取得します。

エンドポイント

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

リクエストパラメータ

test_id

  • テストシナリオの一意の識別子

    タイプ: 文字列

    必須: はい

応答

名前 説明

testTaskConfigs

各リージョンのタスク設定

testScenario

テスト定義とパラメータ

status

現在のテストステータス

startTime

テストの開始タイムスタンプ

endTime

テストの終了タイムスタンプ (完了した場合)

list_test_runs

説明

この list_test_runs ツールは、特定のテストシナリオのテスト実行のリストを取得し、最新のものから古い順にソートします。最大 30 件の結果を返します。

エンドポイント

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

または

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

パラメータのリクエスト

test_id

  • テストシナリオの一意の識別子

    タイプ: 文字列

    必須: はい

limit

  • 返されるテスト実行の最大数

    タイプ: 整数

    デフォルト: 20

    最大: 30

    必須: いいえ

start_date

  • 特定の日付から実行をフィルタリングする ISO 8601 タイムスタンプ

    タイプ: 文字列 (日時形式)

    必須: いいえ

end_date

  • 特定の日付まで実行をフィルタリングする ISO 8601 タイムスタンプ

    タイプ: 文字列 (日時形式)

    必須: いいえ

応答

名前 説明

testRuns

各実行のパフォーマンスメトリクスとパーセンタイルを含むテスト実行の概要の配列

get_test_run

説明

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

エンドポイント

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

パラメータのリクエスト

test_id

  • テストシナリオの一意の識別子

    タイプ: 文字列

    必須: はい

test_run_id

  • 特定のテスト実行の一意の識別子

    タイプ: 文字列

    必須: はい

応答

名前 説明

results

リージョンの結果の内訳、エンドポイント固有のメトリクス、パフォーマンスパーセンタイル (p50、p90、p95、p99)、成功と失敗の数、応答時間とレイテンシー、実行に使用されるテスト設定を含む完全なテスト実行データ

get_latest_test_run

説明

get_latest_test_run ツールは、特定のテストシナリオの最新のテスト実行を取得します。

エンドポイント

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

注記

結果はグローバルセカンダリインデックス (GSI) を使用して時間別にソートされ、最新のテスト実行が返されます。

リクエストパラメータ

test_id

  • テストシナリオの一意の識別子

    タイプ: 文字列

    必須: はい

応答

名前 説明

results

get_test_run と同じ形式の最新のテスト実行データ

get_baseline_test_run

説明

get_baseline_test_run ツールは、特定のテストシナリオのベースラインテスト実行を取得します。ベースラインはパフォーマンスを比較する目的で使用されます。

エンドポイント

GET /scenarios/<test_id>/baseline

リクエストパラメータ

test_id

  • テストシナリオの一意の識別子

    タイプ: 文字列

    必須: はい

応答

名前 説明

baselineData

指定されたベースライン実行のすべてのメトリクスと設定を含む、比較目的のベースラインテスト実行データ

get_test_run_artifacts

説明

get_test_run_artifacts ツールは、ログ、エラーファイル、結果などのテストアーティファクトにアクセスするための Amazon S3 バケット情報を取得します。

エンドポイント

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

パラメータのリクエスト

test_id

  • テストシナリオの一意の識別子

    タイプ: 文字列

    必須: はい

test_run_id

  • 特定のテスト実行の一意の識別子

    タイプ: 文字列

    必須: はい

応答

名前 説明

bucketName

アーティファクトが保存されている S3 バケット名

testRunPath

現在のアーティファクトストレージのパスプレフィックス (バージョン 4.0 以上)

testScenarioPath

レガシーアーティファクトストレージのパスプレフィックス (バージョン 4.0 より前)
注記

すべての MCP ツールは、既存の API エンドポイントを活用します。MCP 機能をサポートするのに、基盤となる API を変更する必要はありません。