MCP 工具规格 - AWS 上的分布式负载测试
列出场景获取场景详情列出测试运行次数get_test_runget_latest_test_runget_baseline_test_run获取_测试_运行_工件

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

MCP 工具规格

分布式负载测试解决方案公开了一组 MCP 工具，这些工具使 AI 代理能够与测试场景和结果进行交互。这些工具提供了与 AI 代理处理信息的方式一致的高级抽象功能，使他们能够专注于分析和见解，而不是详细的 API 合同。

注意

所有 MCP 工具都提供对解决方案数据的只读访问权限。不支持通过 MCP 接口修改测试场景或配置。

列出场景

描述

该list_scenarios工具检索包含基本元数据的所有可用测试场景的列表。

终端节点

GET /scenarios

Parameters

无

响应

Name 描述

testId

测试场景的唯一标识符

testName

测试场景的名称

status

测试场景的当前状态

startTime

测试的创建时间或上次运行的时间

testDescription

测试场景的描述

获取场景详情

描述

该get_scenario_details工具检索单个测试场景的测试配置和最近的测试运行。

终端节点

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

请求参数

test_id

  • 测试场景的唯一标识符

    类型：字符串

    必需：是

响应

Name 描述

testTaskConfigs

每个区域的任务配置

testScenario

测试定义和参数

status

当前测试状态

startTime

测试开始时间戳

endTime

测试结束时间戳（如果已完成）

列出测试运行次数

描述

该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 时间戳

    类型：字符串（日期时间格式）

    必需：否

响应

Name 描述

testRuns

包含每次运行的性能指标和百分位数的测试运行摘要数组

get_test_run

描述

该get_test_run工具检索单次测试的详细结果，包括区域和端点细分。

终端节点

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

请求参数

test_id

  • 测试场景的唯一标识符

    类型：字符串

    必需：是

test_run_id

  • 特定测试运行的唯一标识符

    类型：字符串

    必需：是

响应

Name 描述

results

完整的测试运行数据，包括区域结果明细、端点特定指标、性能百分位数（p50、p90、p95、p99）、成功和失败计数、响应时间和延迟，以及用于运行的测试配置

get_latest_test_run

描述

该get_latest_test_run工具检索特定测试场景的最新测试运行。

终端节点

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

注意

使用全局二级索引 (GSI) 按时间对结果进行排序，确保返回最新的测试运行。

请求参数

test_id

  • 测试场景的唯一标识符

    类型：字符串

    必需：是

响应

Name 描述

results

最新测试运行数据，其格式与相同 get_test_run

get_baseline_test_run

描述

该get_baseline_test_run工具检索特定测试场景的基准测试运行。该基准用于性能比较目的。

终端节点

GET /scenarios/<test_id>/baseline

请求参数

test_id

  • 测试场景的唯一标识符

    类型：字符串

    必需：是

响应

Name 描述

baselineData

用于比较目的的基准测试运行数据，包括指定基准运行的所有指标和配置

获取_测试_运行_工件

描述

该get_test_run_artifacts工具检索 Amazon S3 存储桶信息，用于访问测试项目，包括日志、错误文件和结果。

终端节点

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

请求参数

test_id

  • 测试场景的唯一标识符

    类型：字符串

    必需：是

test_run_id

  • 特定测试运行的唯一标识符

    类型：字符串

    必需：是

响应

Name 描述

bucketName

存储工件的 S3 存储桶名称

testRunPath

当前工件存储的路径前缀（版本 4.0+）

testScenarioPath

旧版工件存储的路径前缀（4.0 版之前）
注意

所有 MCP 工具都利用现有的 API 端点。无需对底层 APIs 进行修改即可支持 MCP 功能。