🚀 JMeter MCP 服务器
这是一个支持 Model Context Protocol (MCP) 的服务器，允许通过 MCP 兼容客户端执行 JMeter 测试，为 JMeter 测试的执行提供了便捷的途径。
⚠️ 重要提示
📢 寻找集成在 JMeter 中的 AI 助手吗？🚀 查看 Feather Wand
✨ 主要特性
- 📊 在非 GUI 模式下执行 JMeter 测试
- 🖥️ 启动 JMeter 的 GUI 模式
- 📝 捕获并返回执行输出
📦 安装指南
本地安装
- 安装
uv。 - 确保 JMeter 已安装在系统上并且可通过命令行访问。
⚠️ 重要提示
确保 JMeter 可执行。你可以通过运行以下命令来实现：
chmod +x /path/to/jmeter/bin/jmeter
- 配置
.env文件，参考.env.example文件的详细信息。
# JMeter 配置
JMETER_HOME=/path/to/apache-jmeter-5.6.3
JMETER_BIN=${JMETER_HOME}/bin/jmeter
# 可选：JMeter Java 选项
JMETER_JAVA_OPTS="-Xms1g -Xmx2g"
💻 MCP 使用
- 使用一个 MCP 兼容客户端（例如，Claude Desktop、Cursor、Windsurf）连接到服务器。
- 发送提示到服务器：
运行 JMeter 测试 /path/to/test.jmx
- MCP 兼容客户端将使用以下工具：
- 🖥️
execute_jmeter_test：启动 JMeter 的 GUI 模式，但不会执行测试，因为这是 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 扩展名
- 捕获并返回任何执行错误