JMeter

Executes JMeter tests and analyzes results, providing dashboards, insights, and HTML reports.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ebadahmed10-jmeter-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/jmeter-mcp-server",
        "run",
        "jmeter_server.py"
      ],
      "env": {
        "JMETER_BIN": "${JMETER_HOME}\\/bin\\/jmeter",
        "JMETER_HOME": "\\/path\\/to\\/apache-jmeter-5.6.3",
        "JMETER_JAVA_OPTS": "-Xms1g -Xmx2g"
      }
    }
  }
}

You can run and analyze JMeter tests through an MCP-compatible server that connects to JMeter, executes tests in non-GUI mode or GUI mode for development, and provides in-depth results analysis with visualizations and HTML reports.

How to use

Connect to the MCP server using an MCP-compatible client. Start a request by sending a prompt that specifies the JMeter test you want to run, for example by providing the path to your test file. You can perform two primary modes of operation: execute tests and analyze results. For execution, you can run tests in non-GUI mode for performance and scalability, or launch JMeter in GUI mode when developing or debugging tests. After execution, you will receive the test output and a results file (such as a JTL file) that you can feed into the analysis tools.

Available execution tools let you run tests and obtain outputs, while analysis tools let you parse results, identify bottlenecks, generate insights, and create visualizations. Use the prompt to invoke the appropriate tool, for example to run a test and then analyze the results you would first execute the test and then request analysis on the produced results.

How to install

Prerequisites you need before installation: Node-compatible runtime for MCP, and a JMeter installation accessible from the system path.

Install the MCP runtime and dependencies.
Ensure JMeter is installed on your system and accessible via the command line.
Make sure JMeter is executable.
Synchronize and run the MCP server setup.
Configure environment variables for JMeter and the MCP server as needed.

MCP configuration

{
  "mcpServers": {
    "jmeter": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/jmeter-mcp-server",
        "run",
        "jmeter_server.py"
      ]
    }
  }
}

Additional notes

Environment values shown in the configuration help the MCP server locate JMeter and configure Java options as needed. The example uses a directory path that points to your MCP server implementation and the JMeter launcher script.

Available tools

execute_jmeter_test

Launches JMeter in GUI mode for test development and debugging, returning the execution outputs.

execute_jmeter_test_non_gui

Runs a JMeter test in non-GUI mode for better performance and efficiency during automated runs.

analyze_jmeter_results

Parses JTL results, computes key metrics, and summarizes findings.

identify_performance_bottlenecks

Analyzes results to locate slow endpoints, high error rates, and bottlenecks.

get_performance_insights

Provides actionable recommendations and insights to improve performance.

generate_visualization

Creates visualizations and HTML reports to present test results clearly.