Qainsights Jmeter MCP Server

🚀 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. サーバーに以下のようなプロンプトを送信します。

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

🛑 エラー処理

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

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