Jmeter

🚀 JMeter MCP サーバー

このサーバーは、Model Context Protocol (MCP) をサポートしており、MCP 互換クライアントを通じて JMeter テストを実行できます。

⚠️ 重要提示

📢 JMeter に統合された AI アシスタントを探していますか？🚀 Feather Wand をご覧ください。

✨ 主な機能

• 📊 JMeter テストを非 GUI モードで実行する
• 🖥️ 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. サーバーにプロンプトを送信します。

/path/to/test.jmx の JMeter テストを実行する

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"
        ]
      }
    }
}

📚 ドキュメント

✨ 使用シーン

• LLM 動的結果分析：テスト結果を収集して分析する。
• デバッグ：非 GUI モードでテストを実行してデバッグする。

🛑 エラー処理

サーバーは以下のことを行います。

• テストファイルが存在することを検証する。
• ファイルが .jmx 拡張子を持っていることを確認する。
• 実行エラーをキャプチャして返す。