Skip to main content
Glama
dil-anoojibettu

k6 MCP Server

by dil-anoojibettu
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

Related MCP server: JMeter MCP Server (TypeScript Edition)

🔧 Prerequisites

Before you begin, ensure you have the following installed:

📦 Installation

  1. Clone the repository:

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

  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": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/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

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
)

✨ Use cases

  • LLM powered results analysis

  • Effective debugging of load tests

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

  • octoperfOAuthDeprecated
    io.github.OctoPerf

    Drive OctoPerf load testing from any AI agent: import, edit, validate, run scenarios, read metrics.

    Testing & QA ToolsMonitoring
    2
  • maxoperf
    com.maxoperf

    Load & browser performance testing — drive MaxoPerf from your AI agent with your API key.

    Testing & QA ToolsMonitoringBrowser Automation
    21
  • LoadsterAOAuth
    com.loadster

    Load testing and synthetic monitoring platform: test with Playwright, Browser Bot, or Protocol Bots.

    Browser AutomationMonitoringTesting & QA Tools
    551
  • MCP Server By TestMu AIOAuth
    com.lambdatest.mcp

    Run, debug, and triage tests from your IDE using natural language, no dashboard switching, no manual data transfers. The TestMu AI (formerly LambdaTest) MCP Server is a single remote server exposing four tool suites: HyperExecute — analyze your project, generate YAML configs and test runner commands, then monitor jobs and sessions. Automation — pull a TestID's details plus command, network, and console logs into one chat for instant root-cause analysis. Includes mobile app upload. SmartUI — explain pixel, layout, DOM, and perceptual changes in a visual regression run, with context-aware React/HTML/CSS fixes. Accessibility — audit any public URL or a local React app against WCAG and get ready-to-apply remediation steps. Connects over https://mcp.lambdatest.com/mcp using OAuth 2.1 — no API keys in your config. One-click install in Cursor; works with Claude, GitHub Copilot, Cline, and any MCP client. Tests execute on the TestMu AI cloud: 3,000+ browsers and 10,000+ real devices.

    Cloud PlatformsTesting & QA Tools
    1

Related MCP Servers

  • k6-mcp-server

    QAInsights
    A
    license
    C
    quality
    D
    maintenance
    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.
    2
    26
    MIT

  • JMeter MCP Server (TypeScript

    vjgit-369
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to programmatically create, execute, and analyze Apache JMeter performance tests. It supports automated bottleneck detection, report generation, and distributed testing management through natural language.
    MIT

  • jmeter-mcp

    Realtyka
    F
    license
    Not graded
    quality
    C
    maintenance
    Integrates Apache JMeter with AI assistants to run and manage load tests through natural language. It enables users to execute test plans, parse results, inspect test structures, and compare performance metrics across different runs.
    -

  • Artillery MCP Server

    jch1887
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables running and inspecting Artillery load tests from MCP-compatible clients like Claude Desktop and Cursor, with features like saved configurations, preset tests, and regression detection.
    301 npm
    1
    MIT