K6 MCP Server Fby

🚀⚡️ k6-mcp-server

このプロジェクトは、k6負荷テストを実行するためのモデルコンテキストプロトコル（MCP）サーバーの実装です。

🚀 クイックスタート

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など）でk6 MCPサーバーを以下の設定で構成します。

{
  "mcpServers": {
    "k6": {
      "command": "/Users/naveenkumar/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/naveenkumar/Gits/k6-mcp-server",
        "run",
        "k6_server.py"
      ]
    }
  }
}

3. これで、LLMを使ってテストを実行できます。例えば、hello.jsのk6テストを実行と入力すると、k6 MCPサーバーが以下のいずれかのツールを使ってテストを開始します。

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

✨ 主な機能

• モデルコンテキストプロトコルフレームワークへの簡単な統合
• カスタムテスト時間と仮想ユーザー（VUs）のサポート
• k6負荷テストを実行するための使いやすいAPI
• 環境変数による設定
• リアルタイムのテスト実行出力

🔧 技術詳細

🔧 先决条件

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

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

📦 インストール

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

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

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

uv pip install -r requirements.txt

3. 環境変数を設定します（オプション）。 プロジェクトのルートディレクトリに.envファイルを作成します。

K6_BIN=/path/to/k6  # オプション：デフォルトはシステムPATH内の'k6'

📚 ドキュメント

📝 API 参考

基本的な使用法

# デフォルトオプションでk6テストを実行
execute_k6_test(
    script_file: str,
    duration: str = "30s",  # オプション：デフォルトは"30秒"
    vus: int = 10          # オプション：デフォルトは10
)

高度な使用法

# カスタムオプションでk6テストを実行
execute_k6_test_with_options(
    script_file: str,
    duration: str,
    vus: int
)

🤝 貢献

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

📄 ライセンス

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