🚀 JMeter MCP Server

🚀 JMeter MCP Server

これは、MCP 対応クライアントを通じて JMeter テストを実行し、テスト結果を分析できる Model Context Protocol（MCP）サーバーです。

重要

📢 JMeter 内で AI アシスタントをお探しですか？ 🚀 Feather Wandをご覧ください。

📋 機能

JMeter の実行

• 📊 JMeter テストを非 GUI モードで実行
• 🖥️ JMeter を GUI モードで起動
• 📝 実行出力を取得して返す
• 📊 JMeter レポートダッシュボードを生成

テスト結果の分析

• 📈 JMeter テスト結果（JTL ファイル）を解析して分析
• 📊 包括的なパフォーマンス指標を計算
• 🔍 パフォーマンスのボトルネックを自動的に特定
• 💡 実行可能な分析情報と推奨事項を生成
• 📊 テスト結果を視覚化
• 📑 分析結果を含む HTML レポートを生成

🛠️ インストール

ローカルインストール

1. uvをインストールします。

2. JMeter がシステムにインストールされ、コマンドラインからアクセスできることを確認します。

⚠️ 重要：JMeter が実行可能であることを確認してください。次のコマンドを実行します。

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

3. 必要な Python 依存関係をインストールします。

pip install -r requirements.txt

4. .env ファイルを設定します。詳細は .env.example ファイルを参照してください。

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

# Optional: JMeter Java options
JMETER_JAVA_OPTS="-Xms1g -Xmx2g"

💻 MCP の使用方法

1. MCP 対応クライアント（Claude Desktop、Cursor、Windsurf など）を使用してサーバーに接続します。

2. サーバーにプロンプトを送信します。

Run JMeter test /path/to/test.jmx

3. MCP 対応クライアントは、利用可能なツールを使用します。

JMeter 実行ツール

• 🖥️ execute_jmeter_test：JMeter を GUI モードで起動しますが、JMeter の設計上、テストは実行しません。
• 🚀 execute_jmeter_test_non_gui：JMeter テストを非 GUI モードで実行します（パフォーマンスに優れたデフォルトモード）。

テスト結果分析ツール

• 📊 analyze_jmeter_results：JMeter テスト結果を分析し、主要な指標と分析情報の概要を提供します。
• 🔍 identify_performance_bottlenecks：JMeter テスト結果のパフォーマンスボトルネックを特定します。
• 💡 get_performance_insights：パフォーマンス改善のための分析情報と推奨事項を取得します。
• 📈 generate_visualization：JMeter テスト結果の視覚化を生成します。

🏗️ MCP の設定

次の設定を MCP クライアントの設定ファイルに追加します。

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

✨ ユースケース

テストの実行

• パフォーマンス向上のため、JMeter テストを非 GUI モードで実行
• テスト開発のため、JMeter を GUI モードで起動
• JMeter レポートダッシュボードを生成

テスト結果の分析

• JTL ファイルを分析して、パフォーマンス特性を把握
• パフォーマンスのボトルネックとその深刻度を特定
• パフォーマンス改善のための実行可能な推奨事項を取得
• 結果を把握しやすくするために視覚化を生成
• 関係者と共有するための包括的な HTML レポートを作成

🛑 エラー処理

サーバーは次の処理を行います。

• テストファイルが存在することを検証
• ファイルの拡張子が .jmx であることを確認
• JTL ファイルが存在し、有効な形式であることを検証
• 実行時または分析時のエラーを取得して返す

📊 テスト結果アナライザー

テスト結果アナライザーは、JMeter テスト結果をより深く理解するのに役立つ強力な機能です。いくつかのコンポーネントで構成されています。

パーサーモジュール

• XML と CSV の両方の JTL 形式に対応
• ストリーミングパーサーを使用して大きなファイルを効率的に処理
• ファイル形式を検証し、エラーを適切に処理

指標計算ツール

• 全体的なパフォーマンス指標（平均値、中央値、パーセンタイル）を計算
• 詳細な分析に役立つ、エンドポイントごとの指標を提供
• 時系列指標を生成して、時間経過に伴うパフォーマンスを追跡
• ベンチマークと指標を比較して、状況を把握

ボトルネックアナライザー

• 応答時間に基づいて、遅いエンドポイントを特定します
• エラー率が高く、エラーが発生しやすいエンドポイントを検出します
• 応答時間の異常値や外れ値を見つけます
• 同時実行数がパフォーマンスに与える影響を分析します

インサイトジェネレーター

• ボトルネックの解消に向けた具体的な推奨事項を提示します
• エラーのパターンを分析し、解決策を提案します
• スケーリングの挙動と容量の限界に関するインサイトを生成します
• 予想される影響に基づいて、推奨事項に優先順位を付けます

ビジュアライゼーションエンジン

• パフォーマンスの経時変化を示す時系列グラフを作成します
• 応答時間分析用の分布グラフを生成します
• 問題の特定に役立つエンドポイント比較チャートを作成します
• すべての分析結果をまとめた包括的な HTML レポートを作成します

📝 使用例

# Run a JMeter test and generate a results file
Run JMeter test sample_test.jmx in non-GUI mode and save results to results.jtl

# Analyze the results
Analyze the JMeter test results in results.jtl and provide detailed insights

# Identify bottlenecks
What are the performance bottlenecks in the results.jtl file?

# Get recommendations
What recommendations do you have for improving performance based on results.jtl?

# Generate visualizations
Create a time series graph of response times from results.jtl