JMeter
Enables the execution and analysis of JMeter performance tests through MCP-compatible clients. It provides tools for running tests in non-GUI mode, identifying performance bottlenecks, and generating comprehensive insights and visualizations from res
What is JMeter?
JMeter is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables the execution and analysis of jmeter performance tests through mcp-compatible clients. it provides tools for running tests in non-gui mode, identifying performance bottlenecks, and generating ...
Enables the execution and analysis of JMeter performance tests through MCP-compatible clients. It provides tools for running tests in non-GUI mode, identifying performance bottlenecks, and generating comprehensive insights and visualizations from res
This server falls under the Monitoring & Observability and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables the execution and analysis of JMeter performance tes
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx jmeter-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use JMeter
The JMeter MCP server brings Apache JMeter performance testing into your AI assistant workflow, allowing you to execute JMeter test plans in non-GUI mode, analyze result files, identify performance bottlenecks, and generate visualizations — all through natural language conversation. It wraps six specialized tools that cover the full performance testing cycle from test execution to insight generation, making it practical for QA engineers and developers who want AI assistance interpreting JMeter output without manually parsing JTL result files or writing custom scripts.
Prerequisites
- Apache JMeter installed and the jmeter binary accessible (set JMETER_HOME to your installation directory)
- Java 8+ installed and on your PATH (required by JMeter)
- Python 3.8+ with the uv package manager installed
- Python dependencies: numpy and matplotlib (install with pip install numpy matplotlib)
- An MCP-compatible client such as Claude Desktop or Claude Code
Install JMeter and verify it runs
Download Apache JMeter from jmeter.apache.org and extract it. Make the jmeter binary executable and verify it runs. Set JMETER_HOME to the installation path.
chmod +x /path/to/jmeter/bin/jmeter
export JMETER_HOME=/path/to/jmeter
export JMETER_BIN=$JMETER_HOME/bin/jmeterInstall Python dependencies
Install the required Python packages for result parsing and visualization.
pip install numpy matplotlibInstall the JMeter MCP server
Clone or install the jmeter-mcp-server from the QAInsights repository.
git clone https://github.com/QAInsights/jmeter-mcp-server.git
cd jmeter-mcp-server
pip install -e .Configure your MCP client
Add the JMeter MCP server to your Claude Desktop configuration, providing the paths to your JMeter installation.
{
"mcpServers": {
"jmeter": {
"command": "python",
"args": ["-m", "jmeter_mcp_server"],
"env": {
"JMETER_HOME": "/path/to/apache-jmeter",
"JMETER_BIN": "/path/to/apache-jmeter/bin/jmeter"
}
}
}
}Run your first test
Ask your AI assistant to execute a JMeter test plan. The server will invoke JMeter in non-GUI mode and return the results path.
JMeter Examples
Client configuration
Claude Desktop config for the JMeter MCP server with required environment variables.
{
"mcpServers": {
"jmeter": {
"command": "python",
"args": ["-m", "jmeter_mcp_server"],
"env": {
"JMETER_HOME": "/opt/apache-jmeter",
"JMETER_BIN": "/opt/apache-jmeter/bin/jmeter",
"JMETER_JAVA_OPTS": "-Xms1g -Xmx2g"
}
}
}
}Prompts to try
Example requests once the JMeter MCP server is connected.
- "Run the JMeter test plan sample_test.jmx in non-GUI mode and save results to results.jtl"
- "Analyze the JMeter test results in results.jtl and provide detailed insights"
- "What are the performance bottlenecks identified in results.jtl?"
- "Generate a visualization chart from my results.jtl file"
- "Give me improvement recommendations based on the performance test results"Troubleshooting JMeter
JMeter not found or 'JMETER_HOME is not set' error
Set the JMETER_HOME and JMETER_BIN environment variables in your MCP client config to the absolute paths of your JMeter installation. Verify the binary exists at $JMETER_HOME/bin/jmeter and is executable.
Test execution fails with Java heap space errors
Set JMETER_JAVA_OPTS to increase heap size, e.g. '-Xms1g -Xmx4g'. For large test plans with many threads, JMeter needs more memory than its default allocation.
Visualization fails with import errors for matplotlib or numpy
Ensure both numpy and matplotlib are installed in the same Python environment that runs the MCP server: 'pip install numpy matplotlib'. If using a virtual environment, activate it before starting the server.
Frequently Asked Questions about JMeter
What is JMeter?
JMeter is a Model Context Protocol (MCP) server that enables the execution and analysis of jmeter performance tests through mcp-compatible clients. it provides tools for running tests in non-gui mode, identifying performance bottlenecks, and generating comprehensive insights and visualizations from res It connects AI assistants to external tools and data sources through a standardized interface.
How do I install JMeter?
Follow the installation instructions on the JMeter GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with JMeter?
JMeter works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is JMeter free to use?
Yes, JMeter is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
JMeter Alternatives — Similar Monitoring & Observability Servers
Looking for alternatives to JMeter? Here are other popular monitoring & observability servers you can use with Claude, Cursor, and VS Code.
Netdata
★ 78.9kReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Kubeshark
★ 11.9keBPF-powered network observability for Kubernetes. Indexes L4/L7 traffic with full K8s context, decrypts TLS without keys. Queryable by AI agents via MCP and humans via dashboard.
Mission Control
★ 4.9kSelf-hosted AI agent orchestration platform: dispatch tasks, run multi-agent workflows, monitor spend, and govern operations from one mission control dashboard.
Grafana
★ 3.0kThis MCP server enables natural-language querying of Grafana logs by automatically detecting log sources and service labels. It provides read-only access to log data with intelligent caching for efficient repeat queries.
Sentrux
★ 2.4kReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.
OpenInference
★ 986OpenTelemetry Instrumentation for AI Observability
Browse More Monitoring & Observability MCP Servers
Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up JMeter in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use JMeter?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.