k6-mcp-server

🚀 ⚡️ k6-mcp-server

A Model Context Protocol (MCP) server implementation for running k6 load tests.

✨ Features

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

🔧 Prerequisites

Before you begin, ensure you have the following installed:

Python 3.12 or higher
k6 load testing tool (Installation guide)
uv package manager (Installation guide)

📦 Installation

Clone the repository:

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

Install the required dependencies:

uv pip install -r requirements.txt

Set up environment variables (optional): Create a .env file in the project root:

K6_BIN=/path/to/k6  # Optional: defaults to 'k6' in system PATH

🚀 Getting Started

Create a k6 test script (e.g., test.js):

import http from "k6/http";
import { sleep } from "k6";

export default function () {
  http.get("http://test.k6.io");
  sleep(1);
}

Configure the MCP server using the below specs in your favorite MCP client (Claude Desktop, Cursor, Windsurf and more):

{
  "mcpServers": {
    "k6": {
      "command": "/Users/naveenkumar/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/naveenkumar/Gits/k6-mcp-server",
        "run",
        "k6_server.py"
      ]
    }
  }
}

Now ask the LLM to run the test e.g. run k6 test for hello.js. The k6 mcp server will leverage either one of the below tools to start the test.

execute_k6_test: Run a test with default options (30s duration, 10 VUs)
execute_k6_test_with_options: Run a test with custom duration and VUs

k6-MCP

📝 API Reference

Execute K6 Test

execute_k6_test(
    script_file: str,
    duration: str = "30s",  # Optional
    vus: int = 10          # Optional
)

Execute K6 Test with Custom Options

execute_k6_test_with_options(
    script_file: str,
    duration: str,
    vus: int
)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

A Model Context Protocol (MCP) server implementation that allows AI assistants to run k6 load tests through natural language commands, supporting custom test durations and virtual users.

Related MCP Servers

Redash MCP Server
suthio
A
security
F
license
A
quality
Model Context Protocol (MCP) server that integrates Redash with AI assistants like Claude, allowing them to query data, manage visualizations, and interact with dashboards through natural language.
Last updated -
10
53
16
JavaScript
DroidMind
hyperb1iss
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that enables AI assistants to control and interact with Android devices, allowing for device management, app debugging, system analysis, and UI automation through natural language commands.
Last updated -
29
143
Python
Apache 2.0
JMeter MCP Server
QAInsights
A
security
F
license
A
quality
A Model Context Protocol server that allows AI assistants to execute and manage JMeter performance tests through natural language commands.
Last updated -
2
10
Python
mcp-server-leetcode
doggybee
A
security
A
license
A
quality
A Model Context Protocol (MCP) server for LeetCode that enables AI assistants to access LeetCode problems, user information, and contest data.
Last updated -
7
1
TypeScript
MIT License

View all related MCP servers

Appeared in Searches

Definition and applications of 'sequential'

k6-mcp-server

🚀 ⚡️ k6-mcp-server

✨ Features

🔧 Prerequisites

📦 Installation

🚀 Getting Started

📝 API Reference

Execute K6 Test

Execute K6 Test with Custom Options

🤝 Contributing

📄 License

Related MCP Servers

Redash MCP Server

DroidMind

JMeter MCP Server

mcp-server-leetcode

Appeared in Searches

New MCP Servers

MCP directory API