Jmeter MCP Server

🚀 JMeter MCP 服務器

這是一個支持通過 MCP 兼容客戶端執行 JMeter 測試的模型上下文協議 (MCP) 服務器，它能讓你在不同場景下便捷地開展 JMeter 測試工作。

⚠️ 重要提示

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

✨ 主要特性

• 📊 可在無圖形界面模式下執行 JMeter 測試，提升性能。
• 🖥️ 能夠啟動 JMeter 圖形界面模式。
• 📝 捕獲並返回執行輸出，方便後續分析。

📦 安裝指南

本地安裝

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 圖形界面模式，但不會執行測試（因為這是 JMeter 的設計）
   • 🚀 execute_jmeter_test_non_gui：以無圖形界面模式執行 JMeter 測試（默認模式以獲得更好性能）

📚 詳細文檔

🏗️ MCP 配置

在你的 MCP 客戶端配置中添加以下內容：

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

✨ 使用場景

• LLM 強化結果分析：收集並分析測試結果。
• 調試：以無圖形界面模式執行測試以便於調試。

🛑 錯誤處理

服務器將：

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