🚀 ⚡️ k6-mcp-server

What is k6-mcp-server?

A Model Context Protocol (MCP) server implementation for running k6 load tests. It integrates the k6 load testing tool into MCP clients (Claude Desktop, Cursor, Windsurf, etc.), enabling users to execute and manage k6 tests through natural language prompts.

How to use k6-mcp-server?

Install Python 3.12+, k6, and uv. Clone the repository and run uv pip install -r requirements.txt. Optionally set the K6_BIN environment variable. In your MCP client, configure the server with the command /path/to/bin/uv and args ["--directory", "/path/to/k6-mcp-server", "run", "k6_server.py"]. Then ask the LLM to run a k6 test (e.g., "run k6 test for hello.js").

Key features of k6-mcp-server

• Simple integration with Model Context Protocol framework
• 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

• LLM-powered results analysis
• Effective debugging of load tests

FAQ from k6-mcp-server

What are the prerequisites?

Python 3.12 or higher, the k6 load testing tool, and the uv package manager must be installed.

How do I configure the MCP server for my client?

Use the JSON configuration with command set to the uv binary path, and args containing "--directory", the path to the k6-mcp-server folder, "run", and "k6_server.py".

What tools does the server expose?

Two tools: execute_k6_test (runs a test with default 30s duration and 10 VUs) and execute_k6_test_with_options (runs a test with custom duration and VUs).

Can I override the k6 binary location?

Yes. Set the K6_BIN environment variable to the path of your k6 binary. If not set, the server defaults to k6 in the system PATH.

What is the default test configuration?

The execute_k6_test tool uses a duration of 30 seconds and 10 virtual users by default.