🚀 ⚡️ K6 Mcp Сервер

Что такое сервер k6 MCP?

Сервер ### k6 MCP — это мощный инструмент, предназначенный для тестирования производительности и нагрузочного тестирования приложений. Он использует возможности фреймворка тестирования k6, который известен своей эффективностью и простотой в использовании. Сервер MCP (Microservices Control Plane) позволяет пользователям управлять и организовывать несколько тестовых скриптов k6, обеспечивая бесшовную интеграцию в CI/CD пайплайны и предоставляя централизованную платформу для мониторинга и анализа метрик производительности.

Особенности сервера k6 MCP

• Централизованное управление: Сервер k6 MCP предоставляет единый интерфейс для управления несколькими тестами производительности, что упрощает организацию и выполнение тестов в различных средах.
• Мониторинг в реальном времени: Пользователи могут отслеживать результаты тестов в реальном времени, что позволяет быстро получать информацию о производительности приложения и быстро выявлять узкие места.
• Интеграция с CI/CD: Сервер можно легко интегрировать в существующие рабочие процессы CI/CD, что облегчает автоматизированное тестирование производительности в рамках процесса разработки.
• Масштабируемость: Разработанный для обработки большого числа одновременных пользователей, сервер k6 MCP может моделировать сложные сценарии пользователей для тестирования производительности приложения под нагрузкой.
• Подробная отчетность: Сервер генерирует исчерпывающие отчеты, которые предоставляют информацию о различных метриках производительности, помогая командам принимать обоснованные решения на основе данных.

Как использовать сервер k6 MCP

1. Установка: Начните с установки сервера k6 MCP в вашей предпочтительной среде. Следуйте официальной документации для получения подробных инструкций по установке.
2. Конфигурация: Настройте параметры сервера в соответствии с вашими требованиями к тестированию. Это включает в себя настройку тестовых скриптов, сценариев пользователей и порогов производительности.
3. Запуск тестов: Используйте интерфейс сервера для запуска тестов производительности. Вы можете выбрать конкретные тестовые скрипты и определить количество виртуальных пользователей для моделирования.
4. Мониторинг: Во время выполнения тестов отслеживайте метрики производительности в реальном времени через панель управления сервера.
5. Анализ результатов: После завершения тестов просмотрите сгенерированные отчеты для анализа данных о производительности и выявления любых проблем, требующих решения.

Часто задаваемые вопросы

Какова основная цель сервера k6 MCP?

Основная цель сервера k6 MCP — облегчить тестирование производительности и нагрузочное тестирование приложений, предоставляя централизованную платформу для управления несколькими тестовыми скриптами и мониторинга результатов.

Могу ли я интегрировать сервер k6 MCP с моим существующим CI/CD пайплайном?

Да, сервер k6 MCP разработан для бесшовной интеграции с CI/CD пайплайнами, что позволяет автоматизировать тестирование производительности в рамках рабочего процесса разработки.

Как сервер k6 MCP обрабатывает тесты большого масштаба?

Сервер k6 MCP построен для масштабирования, позволяя пользователям моделировать большое количество одновременных пользователей и сложные сценарии пользователей, что делает его идеальным для тестирования приложений под высокой нагрузкой.

Какие отчеты генерирует сервер k6 MCP?

Сервер k6 MCP генерирует подробные отчеты о производительности, которые включают такие метрики, как время отклика, пропускная способность, уровень ошибок и использование ресурсов, помогая командам всесторонне понять производительность приложения.

Есть ли лицензия на использование сервера k6 MCP?

Да, сервер k6 MCP доступен под лицензией MIT, которая позволяет бесплатное использование, модификацию и распространение.

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