🚀 ⚡️ k6-mcp-サーバー
k6 負荷テストを実行するためのモデル コンテキスト プロトコル (MCP) サーバー実装。
✨ 特徴
- モデルコンテキストプロトコルフレームワークとのシンプルな統合
- カスタムテスト期間と仮想ユーザー(VU)のサポート
- k6 負荷テストを実行するための使いやすい API
- 環境変数で設定可能
- リアルタイムテスト実行出力
🔧 前提条件
始める前に、以下がインストールされていることを確認してください。
📦 インストール
- リポジトリをクローンします。
git clone https://github.com/yourusername/k6-mcp-server.git
- 必要な依存関係をインストールします。
uv pip install -r requirements.txt
- 環境変数を設定する (オプション): プロジェクト ルートに
.env
ファイルを作成します。
K6_BIN=/path/to/k6 # Optional: defaults to 'k6' in system PATH
🚀 はじめに
- k6 テスト スクリプト (例:
test.js
) を作成します。
import http from "k6/http";
import { sleep } from "k6";
export default function () {
http.get("http://test.k6.io");
sleep(1);
}
- お気に入りの MCP クライアント (Claude Desktop、Cursor、Windsurf など) で以下の仕様を使用して MCP サーバーを構成します。
{
"mcpServers": {
"k6": {
"command": "/Users/naveenkumar/.local/bin/uv",
"args": [
"--directory",
"/Users/naveenkumar/Gits/k6-mcp-server",
"run",
"k6_server.py"
]
}
}
}
- 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
)
🤝 貢献する
貢献を歓迎します!お気軽にプルリクエストを送信してください。
📄 ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。