mcp-load-test · packages

Provides breaking point detection and performance grading for MCP load test reports. Exports `BreakingPointDetector` (a class that monitors error rates and latency against configurable thresholds during a test, tracking when the server degrades and recovers) and `Grader` (a class that assigns A–F letter grades for latency, concurrency, and error rate, and generates actionable recommendations). Designed to consume `LoadTestReport` objects from `@reaatech/mcp-load-test-core`.

A CLI that runs load, ramp, soak, and spike tests against MCP servers, outputting results to the console, Markdown, or JSON. Built on Commander.js, it accepts YAML or JSON config files and supports auto-detection of stdio, SSE, or HTTP transport.

A session-scoped MCP transport client that auto-negotiates across stdio, SSE, and StreamableHTTP, providing `connect()`, `disconnect()`, `callTool()`, and `listTools()` methods for concurrent load-test sessions.

Shared TypeScript types, Zod schemas, utility functions (percentile calculation, retry with backoff, URL validation), and a pre-configured Pino logger that serve as the single source of truth for all domain shapes in the `@reaatech/mcp-load-test-*` ecosystem.

A `LoadEngine` class that orchestrates MCP server load tests by managing a dynamic session pool, executing weighted-random tool call patterns, and producing a `LoadTestReport` with metrics, breaking point detection, and an auto-generated grade.

A latency histogram, throughput collector, and error tracker for MCP load testing, exposed as a `MetricsCollector` class that records per-tool percentile distributions, rolling-window error rates, and peak RPS from raw request records.

A pattern execution engine and three built-in tool-call sequences (`EXPLORE_THEN_ACT`, `READ_THEN_WRITE`, `MULTI_STEP_WORKFLOW`) for load testing MCP servers, provided as a `PatternExecutor` class that resolves template variables, applies configurable think-time delays, and categorizes errors.

Async generator functions that yield `{ concurrency, phase }` tuples at 1-second intervals for four load-testing profiles (ramp, soak, spike, and custom curve), designed to drive an MCP load-test engine's session pool.

Console, markdown, and JSON output formatters for MCP load test reports. Each reporter is a class with a `format(report: LoadTestReport): string` method, producing either ANSI-colored terminal output, GitHub-flavored markdown, or pretty-printed JSON.