k6-mcp-server

Integrations

  • Enables running load tests through k6, supporting customizable test durations and virtual user counts with real-time execution output

🚀 ⚡️ 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:

📦 Installation

  1. Clone the repository:
git clone https://github.com/yourusername/k6-mcp-server.git
  1. Install the required dependencies:
uv pip install -r requirements.txt
  1. 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

  1. 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); }
  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" ] } } }
  1. 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

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

-
security - not tested
A
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.

  1. ✨ Features
    1. 🔧 Prerequisites
      1. 📦 Installation
        1. 🚀 Getting Started
          1. 📝 API Reference
            1. Execute K6 Test
            2. Execute K6 Test with Custom Options
          2. 🤝 Contributing
            1. 📄 License

              Related MCP Servers

              • 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
                • Apple
              • 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
                30
                Python
                Apache 2.0
                • Linux
                • Apple
              • 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
              • 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

              ID: bq2z9vqvbx