🚀 JMeter MCP Server

🚀 JMeter MCP サーバー

これは、MCP 対応クライアントから JMeter テストを実行できる Model Context Protocol（MCP）サーバーです。

重要

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

📋 機能

• 📊 非 GUI モードで JMeter テストを実行
• 🖥️ GUI モードで JMeter を起動
• 📝 実行結果を取得して返す

🛠️ インストール

ローカルインストール

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

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

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

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

3. .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 対応クライアントが利用可能なツールを使用します。
   • 🖥️ execute_jmeter_test：GUI モードで JMeter を起動しますが、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 であることを確認します。
• 実行時のエラーを取得して返します。