k6-mcp-server

sumitbhowmick/k6-mcp-server

3.1

If you are the rightful owner of k6-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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

The k6-MCP server is a robust implementation designed to facilitate the execution of k6 load tests through the Model Context Protocol framework. It offers seamless integration with MCP, allowing users to configure and run load tests with ease. The server supports custom test durations and virtual users (VUs), providing flexibility in test configurations. It is equipped with an easy-to-use API, enabling users to initiate and manage load tests efficiently. The server is also configurable through environment variables, enhancing its adaptability to different testing environments. Real-time test execution output ensures that users can monitor the progress and results of their load tests as they happen.

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

Usages

usage with Claude Desktop

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

usage with Cursor

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

usage with Windsurf

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

Tools

  1. execute_k6_test

    Run the test with the default options (30 seconds duration, 10 virtual users)

  2. execute_k6_test_with_options

    Run tests with custom duration and virtual users