🚀 ⚡️ Servidor K6 Mcp

O que é o Servidor k6 MCP?

O ### Servidor k6 MCP é uma ferramenta poderosa projetada para testes de desempenho e testes de carga de aplicações. Ele aproveita as capacidades do framework de testes k6, que é conhecido por sua eficiência e facilidade de uso. O Servidor MCP (Microservices Control Plane) permite que os usuários gerenciem e orquestrem múltiplos scripts de teste k6, possibilitando uma integração perfeita em pipelines de CI/CD e fornecendo uma plataforma centralizada para monitorar e analisar métricas de desempenho.

Recursos do Servidor k6 MCP

• Gestão Centralizada: O Servidor k6 MCP fornece uma única interface para gerenciar múltiplos testes de desempenho, facilitando a organização e execução de testes em diferentes ambientes.
• Monitoramento em Tempo Real: Os usuários podem monitorar os resultados dos testes em tempo real, permitindo insights imediatos sobre o desempenho da aplicação e identificação rápida de gargalos.
• Integração com CI/CD: O servidor pode ser facilmente integrado a fluxos de trabalho de CI/CD existentes, facilitando testes de desempenho automatizados como parte do processo de desenvolvimento.
• Escalabilidade: Projetado para lidar com um grande número de usuários simultâneos, o Servidor k6 MCP pode simular cenários de usuários complexos para testar o desempenho da aplicação sob carga.
• Relatórios Detalhados: O servidor gera relatórios abrangentes que fornecem insights sobre várias métricas de desempenho, ajudando as equipes a tomar decisões informadas com base em dados.

Como Usar o Servidor k6 MCP

1. Instalação: Comece instalando o Servidor k6 MCP no seu ambiente preferido. Siga a documentação oficial para instruções detalhadas de instalação.
2. Configuração: Configure as definições do servidor para corresponder aos seus requisitos de teste. Isso inclui a configuração de scripts de teste, cenários de usuários e limites de desempenho.
3. Execução de Testes: Use a interface do servidor para iniciar testes de desempenho. Você pode selecionar scripts de teste específicos e definir o número de usuários virtuais a serem simulados.
4. Monitoramento: Enquanto os testes estão em execução, monitore as métricas de desempenho em tempo real através do painel do servidor.
5. Análise de Resultados: Após a conclusão dos testes, revise os relatórios gerados para analisar os dados de desempenho e identificar quaisquer problemas que precisam ser resolvidos.

Perguntas Frequentes

Qual é o principal objetivo do Servidor k6 MCP?

O principal objetivo do Servidor k6 MCP é facilitar testes de desempenho e testes de carga de aplicações, fornecendo uma plataforma centralizada para gerenciar múltiplos scripts de teste e monitorar resultados.

Posso integrar o Servidor k6 MCP com meu pipeline de CI/CD existente?

Sim, o Servidor k6 MCP foi projetado para se integrar perfeitamente com pipelines de CI/CD, permitindo testes de desempenho automatizados como parte do fluxo de trabalho de desenvolvimento.

Como o Servidor k6 MCP lida com testes em larga escala?

O Servidor k6 MCP é construído para escalar, permitindo que os usuários simulem um grande número de usuários simultâneos e cenários de usuários complexos, tornando-o ideal para testar aplicações sob carga pesada.

Que tipo de relatórios o Servidor k6 MCP gera?

O Servidor k6 MCP gera relatórios de desempenho detalhados que incluem métricas como tempos de resposta, taxa de transferência, taxas de erro e utilização de recursos, ajudando as equipes a entender o desempenho da aplicação de forma abrangente.

Existe uma licença para usar o Servidor k6 MCP?

Sim, o Servidor k6 MCP está disponível sob a licença MIT, que permite uso, modificação e distribuição gratuitos.

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

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

2. Install the required dependencies:

uv pip install -r requirements.txt

3. 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);
}

2. 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"
      ]
    }
  }
}

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(
    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

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