🚀 ⚡️ k6-mcp-서버
k6 부하 테스트를 실행하기 위한 MCP(Model Context Protocol) 서버 구현입니다.
✨ 특징
- 모델 컨텍스트 프로토콜 프레임워크와의 간단한 통합
- 사용자 정의 테스트 기간 및 가상 사용자(VU) 지원
- k6 부하 테스트를 실행하기 위한 사용하기 쉬운 API
- 환경 변수를 통해 구성 가능
- 실시간 테스트 실행 출력
🔧 필수 조건
시작하기 전에 다음 사항이 설치되어 있는지 확인하세요.
📦 설치
- 저장소를 복제합니다.
지엑스피1
- 필요한 종속성을 설치하세요:
uv pip install -r requirements.txt
- 환경 변수 설정(선택 사항): 프로젝트 루트에
.env
파일을 만듭니다.
K6_BIN=/path/to/k6 # Optional: defaults to 'k6' in system PATH
🚀 시작하기
- k6 테스트 스크립트를 만듭니다(예:
test.js
):
import http from "k6/http";
import { sleep } from "k6";
export default function () {
http.get("http://test.k6.io");
sleep(1);
}
- 아래 사양을 사용하여 선호하는 MCP 클라이언트(Claude Desktop, Cursor, Windsurf 등)에서 MCP 서버를 구성하세요.
{
"mcpServers": {
"k6": {
"command": "/Users/naveenkumar/.local/bin/uv",
"args": [
"--directory",
"/Users/naveenkumar/Gits/k6-mcp-server",
"run",
"k6_server.py"
]
}
}
}
- 이제 LLM에 테스트를 실행하도록 요청합니다. 예:
run k6 test for hello.js
. k6 mcp 서버는 아래 도구 중 하나를 활용하여 테스트를 시작합니다.
execute_k6_test
: 기본 옵션(30초 지속, 10 VU)으로 테스트를 실행합니다.execute_k6_test_with_options
: 사용자 지정 기간 및 VU로 테스트 실행

📝 API 참조
K6 테스트 실행
execute_k6_test(
script_file: str,
duration: str = "30s", # Optional
vus: int = 10 # Optional
)
사용자 정의 옵션을 사용하여 K6 테스트 실행
execute_k6_test_with_options(
script_file: str,
duration: str,
vus: int
)
🤝 기여하기
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
📄 라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.