qainsights/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
1. Clone the repository:
2. Install the required dependencies:
3. Set up environment variables (optional):
Create a .env file in the project root:
🚀 Getting Started
1. Create a k6 test script (e.g., test.js):
2. Configure the MCP server using the below specs in your favorite MCP client (Claude Desktop, Cursor, Windsurf and more):
3. 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 with Custom Options
✨ Use cases
- LLM powered results analysis
- Effective debugging of load tests
🤝 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.