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
.env
file, refer to the.env.example
file 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 designexecute_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"
]
}
}
}
Use case
LLM powered result analysis: Collect and analyze test results.
Debugging: Execute tests in non-GUI mode for debugging.
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
Apache JMeter Test Execution Server
Project Details
- QAInsights/jmeter-mcp-server
- Last Updated: 4/19/2025
Recomended MCP Servers
MCP Server for AI automation of the PlayCanvas Editor
An MCP server that autonomously evaluates web applications.
Stdio MCP Server wrapping custom Python runtime (LocalPythonExecutor) from Hugging Faces' `smolagents` framework. The runtime combines the ease...
Inkdrop Model Context Protocol Server
pocketbase-mcp-server

The official Redis MCP Server is a natural language interface designed for agentic applications to manage and search...
An official Qdrant Model Context Protocol (MCP) server implementation

MCP Server for Trino developed via MCP Python SDK
A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration with LLM processing capabilities.