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

📋 Features

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

🛠️ 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
  1. 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
  1. 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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that allows AI assistants to execute and manage JMeter performance tests through natural language commands.

  1. 📋 Features
    1. 🛠️ Installation
      1. Local Installation
      2. 💻 MCP Usage
    2. 🏗️ MCP Configuration
      1. ✨ Use case
        1. 🛑 Error Handling

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.
            Last updated -
            85
            2
            TypeScript
          • -
            security
            F
            license
            -
            quality
            A demonstration implementation of the Model Context Protocol server that facilitates communication between AI models and external tools while maintaining context awareness.
            Last updated -
            Python
            • Linux
            • Apple
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables AI agents to generate, fetch, and manage UI components through natural language interactions.
            Last updated -
            10
            2
            TypeScript
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that allows AI assistants to interact with Prefect's workflow automation platform through natural language, enabling users to manage flows, deployments, tasks, and other Prefect resources via conversational commands.
            Last updated -
            4
            Python

          View all related MCP servers

          ID: k5hsl3p7qd