JMeter

What is JMeter MCP Server?

JMeter MCP Server is a Model Context Protocol (MCP) server that enables the execution of JMeter tests through MCP-compatible clients and provides comprehensive analysis of test results. It bridges the gap between JMeter's powerful load testing capabilities and AI workflows, allowing for automated test execution, detailed performance analysis, and actionable insights.

How to use JMeter MCP Server?

To use JMeter MCP Server, you first need to install it locally. This involves installing uv, ensuring JMeter is installed and executable, and then installing the required Python dependencies (numpy, matplotlib). Configuration is done via a .env file, specifying the JMeter home directory and binary path. Once set up, you connect to the server using an MCP-compatible client (e.g., Claude Desktop, Cursor, Windsurf) and send prompts to execute JMeter tests or analyze results. The server provides various tools for execution and analysis, which are invoked by the MCP client based on your prompts.

Key Features of JMeter MCP Server

JMeter Execution

• Execute JMeter tests in non-GUI mode for optimal performance.
• Launch JMeter in GUI mode for test development and debugging.
• Capture and return execution output.
• Generate JMeter report dashboards.

Test Results Analysis

• Parse and analyze JMeter test results (JTL files) in both XML and CSV formats.
• Calculate comprehensive performance metrics (average, median, percentiles, time series).
• Identify performance bottlenecks automatically based on response times, error rates, and anomalies.
• Generate actionable insights and recommendations for performance improvement.
• Create visualizations of test results (time series, distribution, comparison charts).
• Generate comprehensive HTML reports with analysis results.

Robust Error Handling

• Validates test file existence and .jmx extension.
• Checks for valid JTL file formats.
• Captures and returns execution or analysis errors.

Use Cases of JMeter MCP Server

Test Execution

• Running JMeter tests in non-GUI mode for continuous integration and automated performance testing.
• Launching JMeter in GUI mode for interactive test script creation and debugging.
• Generating JMeter report dashboards for quick performance overviews.

Test Results Analysis

• Analyzing JTL files to understand application performance characteristics under load.
• Identifying specific performance bottlenecks and their severity to prioritize optimization efforts.
• Obtaining actionable recommendations to improve application performance and user experience.
• Generating visualizations for better understanding of performance trends and issues.
• Creating comprehensive HTML reports for sharing performance test results with stakeholders.

FAQ about JMeter MCP Server

Q: Can I use JMeter MCP Server with any MCP-compatible client? A: Yes, it is designed to work with various MCP-compatible clients such as Claude Desktop, Cursor, and Windsurf.

Q: What kind of JMeter test results can the server analyze? A: The server can analyze JMeter test results in both XML and CSV JTL formats.

Q: Does the server provide recommendations for performance improvement? A: Yes, the Insights Generator component provides specific recommendations for addressing bottlenecks and improving performance.

Q: How do I configure JMeter MCP Server? A: Configuration is primarily done through a .env file where you specify JMeter home and binary paths, along with optional Java options for JMeter.

Q: What kind of visualizations can be generated? A: The Visualization Engine can create time series graphs, distribution graphs, endpoint comparison charts, and comprehensive HTML reports.

🚀 JMeter MCP Server

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

[!IMPORTANT] 📢 Looking for an AI Assistant inside JMeter? 🚀 Check out Feather Wand

📋 Features

JMeter Execution

• 📊 Execute JMeter tests in non-GUI mode
• 🖥️ Launch JMeter in GUI mode
• 📝 Capture and return execution output
• 📊 Generate JMeter report dashboard

Test Results Analysis

• 📈 Parse and analyze JMeter test results (JTL files)
• 📊 Calculate comprehensive performance metrics
• 🔍 Identify performance bottlenecks automatically
• 💡 Generate actionable insights and recommendations
• 📊 Create visualizations of test results
• 📑 Generate HTML reports with analysis results

🛠️ 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:

chmod +x /path/to/jmeter/bin/jmeter

3. Install required Python dependencies:

pip install numpy matplotlib

4. 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

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

2. Send a prompt to the server:

Run JMeter test /path/to/test.jmx

3. MCP compatible client will use the available tools:

JMeter Execution 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)

Test Results Analysis Tools

• 📊 analyze_jmeter_results: Analyze JMeter test results and provide a summary of key metrics and insights
• 🔍 identify_performance_bottlenecks: Identify performance bottlenecks in JMeter test results
• 💡 get_performance_insights: Get insights and recommendations for improving performance
• 📈 generate_visualization: Generate visualizations of JMeter test results

🏗️ 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 Cases

Test Execution

• Run JMeter tests in non-GUI mode for better performance
• Launch JMeter in GUI mode for test development
• Generate JMeter report dashboards

Test Results Analysis

• Analyze JTL files to understand performance characteristics
• Identify performance bottlenecks and their severity
• Get actionable recommendations for performance improvements
• Generate visualizations for better understanding of results
• Create comprehensive HTML reports for sharing with stakeholders

🛑 Error Handling

The server will:

• Validate that the test file exists
• Check that the file has a .jmx extension
• Validate that JTL files exist and have valid formats
• Capture and return any execution or analysis errors

📊 Test Results Analyzer

The Test Results Analyzer is a powerful feature that helps you understand your JMeter test results better. It consists of several components:

Parser Module

• Supports both XML and CSV JTL formats
• Efficiently processes large files with streaming parsers
• Validates file formats and handles errors gracefully

Metrics Calculator

• Calculates overall performance metrics (average, median, percentiles)
• Provides endpoint-specific metrics for detailed analysis
• Generates time series metrics to track performance over time
• Compares metrics with benchmarks for context

Bottleneck Analyzer

• Identifies slow endpoints based on response times
• Detects error-prone endpoints with high error rates
• Finds response time anomalies and outliers
• Analyzes the impact of concurrency on performance

Insights Generator

• Provides specific recommendations for addressing bottlenecks
• Analyzes error patterns and suggests solutions
• Generates insights on scaling behavior and capacity limits
• Prioritizes recommendations based on potential impact

Visualization Engine

• Creates time series graphs showing performance over time
• Generates distribution graphs for response time analysis
• Produces endpoint comparison charts for identifying issues
• Creates comprehensive HTML reports with all analysis results

📝 Example Usage

# Run a JMeter test and generate a results file
Run JMeter test sample_test.jmx in non-GUI mode and save results to results.jtl

# Analyze the results
Analyze the JMeter test results in results.jtl and provide detailed insights

# Identify bottlenecks
What are the performance bottlenecks in the results.jtl file?

# Get recommendations
What recommendations do you have for improving performance based on results.jtl?

# Generate visualizations
Create a time series graph of response times from results.jtl