🚀 ⚡️ Servidor Locust Mcp

O que é o Servidor Locust MCP?

O ### Servidor Locust MCP é uma implementação especializada projetada para facilitar testes de carga usando o Locust, uma ferramenta de teste de carga de código aberto popular. Este servidor permite que os usuários realizem testes de carga de forma eficiente, integrando as capacidades do Locust com ambientes de desenvolvimento impulsionados por IA. Ele fornece uma estrutura robusta para simular o tráfego de usuários e medir o desempenho do sistema sob várias condições, tornando-se uma ferramenta essencial para desenvolvedores e testadores que buscam garantir que suas aplicações possam lidar com as cargas esperadas.

Recursos do Servidor Locust MCP

• Integração Sem Costura: O Servidor Locust MCP se integra suavemente com ambientes de desenvolvimento existentes, permitindo uma configuração e execução fáceis de testes de carga.
• Capacidades Impulsionadas por IA: Aproveite as tecnologias de IA para aprimorar as estratégias de teste de carga, fornecendo insights e otimizações que métodos tradicionais podem negligenciar.
• Escalabilidade: O servidor é projetado para lidar com um grande número de usuários simultâneos, tornando-o adequado para testar aplicações de todos os tamanhos.
• Monitoramento em Tempo Real: Os usuários podem monitorar o desempenho de suas aplicações em tempo real durante os testes de carga, permitindo feedback e ajustes imediatos.
• Cenários Personalizáveis: Crie cenários de teste de carga sob medida que imitam o comportamento real dos usuários, garantindo que os testes sejam relevantes e eficazes.

Como Usar o Servidor Locust MCP

1. Instalação: Comece instalando o Servidor Locust MCP em sua máquina ou servidor. Siga as instruções de instalação fornecidas na documentação.
2. Configuração: Configure as definições do servidor para corresponder aos seus requisitos de teste. Isso inclui configurar o número de usuários, a duração do teste e quaisquer cenários específicos que você deseja simular.
3. Executar Testes: Inicie os testes de carga através da interface do servidor. Monitore o progresso e os resultados em tempo real para obter insights sobre o desempenho da sua aplicação.
4. Analisar Resultados: Após a conclusão dos testes, analise os resultados para identificar gargalos, problemas de desempenho e áreas para melhoria.
5. Iterar: Com base nas descobertas, faça os ajustes necessários em sua aplicação e repita o processo de teste para garantir um desempenho ideal.

Perguntas Frequentes

Q: Qual é o principal objetivo do Servidor Locust MCP?

A: O principal objetivo é facilitar testes de carga para aplicações, permitindo que os desenvolvedores simulem o tráfego de usuários e avaliem o desempenho sob várias condições.

Q: Posso integrar o Servidor Locust MCP com outras ferramentas?

A: Sim, o Servidor Locust MCP foi projetado para se integrar a várias ferramentas de desenvolvimento e teste, aprimorando sua funcionalidade e usabilidade.

Q: Há algum custo associado ao uso do Servidor Locust MCP?

A: O Servidor Locust MCP é de código aberto e gratuito para uso, tornando-o acessível para desenvolvedores e organizações de todos os tamanhos.

Q: Como posso contribuir para o projeto do Servidor Locust MCP?

A: Contribuições são bem-vindas! Você pode participar relatando problemas, sugerindo recursos ou enviando melhorias de código através do repositório do projeto.

Q: Onde posso encontrar mais informações sobre o Servidor Locust MCP?

A: Para informações mais detalhadas, documentação e suporte, visite o site oficial em qainsights.com.

🚀 ⚡️ locust-mcp-server

A Model Context Protocol (MCP) server implementation for running Locust load tests. This server enables seamless integration of Locust load testing capabilities with AI-powered development environments.

✨ Features

• Simple integration with Model Context Protocol framework
• Support for headless and UI modes
• Configurable test parameters (users, spawn rate, runtime)
• Easy-to-use API for running Locust load tests
• Real-time test execution output
• HTTP/HTTPS protocol support out of the box
• Custom task scenarios support

🔧 Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.13 or higher
• uv package manager (Installation guide)

📦 Installation

1. Clone the repository:

git clone https://github.com/qainsights/locust-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:

LOCUST_HOST=http://localhost:8089  # Default host for your tests
LOCUST_USERS=3                     # Default number of users
LOCUST_SPAWN_RATE=1               # Default user spawn rate
LOCUST_RUN_TIME=10s               # Default test duration

🚀 Getting Started

1. Create a Locust test script (e.g., hello.py):

from locust import HttpUser, task, between

class QuickstartUser(HttpUser):
    wait_time = between(1, 5)

    @task
    def hello_world(self):
        self.client.get("/hello")
        self.client.get("/world")

    @task(3)
    def view_items(self):
        for item_id in range(10):
            self.client.get(f"/item?id={item_id}", name="/item")
            time.sleep(1)

    def on_start(self):
        self.client.post("/login", json={"username":"foo", "password":"bar"})

2. Configure the MCP server using the below specs in your favorite MCP client (Claude Desktop, Cursor, Windsurf and more):

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

3. Now ask the LLM to run the test e.g. run locust test for hello.py. The Locust MCP server will use the following tool to start the test:

• run_locust: Run a test with configurable options for headless mode, host, runtime, users, and spawn rate

📝 API Reference

Run Locust Test

run_locust(
    test_file: str,
    headless: bool = True,
    host: str = "http://localhost:8089",
    runtime: str = "10s",
    users: int = 3,
    spawn_rate: int = 1
)

Parameters:

• test_file: Path to your Locust test script
• headless: Run in headless mode (True) or with UI (False)
• host: Target host to load test
• runtime: Test duration (e.g., "30s", "1m", "5m")
• users: Number of concurrent users to simulate
• spawn_rate: Rate at which users are spawned

✨ Use Cases

• LLM powered results analysis
• Effective debugging with the help of LLM

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