k6 MCP Server

MCPOpen SourceMIT39.4

by QAInsights • Testing & QA

An MCP server that lets agents run and manage k6 load tests via the Model Context Protocol, useful for automated or LLM-driven testing workflows.

Example Use Cases

1
Start and manage k6 load tests remotely through the Model Context Protocol using simple API calls like execute_k6_test.
2
Run parameterized performance tests with custom durations and VU counts and receive real-time execution output.
3
Integrate LLM-driven workflows to run, monitor, and analyze load test results for debugging and performance analysis.

Description

This project provides a Model Context Protocol (MCP) server implementation to run k6 load tests programmatically. It integrates with MCP clients to accept commands to start tests, supports configurable durations and virtual users (VUs), and streams real-time execution output. The server is configurable via environment variables and is designed to be used in LLM-powered pipelines for running, monitoring, and analyzing load tests.

Capabilities(3 total)

Tools (3)

start_k6_load_test

Start k6 load test in background and return test ID for monitoring Args: url: Target URL to test vus: Number of virtual users (default: 10) duration: Test duration like "30s", "5m" (default: "30s") rps: Requests per second limit (optional) method: HTTP method - GET, POST, PUT, DELETE (default: "GET") headers: HTTP headers as dict (optional) body: Request body - accepts string, dict, or any JSON-serializable object (optional) thresholds: Performance thresholds as dict (optional) Example: # Simple GET test start_k6_load_test("https://api.example.com/health") # POST with JSON object start_k6_load_test( url="https://api.example.com/data", method="POST", headers={"Content-Type": "application/json"}, body={"message": "test data", "timestamp": "2024-01-01"} ) # POST with JSON string start_k6_load_test( url="https://api.example.com/data", method="POST", headers={"Content-Type": "application/json"}, body='{"message": "test data", "timestamp": "2024-01-01"}' )

url:string*vus:integerduration:stringrps:anymethod:stringheaders:anybody:anythresholds:any

check_k6_test_status

Check the status of a running k6 test

test_id:string*

get_k6_test_results

Get detailed results of a completed k6 test

test_id:string*

Quick Actions

View on GitHub

Security

Scanned 3 month(s) ago

Risk Level

MINIMAL

Read-only data retrieval, no side effects

Trust Score

C54/100

5/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities3 Tools / 0 Prompts / 0 Resources

OwnerQAInsights

CategoryTesting & QA

DependenciesStandalone

Set Your Username