返回 MCP 目录
public公开dns本地运行

k6-mcp-server

k6负载测试工具的MCP协议服务端实现,提供数据接收和处理功能

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 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端