Jmeter MCP Server

🚀 JMeter MCP サーバー

このサーバーは、MCP 互換クライアントを通じて JMeter テストを実行できるモデルコンテキストプロトコル (MCP) サーバーです。

⚠️ 重要提示

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

✨ 主な機能

• 📊 グラフィカルユーザーインターフェイス (GUI) なしで JMeter テストを実行します。
• 🖥️ 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"
        ]
      }
    }
}

📚 ドキュメント

使用シナリオ

• LLM 強化結果分析：テスト結果を収集して分析します。
• デバッグ：デバッグのために GUI なしでテストを実行します。

エラーハンドリング

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

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