🚀 JMeter MCP 서버
이는 MCP 호환 클라이언트를 통해 JMeter 테스트를 실행할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.
[!중요] 📢 JMeter에서 AI 어시스턴트를 찾고 계신가요? 🚀 Feather Wand를 확인해 보세요.



📋 특징
- 📊 GUI가 아닌 모드에서 JMeter 테스트 실행
- 🖥️ GUI 모드에서 JMeter 실행
- 📝 실행 출력을 캡처하고 반환합니다.
🛠️ 설치
로컬 설치
uv
설치 :- JMeter가 시스템에 설치되어 있고 명령줄을 통해 접근할 수 있는지 확인하세요.
⚠️ 중요 : JMeter가 실행 가능한지 확인하세요. 다음을 실행하여 실행할 수 있습니다.
지엑스피1
.env
파일을 구성합니다. 자세한 내용은 .env.example
파일을 참조하세요.
# JMeter Configuration
JMETER_HOME=/path/to/apache-jmeter-5.6.3
JMETER_BIN=${JMETER_HOME}/bin/jmeter
# Optional: JMeter Java options
JMETER_JAVA_OPTS="-Xms1g -Xmx2g"
💻 MCP 사용법
- MCP 호환 클라이언트(예: Claude Desktop, Cursor, Windsurf)를 사용하여 서버에 연결합니다.
- 서버에 프롬프트를 보냅니다.
Run JMeter test /path/to/test.jmx
- MCP 호환 클라이언트는 다음 도구를 사용합니다.
- 🖥️
execute_jmeter_test
: GUI 모드에서 JMeter를 시작하지만 JMeter 설계에 따라 테스트를 실행하지 않습니다. - 🚀
execute_jmeter_test_non_gui
: GUI가 아닌 모드에서 JMeter 테스트를 실행합니다(더 나은 성능을 위한 기본 모드)
🏗️ MCP 구성
MCP 클라이언트 구성에 다음 구성을 추가하세요.
{
"mcpServers": {
"jmeter": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/jmeter-mcp-server",
"run",
"jmeter_server.py"
]
}
}
}
✨ 사용 사례
LLM 기반 결과 분석: 시험 결과를 수집하고 분석합니다.
디버깅: 디버깅을 위해 GUI 모드가 아닌 모드에서 테스트를 실행합니다.
🛑 오류 처리
서버는 다음을 수행합니다.
- 테스트 파일이 존재하는지 확인하세요
- 파일의 확장자가 .jmx인지 확인하세요
- 실행 오류를 캡처하여 반환합니다.