🚀 JMeter MCP Server

🚀 JMeter MCP Server

这是一个 Model Context Protocol（MCP）服务，允许通过兼容 MCP 的客户端执行 JMeter 测试并分析测试结果。

重要

📢 想在 JMeter 中使用 AI 助手吗？🚀 查看 Feather Wand

📋 功能

JMeter 执行

• 📊 以非 GUI 模式执行 JMeter 测试
• 🖥️ 以 GUI 模式启动 JMeter
• 📝 捕获并返回执行输出
• 📊 生成 JMeter 报告仪表板

测试结果分析

• 📈 解析并分析 JMeter 测试结果（JTL 文件）
• 📊 计算全面的性能指标
• 🔍 自动识别性能瓶颈
• 💡 生成可执行的见解和建议
• 📊 创建测试结果可视化图表
• 📑 生成包含分析结果的 HTML 报告

🛠️ 安装

本地安装

1. 安装 uv：

2. 确保系统已安装 JMeter，并且可以通过命令行访问。

⚠️ 重要：确保 JMeter 可执行。运行以下命令即可：

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

3. 安装所需的 Python 依赖项：

pip install -r requirements.txt

4. 配置 .env 文件，详情请参阅 .env.example 文件。

# 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 用法

1. 使用兼容 MCP 的客户端（例如 Claude Desktop、Cursor、Windsurf）连接到服务

2. 向服务发送提示词：

Run JMeter test /path/to/test.jmx

3. 兼容 MCP 的客户端将使用可用工具：

JMeter 执行工具

• 🖥️ execute_jmeter_test：以 GUI 模式启动 JMeter，但根据 JMeter 的设计不会执行测试
• 🚀 execute_jmeter_test_non_gui：以非 GUI 模式执行 JMeter 测试（默认模式，性能更好）

测试结果分析工具

• 📊 analyze_jmeter_results：分析 JMeter 测试结果，并提供关键指标和见解摘要
• 🔍 identify_performance_bottlenecks：识别 JMeter 测试结果中的性能瓶颈
• 💡 get_performance_insights：获取提升性能的见解和建议
• 📈 generate_visualization：生成 JMeter 测试结果的可视化图表

🏗️ MCP 配置

将以下配置添加到 MCP 客户端配置中：

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

✨ 用例

测试执行

• 以非 GUI 模式运行 JMeter 测试，以获得更好的性能
• 以 GUI 模式启动 JMeter，以开发测试
• 生成 JMeter 报告仪表板

测试结果分析

• 分析 JTL 文件，了解性能特征
• 识别性能瓶颈及其严重程度
• 获取可执行的性能改进建议
• 生成可视化图表，以便更好地理解结果
• 创建全面的 HTML 报告，与利益相关者分享

🛑 错误处理

服务将：

• 验证测试文件是否存在
• 检查文件是否具有 .jmx 扩展名
• 验证 JTL 文件是否存在且格式有效
• 捕获并返回执行或分析过程中出现的任何错误

📊 测试结果分析器

测试结果分析器是一项强大的功能，可帮助你更好地理解 JMeter 测试结果。它由多个组件组成：

解析器模块

• 支持 XML 和 CSV 格式的 JTL 文件
• 使用流式解析器高效处理大型文件
• 验证文件格式并妥善处理错误

指标计算器

• 计算整体性能指标（平均值、中位数、百分位数）
• 提供特定端点的指标，以便进行详细分析
• 生成时间序列指标，以跟踪性能随时间的变化
• 将指标与基准进行比较，提供参考背景

瓶颈分析器

• 根据响应时间识别响应缓慢的端点
• 检测错误率高、容易出错的端点
• 查找响应时间异常和离群值
• 分析并发对性能的影响

洞察生成器

• 提供解决瓶颈的具体建议
• 分析错误模式并提出解决方案
• 生成有关扩展行为和容量限制的洞察
• 根据潜在影响对建议进行优先级排序

可视化引擎

• 创建展示性能随时间变化的时间序列图
• 生成用于分析响应时间的分布图
• 生成端点对比图表，以识别问题
• 创建包含所有分析结果的综合 HTML 报告

📝 示例用法

# 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