Qainsights K6 MCP Server

🚀 ⚡️ k6-mcp-server

このプロジェクトは、k6を使用した負荷テストを実行するためのModel Context Protocol（MCP）サーバーの実装です。Model Context Protocolフレームワークに簡単に統合でき、k6負荷テストを効率的に実行できます。

✨ 主な機能

• Model Context Protocolフレームワークへの簡単な統合
• テストの持続時間と仮想ユーザー数（VUs）のカスタマイズが可能
• 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  # オプション：デフォルトはシステムPATH内の'k6'

🚀 クイックスタート

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サーバーを設定する

好みの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でテストを実行する

例えば、hello.jsのk6テストを実行するようにLLMに指示します。k6 MCPサーバーは以下のツールのいずれかを使用してテストを開始します。

• execute_k6_test：デフォルトオプション（持続時間30秒、10個のVU）でテストを実行します。
• execute_k6_test_with_options：カスタムの持続時間とVU数でテストを実行します。

📚 ドキュメント

🔧 APIリファレンス

基本的な使用法

execute_k6_test(
    script_file: str,
    duration: str = "30s",  # オプション：デフォルトは"30s"
    vus: int = 10          # オプション：デフォルトは10
)

高度な使用法

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

✨ 使用シーン

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

🤝 貢献

貢献いただける方は大歓迎です！自由にPull Requestを送信してください。

📄 ライセンス

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