🚀 ⚡️ k6-mcp-server

🚀 ⚡️ k6-mcp-server

k6 負荷テストを実行するための Model Context Protocol (MCP) サーバー実装です。

✨ 特徴

• Model Context Protocol フレームワークとのシンプルな統合
• カスタムのテスト時間と仮想ユーザー (VU) のサポート
• k6 負荷テストを実行するための使いやすい API
• 環境変数による設定が可能
• リアルタイムのテスト実行出力

🔧 前提条件

始める前に、以下がインストールされていることを確認してください:

• Python 3.12 以上
• k6 負荷テストツール (インストールガイド)
• uv パッケージマネージャー (インストールガイド)

📦 インストール

1. リポジトリをクローンします:

git clone https://github.com/qainsights/k6-mcp-server.git

2. 必要な依存関係をインストールします:

uv pip install -r requirements.txt

3. 環境変数を設定します (任意): プロジェクトのルートに .env ファイルを作成します:

K6_BIN=/path/to/k6  # Optional: defaults to 'k6' in system PATH

🚀 はじめに

1. k6 テストスクリプトを作成します (例: test.js):

import http from "k6/http";
import { sleep } from "k6";

export default function () {
  http.get("http://test.k6.io");
  sleep(1);
}

2. お好みの MCP クライアント (Claude Desktop、Cursor、Windsurf など) で、以下の仕様を使用して MCP サーバーを設定します:

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

3. 次に、LLM にテストの実行を依頼します (例: run k6 test for hello.js)。k6 mcp サーバーは、以下のいずれかのツールを利用してテストを開始します。

• execute_k6_test: デフォルトのオプション (30 秒間、10 VU) でテストを実行します
• execute_k6_test_with_options: カスタムの時間と VU でテストを実行します

📝 API リファレンス

K6 テストの実行

execute_k6_test(
    script_file: str,
    duration: str = "30s",  # Optional
    vus: int = 10          # Optional
)

カスタムオプションを使用した K6 テストの実行

execute_k6_test_with_options(
    script_file: str,
    duration: str,
    vus: int
)

✨ ユースケース

• LLM を活用した結果分析
• 負荷テストの効果的なデバッグ

🤝 コントリビューション

コントリビューションを歓迎します! お気軽に Pull Request を送ってください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています - 詳細は LICENSE ファイルを参照してください。