🚀 JMeter MCP Server

🚀 JMeter MCP 服务

这是一个模型上下文协议（MCP）服务，可通过兼容 MCP 的客户端执行 JMeter 测试。

重要

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

📋 功能

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

🛠️ 安装

本地安装

1. 安装 uv：

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

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

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

3. 配置 .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 的客户端将使用可用工具：
   • 🖥️ 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"
        ]
      }
    }
}

✨ 用例

大模型驱动的结果分析：收集并分析测试结果。

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

🛑 错误处理

服务将：

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