🚀 JMeter MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，允许通过 MCP 兼容客户端执行 JMeter 测试。

[!重要] 📢 正在寻找 JMeter 中的 AI 助手？🚀 看看Feather Wand

📋 功能

📊 以非 GUI 模式执行 JMeter 测试
🖥️ 以 GUI 模式启动 JMeter
📝 捕获并返回执行输出

🛠️ 安装

本地安装

安装uv ：
确保 JMeter 已安装在您的系统上并可通过命令行访问。

⚠️重要提示：请确保 JMeter 可执行。你可以运行以下命令来执行此操作：

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

配置.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 使用

使用 MCP 兼容客户端（例如 Claude Desktop、Cursor、Windsurf）连接到服务器
向服务器发送提示：

Run JMeter test /path/to/test.jmx

MCP 兼容客户端将使用可用的工具：
- execute_jmeter_test ：以 GUI 模式启动 JMeter，但不按照 JMeter 设计执行测试
- execute_jmeter_test_non_gui ：以非 GUI 模式执行 JMeter 测试（默认模式可获得更好的性能）

🏗️ MCP 配置

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

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

✨ 用例

LLM 支持的结果分析：收集和分析测试结果。

调试：以非 GUI 模式执行测试进行调试。

🛑 错误处理

服务器将：

验证测试文件是否存在
检查文件是否具有 .jmx 扩展名
捕获并返回任何执行错误