🚀 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인지 확인하세요
실행 오류를 캡처하여 반환합니다.