🚀 ⚡️ k6-mcp-server

What is k6-mcp-server?

k6-mcp-server is a Model Context Protocol (MCP) server implementation that enables running k6 load tests through an MCP client (e.g., Claude Desktop, Cursor, Windsurf). It provides two tools to execute k6 test scripts with configurable duration and virtual users (VUs), making it straightforward to integrate load testing into AI-assisted workflows.

How to use k6-mcp-server?

Install Python 3.12+, k6, and the uv package manager. Clone the repository, install dependencies with uv pip install -r requirements.txt, and optionally set K6_BIN in a .env file. Configure your MCP client with the provided JSON block (pointing to uv run k6_server.py), then ask the LLM to run a test. Use the execute_k6_test tool for defaults (30s, 10 VUs) or execute_k6_test_with_options to specify custom duration and VUs.

Key features of k6-mcp-server

• Simple integration with Model Context Protocol clients
• Support for custom test durations and virtual users (VUs)
• Easy-to-use API for running k6 load tests
• Configurable through environment variables
• Real-time test execution output

Use cases of k6-mcp-server

• Automating k6 load tests via an LLM assistant or chat interface
• Running quick performance checks with default parameters (30s, 10 VUs)
• Tuning load tests by specifying custom duration and virtual user counts
• Integrating load testing into AI-powered development workflows

FAQ from k6-mcp-server

What prerequisites are required to use k6-mcp-server?

You need Python 3.12 or higher, the k6 load testing tool, and the uv package manager.

How do I specify a custom test duration and number of virtual users?

Use the execute_k6_test_with_options tool and provide the script_file, duration (e.g., "60s"), and vus (e.g., 50) parameters.

Where does the k6 binary need to be located?

By default the server looks for k6 in the system PATH. You can override this by setting the K6_BIN environment variable in a .env file.

Which MCP clients are compatible with k6-mcp-server?

It works with any MCP client, such as Claude Desktop, Cursor, and Windsurf, when configured with the provided JSON specification.