Install
$ agentstack add mcp-hasmcp-mcp-load-test ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
MCP Load Tester
A lightweight load testing tool for Model Context Protocol (MCP) servers using streamable client transport.
This tool is designed to establish multiple concurrent MCP client sessions against a target MCP endpoint, ramp up connections in batches, display a live progress bar, and maintain the sessions until interrupted.
Features
- Concurrent Client Simulation: Simulates up to thousands of concurrent MCP client sessions.
- Ramped Connection Pool: Establishes connections in batches of 100 per second to prevent overwhelming the target server during startup.
- Live Progress Visualization: Displays progress as sessions initialize using a visual progress bar.
- Graceful Shutdown: Intercepts interruption signals (
Ctrl+C) and gracefully shuts down all established sessions. - Customizable Targets: Fully configurable target URL and client count via command-line flags.
Installation
Ensure you have Go installed on your system.
Clone the repository and build or run the project directly:
cd mcp-load-test
go build
Usage
To run the load tester, you must provide the -url flag. You can also optionally customize the load with -clients (which defaults to 20,000 clients):
go run main.go -url="https://your-mcp-server.com/mcp"
With Custom Client Count
go run main.go -url="https://your-mcp-server.com/mcp" -clients=1000
Configuration Flags
| Flag | Type | Description | Default | | :--- | :--- | :--- | :--- | | -url | string | The target URL of the MCP server endpoint. | Required (No default) | | -clients | int | The total number of concurrent MCP clients to spin up. | 20000 |
Graceful Termination
Once all sessions are established, the program stays active keeping the connections alive. To stop the load test and gracefully close all client sessions, press Ctrl+C.
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: hasmcp
- Source: hasmcp/mcp-load-test
- License: Apache-2.0
- Homepage: https://hasmcp.com
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.