JinDaGe - k6-mcp-server MCP Details

article

README

🚀 k6 - mcp 服务器重构

本项目致力于再现 k6 - mcp 服务器的核心事件驱动和基于插件架构的 Model Context Protocol (MCP)。它提供了一个服务器，可接收并处理来自 k6 加载测试工具的数据，可作为中心协调点或数据聚合服务，为测试数据的管理和处理提供便利。

🚀 快速开始

本项目旨在构建一个可接收并处理 k6 加载测试工具数据的服务器，若你有相关测试数据处理需求，可借助此项目开展工作。

📚 详细文档

🔍 API 文档

该服务器暴露了一个 API 端点来接收来自 k6 的数据。以下描述了预期的请求格式和服务器响应。

端点

POST /data

请求

标头:

Content-Type: application/json

正文（JSON 示例）：

{
  "metric_name": "my_custom_metric",
  "value": 123.45,
  "timestamp": 1678886400,  // Unix 时间戳，单位为秒
  "tags": {
    "environment": "production",
    "region": "us-west-2"
  }
}

响应

成功（200 OK）：

{
  "status": "success",
  "message": "数据已接收并处理。"
}

错误（400 错误，无效请求）：如果请求正文无效或缺少必填字段，则返回此错误。响应正文将提供有关错误的详细信息。

{
  "status": "error",
  "message": "无效的请求正文：缺少 'metric_name' 字段。"
}

错误（500 内部服务器错误）：如果在处理过程中发生意外错误，则返回此错误。

{
  "status": "error",
  "message": "内部服务器错误。"
}

⚙️ 配置

服务器的配置通过 config.yaml 文件管理。有关可用选项，请参阅 config.yaml 文件。

k6-mcp-server