Qainsights Jmeter MCP Server

🚀 JMeter MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，它允許通過 MCP 兼容客戶端執行 JMeter 測試。藉助該服務器，用戶能夠方便地利用 MCP 客戶端來運行 JMeter 測試，提升測試執行的便捷性和效率。

⚠️ 重要提示

📢 尋找內置在 JMeter 中的 AI 助手？🚀 查看 Feather Wand

✨ 主要特性

• 📊 可在非 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"
        ]
      }
    }
}

🛑 錯誤處理

服務器將：

• 驗證測試文件是否存在。
• 檢查文件是否具有 .jmx 擴展名。
• 捕獲並返回任何執行錯誤。