🚀 ⚡️ K6 Mcp サーバー

k6 MCPサーバーとは？

k6 MCPサーバーは、アプリケーションのパフォーマンステストと負荷テストのために設計された強力なツールです。これは、効率性と使いやすさで知られるk6テストフレームワークの機能を活用しています。MCP（マイクロサービスコントロールプレーン）サーバーは、ユーザーが複数のk6テストスクリプトを管理およびオーケストレーションできるようにし、CI/CDパイプラインへのシームレスな統合を可能にし、パフォーマンスメトリクスの監視と分析のための集中プラットフォームを提供します。

k6 MCPサーバーの特徴

• 中央管理: k6 MCPサーバーは、複数のパフォーマンステストを管理するための単一のインターフェースを提供し、異なる環境でのテストの整理と実行を容易にします。
• リアルタイム監視: ユーザーはテスト結果をリアルタイムで監視でき、アプリケーションのパフォーマンスに関する即時の洞察を得て、ボトルネックを迅速に特定できます。
• CI/CDとの統合: サーバーは既存のCI/CDワークフローに簡単に統合でき、開発プロセスの一部として自動化されたパフォーマンステストを促進します。
• スケーラビリティ: 大量の同時ユーザーを処理できるように設計されており、k6 MCPサーバーは、負荷の下でアプリケーションのパフォーマンスをテストするための複雑なユーザーシナリオをシミュレーションできます。
• 詳細なレポート: サーバーは、さまざまなパフォーマンスメトリクスに関する洞察を提供する包括的なレポートを生成し、チームがデータに基づいて情報に基づいた意思決定を行うのに役立ちます。

k6 MCPサーバーの使用方法

1. インストール: お好みの環境にk6 MCPサーバーをインストールします。詳細なインストール手順については公式ドキュメントを参照してください。
2. 設定: テスト要件に合わせてサーバー設定を構成します。これには、テストスクリプト、ユーザーシナリオ、およびパフォーマンス閾値の設定が含まれます。
3. テストの実行: サーバーインターフェースを使用してパフォーマンステストを開始します。特定のテストスクリプトを選択し、シミュレーションする仮想ユーザーの数を定義できます。
4. 監視: テストが実行されている間、サーバーダッシュボードを通じてリアルタイムでパフォーマンスメトリクスを監視します。
5. 結果の分析: テストが完了した後、生成されたレポートを確認してパフォーマンスデータを分析し、対処が必要な問題を特定します。

よくある質問

k6 MCPサーバーの主な目的は何ですか？

k6 MCPサーバーの主な目的は、アプリケーションのパフォーマンステストと負荷テストを促進し、複数のテストスクリプトを管理し、結果を監視するための集中プラットフォームを提供することです。

既存のCI/CDパイプラインにk6 MCPサーバーを統合できますか？

はい、k6 MCPサーバーはCI/CDパイプラインとシームレスに統合できるように設計されており、開発ワークフローの一部として自動化されたパフォーマンステストを可能にします。

k6 MCPサーバーは大規模テストをどのように処理しますか？

k6 MCPサーバーはスケールするように構築されており、ユーザーは大量の同時ユーザーや複雑なユーザーシナリオをシミュレーションできるため、重い負荷の下でアプリケーションをテストするのに理想的です。

k6 MCPサーバーはどのようなレポートを生成しますか？

k6 MCPサーバーは、応答時間、スループット、エラー率、リソース利用率などのメトリクスを含む詳細なパフォーマンスレポートを生成し、チームがアプリケーションのパフォーマンスを包括的に理解するのに役立ちます。

k6 MCPサーバーを使用するためのライセンスはありますか？

はい、k6 MCPサーバーはMITライセンスの下で提供されており、無料で使用、変更、配布が可能です。

🚀 ⚡️ k6-mcp-server

A Model Context Protocol (MCP) server implementation for running k6 load tests.

✨ Features

• Simple integration with Model Context Protocol framework
• Support for custom test durations and virtual users (VUs)
• Easy-to-use API for running k6 load tests
• Configurable through environment variables
• Real-time test execution output

🔧 Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.12 or higher
• k6 load testing tool (Installation guide)
• uv package manager (Installation guide)

📦 Installation

1. Clone the repository:

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

2. Install the required dependencies:

uv pip install -r requirements.txt

3. Set up environment variables (optional): Create a .env file in the project root:

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

🚀 Getting Started

1. Create a k6 test script (e.g., test.js):

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

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

2. Configure the MCP server using the below specs in your favorite MCP client (Claude Desktop, Cursor, Windsurf and more):

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

3. Now ask the LLM to run the test e.g. run k6 test for hello.js. The k6 mcp server will leverage either one of the below tools to start the test.

• execute_k6_test: Run a test with default options (30s duration, 10 VUs)
• execute_k6_test_with_options: Run a test with custom duration and VUs

📝 API Reference

Execute K6 Test

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

Execute K6 Test with Custom Options

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

✨ Use cases

• LLM powered results analysis
• Effective debugging of load tests

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.