🚀 JMeter MCP Server

This is a Model Context Protocol (MCP) server that allows executing JMeter tests through MCP-compatible clients.

📋 Features

• 📊 Execute JMeter tests in non-GUI mode

• 🖥️ Launch JMeter in GUI mode

• 📝 Capture and return execution output

Related MCP server: TestRail MCP Server

🛠️ Installation

Local Installation

1. Install uv:

2. 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:

3. Configure the .env file, refer to the .env.example file for details.

💻 MCP Usage

1. Connect to the server using an MCP-compatible client (e.g., Claude Desktop, Cursor, Windsurf)

2. Send a prompt to the server:

3. 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:

✨ 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