用途
locust-mcp-server 是一个 Model Context Protocol (MCP) 服务器实现,用于运行 Locust 负载测试。它的目标是让 Locust 负载测试能力与 AI 驱动的开发环境实现无缝集成,使开发者可以通过 LLM 在支持的 MCP 客户端中直接触发并运行 Locust 负载测试。
主要能力
- 与 Model Context Protocol 框架简单集成
- 支持无头(headless)和 UI 两种模式
- 可配置测试参数:用户数(users)、生成速率(spawn_rate)、运行时长(runtime)
- 提供用于运行 Locust 负载测试的易用 API
- 实时测试执行输出
- 开箱即用地支持 HTTP/HTTPS 协议
- 支持自定义任务场景
- 借助 LLM 进行结果分析与调试
使用方式
- 前置条件:Python 3.13 或更高版本;uv 包管理器(需参考其安装指南)。
- 克隆仓库并安装所需依赖。
- 可选:在项目根目录创建 .env 文件设置环境变量。
- 创建一个 Locust 测试脚本(例如 hello.py)。
- 在常用的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等)中按给定规范配置该 MCP 服务器。
- 让 LLM 运行测试,例如提示“run locust test for hello.py”。Locust MCP 服务器会使用 run_locust 工具启动测试。
工具与参数
run_locust:以可配置选项运行测试,选项包括:
- test_file:Locust 测试脚本的路径
- headless:以无头模式(True)或带 UI 模式(False)运行
- host:要进行负载测试的目标主机
- runtime:测试持续时间(例如 "30s"、"1m"、"5m")
- users:要模拟的并发用户数
- spawn_rate:用户生成速率
适用场景
- 在 AI 驱动的开发环境中直接运行 Locust 负载测试
- 需要快速配置并执行 HTTP/HTTPS 负载测试的开发者与测试人员
- 希望借助 LLM 进行测试结果分析和调试的场景
限制与许可
本项目基于 MIT License 发布,详见 LICENSE 文件。欢迎提交 Pull Request 贡献代码。资料中未提供关于收费、价格、性能效果或具体平台支持范围的更多信息。