mcp-load-test · packages

Analyzes Model Context Protocol (MCP) load test metrics to detect performance breaking points and assign letter grades based on latency, error rates, and recovery times. It provides `BreakingPointDetector` and `Grader` classes that consume `LoadTestReport` objects to generate performance summaries and remediation recommendations.

Executes load, ramp, soak, and spike tests against Model Context Protocol (MCP) servers via a command-line interface. It generates performance reports in console, JSON, or Markdown formats and supports baseline comparisons for regression testing.

Provides a unified client interface for Model Context Protocol (MCP) servers that automatically negotiates between stdio, SSE, and StreamableHTTP transports. It returns a session-managed client instance that handles JSON-RPC handshakes, authentication, and tool discovery for concurrent load testing.

Provides shared TypeScript types, Zod validation schemas, and utility functions for defining and analyzing MCP load test configurations. It serves as the foundational library for the `@reaatech/mcp-load-test` ecosystem, exporting domain models for load profiles, tool call patterns, and performance metrics.

Orchestrates load testing for Model Context Protocol (MCP) servers by managing session pools, concurrency patterns, and breaking point detection. It provides a `LoadEngine` class that executes defined test profiles and returns a structured `LoadTestReport` containing performance metrics and auto-graded results.

Aggregates latency histograms, error rates, and throughput metrics for Model Context Protocol (MCP) load testing. It provides a `MetricsCollector` class that processes individual request records to generate per-tool performance statistics and rolling-window error analysis.

Provides a `PatternExecutor` class to run stateful, multi-step MCP tool-call sequences for load testing. It requires an MCP client and a metrics collector to execute predefined patterns with configurable think times, template variable resolution, and error handling policies.

Provides async generators that yield concurrency and phase metadata at one-second intervals to drive load testing session pools. It offers pre-built ramp, soak, spike, and custom interpolation profiles for controlling MCP load test execution.

Provides classes to format MCP load test results into ANSI-colored console output, GitHub-flavored markdown, or machine-readable JSON. These reporters consume `LoadTestReport` objects generated by the `@reaatech/mcp-load-test-core` package.