Skip to content
reaatechREAATECH

reaatech/mcp-load-test

0Last commit: Jun 4, 2026GitHub →

These packages give you a purpose-built load testing framework for MCP (Model Context Protocol) servers, with a CLI, orchestration engine, transport clients, and analysis tooling. You would adopt them to stress-test MCP servers under realistic concurrent workloads—modeling user behavior with weighted tool-call patterns, detecting breaking points, and producing latency histograms with letter grades. The framework is transport-aware, meaning it accounts for the different concurrency profiles of StreamableHTTP, SSE, and stdio, and uses session-based closed-loop concurrency where long-lived sessions continuously execute patterns with think-time delays and stateful context.

Packages

9 packages

@reaatech/mcp-load-test-analysis

v0.1.0
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`.
status
published
published
21 days ago

@reaatech/mcp-load-test-cli

v0.1.0
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.
status
published
published
21 days ago

@reaatech/mcp-load-test-client

v0.1.0
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.
status
published
published
21 days ago

@reaatech/mcp-load-test-core

v0.1.0
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.
status
published
published
21 days ago

@reaatech/mcp-load-test-engine

v0.1.0
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.
status
published
published
21 days ago

@reaatech/mcp-load-test-metrics

v0.1.0
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.
status
published
published
21 days ago

@reaatech/mcp-load-test-patterns

v0.1.0
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.
status
published
published
21 days ago

@reaatech/mcp-load-test-profiles

v0.1.0
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.
status
published
published
21 days ago

@reaatech/mcp-load-test-reporters

v0.1.0
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.
status
published
published
21 days ago

Comments

Sign in with GitHub to comment and vote.

Loading comments…