k6-mcp-server

by QAInsights
Verified

Integrations

  • Enables running load tests through k6, supporting customizable test durations and virtual user counts with real-time execution output

🚀 ⚡️ k6-mcp-サーバー

k6 負荷テストを実行するためのモデル コンテキスト プロトコル (MCP) サーバー実装。

✨ 特徴

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

🔧 前提条件

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

📦 インストール

  1. リポジトリをクローンします。
git clone https://github.com/yourusername/k6-mcp-server.git
  1. 必要な依存関係をインストールします。
uv pip install -r requirements.txt
  1. 環境変数を設定する (オプション): プロジェクト ルートに.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); }
  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" ] } } }
  1. 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 ファイルを参照してください。

-
security - not tested
A
license - permissive license
-
quality - not tested

AI アシスタントが自然言語コマンドを通じて k6 負荷テストを実行できるようにし、カスタム テスト期間と仮想ユーザーをサポートするモデル コンテキスト プロトコル (MCP) サーバー実装。

  1. ✨ Features
    1. 🔧 Prerequisites
      1. 📦 Installation
        1. 🚀 Getting Started
          1. 📝 API Reference
            1. Execute K6 Test
            2. Execute K6 Test with Custom Options
          2. 🤝 Contributing
            1. 📄 License
              ID: bq2z9vqvbx