Locust

Locust

Allows running and analyzing Locust tests using MCP compatible clients.

10
Stars
6
Forks
0
Releases

Overview

A Model Context Protocol (MCP) server implementation for running Locust load tests. This server enables seamless integration of Locust load testing capabilities with AI-powered development environments. It exposes a simple toolchain to start and monitor Locust tests from MCP clients, supporting both headless operation and Locust's UI. Users can configure test parameters such as the number of concurrent users, spawn rate, and test duration, and specify the target host. The server is designed to be invoked via the run_locust function, which accepts test_file, headless, host, runtime, users, and spawn_rate. An MCP client can register the server in a mcpServers spec, enabling commands like run locust test for hello.py. Real-time test execution output is available, and HTTP/HTTPS is supported out of the box for remote control and result collection. The project also supports custom task scenarios and is intended to integrate with MCP-enabled development workflows and LLM-powered result analysis.

Details

Owner
QAInsights
Language
Python
License
MIT License
Updated
2025-12-07

Features

Simple MCP integration

Seamless integration with the Model Context Protocol framework for easy adoption.

Headless and UI modes

Supports both headless execution and Locust UI for interactive testing.

Configurable test parameters

Configure users, spawn rate, and runtime to tailor load tests.

Easy-to-use run_locust API

Provides a straightforward API to start Locust load tests from MCP.

Real-time execution output

Streaming feedback during test runs for monitoring and analysis.

HTTP/HTTPS protocol support

Out-of-the-box support for network protocols to control tests and collect results.

Custom task scenarios

Allow custom Locust task scenarios to be executed within the MCP server.

Audience

DevelopersUse MCP clients to run Locust tests and analyze results with AI-powered assistants.
QA EngineersLeverage MCP server to simulate user load and debug performance with LLM insights.

Tags

MCPLocustload-testingAILLMheadlessUIHTTPHTTPStest-automationcustom-tasksreal-time-outputMCP-serverintegration