🚀 JMeter MCP 服务器
这是一个模型上下文协议 (MCP) 服务器,允许通过 MCP 兼容客户端执行 JMeter 测试。
[!重要] 📢 正在寻找 JMeter 中的 AI 助手?🚀 看看Feather Wand



📋 功能
- 📊 以非 GUI 模式执行 JMeter 测试
- 🖥️ 以 GUI 模式启动 JMeter
- 📝 捕获并返回执行输出
🛠️ 安装
本地安装
- 安装
uv
: - 确保 JMeter 已安装在您的系统上并可通过命令行访问。
⚠️重要提示:请确保 JMeter 可执行。你可以运行以下命令来执行此操作:
chmod +x /path/to/jmeter/bin/jmeter
- 配置
.env
文件,具体参考.env.example
文件。
# JMeter Configuration
JMETER_HOME=/path/to/apache-jmeter-5.6.3
JMETER_BIN=${JMETER_HOME}/bin/jmeter
# Optional: JMeter Java options
JMETER_JAVA_OPTS="-Xms1g -Xmx2g"
💻 MCP 使用
- 使用 MCP 兼容客户端(例如 Claude Desktop、Cursor、Windsurf)连接到服务器
- 向服务器发送提示:
Run JMeter test /path/to/test.jmx
- MCP 兼容客户端将使用可用的工具:
execute_jmeter_test
:以 GUI 模式启动 JMeter,但不按照 JMeter 设计执行测试execute_jmeter_test_non_gui
:以非 GUI 模式执行 JMeter 测试(默认模式可获得更好的性能)
🏗️ MCP 配置
将以下配置添加到您的 MCP 客户端配置中:
{
"mcpServers": {
"jmeter": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/jmeter-mcp-server",
"run",
"jmeter_server.py"
]
}
}
}
✨ 用例
LLM 支持的结果分析:收集和分析测试结果。
调试:以非 GUI 模式执行测试进行调试。
🛑 错误处理
服务器将:
- 验证测试文件是否存在
- 检查文件是否具有 .jmx 扩展名
- 捕获并返回任何执行错误