🚀 ⚡️ k6-mcp-server

🚀 ⚡️ k6-mcp-server

site icon
2025.04.05 0
Python性能测试负载测试开发效率
k6-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务器实现,专门用于运行 k6 负载测试。它提供了简单的集成方式、可配置的测试参数以及实时测试执行输出,适用于需要进行性能测试和负载测试的开发场景。
View on GitHub

Overview

基本能力

产品定位

k6-mcp-server 是一个用于运行 k6 负载测试的 MCP 服务器实现,旨在简化性能测试的集成和执行过程。

核心功能

  • 与 Model Context Protocol 框架的简单集成
  • 支持自定义测试持续时间和虚拟用户 (VUs)
  • 提供易于使用的 API 来运行 k6 负载测试
  • 通过环境变量进行配置
  • 实时测试执行输出

适用场景

  • 开发过程中需要进行性能测试的场景
  • 需要自动化负载测试的 CI/CD 流程
  • 需要实时监控测试执行的开发环境

工具列表

  • execute_k6_test: 使用默认选项运行测试(30秒持续时间,10个虚拟用户)
  • execute_k6_test_with_options: 使用自定义持续时间和虚拟用户运行测试

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

在开始之前,请确保已安装以下依赖:

安装教程

  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  # 可选:默认为系统 PATH 中的 'k6'

调试方式

  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 服务器将利用以下工具之一启动测试。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。