Jmeter

🚀 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 擴展名。
• 捕獲並返回任何執行錯誤，方便用戶及時發現和解決問題。