🚀 JMeter MCP 服务器

这是一个支持 Model Context Protocol (MCP) 的服务器，它允许通过 MCP 兼容客户端执行 JMeter 测试，为 JMeter 测试的执行提供了便捷的途径。

⚠️ 重要提示

📢 寻找集成在 JMeter 中的 AI 助手吗？🚀 查看 Feather Wand

🚀 快速开始

本服务器支持通过 MCP 兼容客户端执行 JMeter 测试，下面将为你详细介绍相关功能、安装步骤、使用方法等内容。

✨ 主要特性

• 📊 在非 GUI 模式下执行 JMeter 测试，可获得更好的性能。
• 🖥️ 启动 JMeter 的 GUI 模式，方便进行调试和查看界面。
• 📝 捕获并返回执行输出，便于对测试结果进行分析。

📦 安装指南

本地安装

1. 安装 uv。
2. 确保 JMeter 已安装在系统上并且可通过命令行访问。 ⚠️ 重要：确保 JMeter 可执行。你可以通过运行以下命令来实现：

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

3. 配置 .env 文件，参考 .env.example 文件的详细信息。

# JMeter 配置
JMETER_HOME=/path/to/apache-jmeter-5.6.3
JMETER_BIN=${JMETER_HOME}/bin/jmeter

# 可选：JMeter Java 选项
JMETER_JAVA_OPTS="-Xms1g -Xmx2g"

💻 MCP 使用

1. 使用一个 MCP 兼容客户端（例如，Claude Desktop、Cursor、Windsurf）连接到服务器。
2. 发送提示到服务器：

运行 JMeter 测试 /path/to/test.jmx

3. MCP 兼容客户端将使用以下工具：
   • 🖥️ execute_jmeter_test：启动 JMeter 的 GUI 模式，但不会执行测试，因为这是 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"
        ]
      }
    }
}

✨ 使用示例

基础用法

使用 MCP 兼容客户端连接服务器并发送测试执行提示：

运行 JMeter 测试 /path/to/test.jmx

高级用法

根据不同的需求，选择不同的执行模式：

• 若需要使用 GUI 模式进行调试，可使用 execute_jmeter_test 工具，但注意该工具不会执行测试。
• 若追求更好的性能，可使用 execute_jmeter_test_non_gui 工具在非 GUI 模式下执行测试。

✨ 使用场景

• LLM 动态结果分析：收集并分析测试结果，为后续的优化提供依据。
• 调试：在非 GUI 模式下执行测试以进行调试，提高调试效率。

🛑 错误处理

服务器将进行以下检查和处理：

• 验证测试文件是否存在。
• 检查文件是否具有 .jmx 扩展名。
• 捕获并返回任何执行错误，方便用户及时发现和解决问题。