Overview
What is JMeter MCP Server?
This is a Model Context Protocol (MCP) server that allows executing JMeter tests through MCP‑compatible clients. It is designed for users who want to run JMeter tests programmatically from tools like Claude Desktop, Cursor, or Windsurf.
How to use JMeter MCP Server?
Install uv and ensure JMeter is installed and executable. Configure the .env file with JMETER_HOME and optionally JMETER_JAVA_OPTS. Add the server to your MCP client’s config (pointing to uv and the server directory). Then send a prompt like “Run JMeter test /path/to/test.jmx” – the client will use available tools: execute_jmeter_test (GUI mode, does not execute) and execute_jmeter_test_non_gui (non‑GUI mode, default for performance).
Key features of JMeter MCP Server
- Execute JMeter tests in non‑GUI mode
- Launch JMeter in GUI mode
- Capture and return execution output
Use cases of JMeter MCP Server
- LLM powered result analysis: collect and analyze test results.
- Debugging: execute tests in non‑GUI mode for debugging.
FAQ from JMeter MCP Server
What tools does the server expose?
The server exposes two tools: execute_jmeter_test (launches JMeter GUI but does not execute the test) and execute_jmeter_test_non_gui (executes the test in non‑GUI mode for better performance).
What are the prerequisites to run the server?
You need uv installed, JMeter installed and accessible via the command line, and the JMeter binary must be executable (e.g., chmod +x /path/to/jmeter/bin/jmeter).
How do I configure the JMeter path?
Set the JMETER_HOME and JMETER_BIN environment variables in a .env file. Optionally set JMETER_JAVA_OPTS to adjust Java heap (e.g., -Xms1g -Xmx2g).
How do I configure an MCP‑compatible client?
Add a configuration block to your client’s settings with the command pointing to uv, the server directory, and the script jmeter_server.py. See the provided JSON example in the README.
Does the server validate test files?
Yes, it validates that the test file exists, has a .jmx extension, and captures any execution output or errors.
