JMeter MCP Server

🚀 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

Anthropic Cursor Windsurf

📋 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 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"
        ]
      }
    }
}

✨ 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

This server cannot be installed

security - not tested

license - not found

quality - not tested

A Model Context Protocol server that enables executing and interacting with JMeter tests through MCP-compatible clients like Claude Desktop, Cursor, and Windsurf.

Related MCP Servers

MCP Server Example
alejandro-ao
A
security
A
license
A
quality
An educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server for integrating with various LLM clients like Claude Desktop.
Last updated -
1
88
Python
MIT License
Jira MCP Server
InfinitIQ-Tech
-
security
A
license
-
quality
A Model Context Protocol server that enables interaction with Jira's REST API using natural language commands, allowing users to manage Jira projects, issues, comments, and workflows through Claude Desktop and other MCP clients.
Last updated -
1
Python
MIT License
JMeter MCP Server
QAInsights
A
security
F
license
A
quality
A Model Context Protocol server that allows AI assistants to execute and manage JMeter performance tests through natural language commands.
Last updated -
2
10
Python
TestRail MCP Server
sker65
A
security
A
license
A
quality
A Model Context Protocol server that allows interaction with TestRail's core entities (projects, cases, runs, results, datasets) through a standardized protocol compatible with MCP clients like Claude Desktop.
Last updated -
23
3
Python
MIT License

View all related MCP servers

JMeter MCP Server