k6-mcp-server

k6-mcp-server

Model Context Protocol（MCP）に基づく、イベント駆動型のコア機能とプラグインアーキテクチャに焦点を当てた k6-mcp-server の再実装です。このプロジェクトでは、k6 負荷テストツールからデータを受信して処理できるサーバーを提供し、中央の調整ポイントまたはデータ集約サービスとして機能することを目指しています。

API ドキュメント

サーバーは、k6 からデータを受信するための API エンドポイントを公開しています。このセクションでは、想定されるリクエスト形式とサーバーのレスポンスについて説明します。

エンドポイント

POST /data

リクエスト

ヘッダー：

Content-Type: application/json

本文（JSON の例）：

{
  "metric_name": "my_custom_metric",
  "value": 123.45,
  "timestamp": 1678886400,  // Unix timestamp in seconds
  "tags": {
    "environment": "production",
    "region": "us-west-2"
  }
}

レスポンス

成功（200 OK）：

{
  "status": "success",
  "message": "Data received and processed."
}

エラー（400 Bad Request）：

リクエスト本文が無効である場合、または必須フィールドが不足している場合に返されます。レスポンス本文には、エラーの詳細が含まれます。

{
  "status": "error",
  "message": "Invalid request body: Missing 'metric_name' field."
}

エラー（500 Internal Server Error）：

処理中に予期しないエラーが発生した場合に返されます。

{
  "status": "error",
  "message": "Internal server error."
}

設定

サーバーの設定は config.yaml で管理されます。利用可能なオプションについては、config.yaml ファイルを参照してください。