QAInsights_jmeter-mcp-server
If you are the rightful owner of QAInsights_jmeter-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
JMeter MCP Server allows executing JMeter tests through MCP-compatible clients.
🚀 JMeter MCP Server
This is a Model Context Protocol (MCP) server that allows executing JMeter tests through MCP-compatible clients.
[!IMPORTANT] 📢 Looking for an AI Assistant inside JMeter? 🚀 Check out Feather Wand
📋 Features
- 📊 Execute JMeter tests in non-GUI mode
- 🖥️ Launch JMeter in GUI mode
- 📝 Capture and return execution output
🛠️ Installation
Local Installation
-
Install
uv: -
Ensure JMeter is installed on your system and accessible via the command line.
⚠️ Important: Make sure JMeter is executable. You can do this by running:
chmod +x /path/to/jmeter/bin/jmeter
- Configure the
.envfile, refer to the.env.examplefile for details.
# 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 Usage
-
Connect to the server using an MCP-compatible client (e.g., Claude Desktop, Cursor, Windsurf)
-
Send a prompt to the server:
Run JMeter test /path/to/test.jmx
- MCP compatible client will use the available tools:
- 🖥️
execute_jmeter_test: Launches JMeter in GUI mode, but doesn't execute test as per the JMeter design - 🚀
execute_jmeter_test_non_gui: Execute a JMeter test in non-GUI mode (default mode for better performance)
- 🖥️
🏗️ MCP Configuration
Add the following configuration to your MCP client config:
{
"mcpServers": {
"jmeter": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/jmeter-mcp-server",
"run",
"jmeter_server.py"
]
}
}
}
🛑 Error Handling
The server will:
- Validate that the test file exists
- Check that the file has a .jmx extension
- Capture and return any execution errors
