🚀 ⚡️ k6-mcp-server

Name: 🚀 ⚡️ k6-mcp-server
Author: MCP-Mirror

@MCP-Mirror

Repository

About 🚀 ⚡️ k6-mcp-server

Mirror of

#k6 #load-testing #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "QAInsights_k6-mcp-server": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-r",
        "requirements.txt"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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).