k6-mcp-server

Overview

k6-mcp-server is a Python implementation that bridges the gap between AI models and performance testing. It exposes k6 load testing capabilities through MCP, enabling AI assistants to execute and analyze performance tests directly. The server provides two main tools: execute_k6_test for basic testing with default parameters, and execute_k6_test_with_options for customized test scenarios with specific durations and virtual user counts. The integration supports real-time test execution output, making it valuable for automated performance analysis.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• execute_k6_testexecute_k6_test(script_file: str, duration: str = "30s", vus: int = 10)

  Run a k6 load test with default options (30s duration, 10 VUs)

  Try:Run k6 test for hello.jsTry:Execute the k6 load test scriptTry:Run a load test with default settings
• execute_k6_test_with_optionsexecute_k6_test_with_options(script_file: str, duration: str, vus: int)

  Run a k6 load test with custom duration and virtual users

  Try:Run k6 test for script.js with 5 minutes duration and 50 VUsTry:Execute a load test with custom settings: 2 minutes, 20 VUsTry:Run k6 test with custom options for 60 seconds and 30 virtual users

Comparable tools

Installation

git clone https://github.com/qainsights/k6-mcp-server.git

uv pip install -r requirements.txt

K6_BIN=/path/to/k6

{
  "mcpServers": {
    "k6": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/k6-mcp-server",
        "run",
        "k6_server.py"
      ]
    }
  }
}

FAQ

What is the default test duration and virtual user count?

The default test duration is 30 seconds with 10 virtual users (VUs) when using execute_k6_test.

Can I run k6 tests without custom scripts?

No, you need to provide a k6 test script (JavaScript file) to execute through the MCP server.

Compare k6-mcp-server with