PerfSage JMeter MCP - self-healing JMeter environments, auto-correlated scripts, adaptive workload discovery, and SLO-aware analysis for LLM agents
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"perfsage-jmeter-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
<p align="center"> <a href="./assets/readme/hero.svg"> <img src="./assets/readme/hero.gif" width="100%" alt="PerfSage JMeter MCP — your LLM becomes a performance engineer: heal, script, discover, verdict"> </a> </p> <p align="center"> <strong>Self-healing JMeter for LLM agents.</strong><br/> Heal the runtime · auto-correlate scripts · discover capacity · ship a <code>p95</code>/<code>p99</code> verdict. </p> <p align="center"> <a href="#-60-second-setup">🚀 Setup</a> · <a href="#-why-teams-reach-for-this">✨ Why</a> · <a href="#-how-it-works">🔁 Flow</a> · <a href="#-tools">🧰 Tools</a> · <a href="#-example-session">💬 Demo</a> · <a href="https://perfsage.com">🌐 PerfSage</a> </p> --- ## 🎯 What you get Stop wrestling with Java paths, broken plugins, and hand-written extractors. Point Cursor / Claude at this MCP server and ask for a performance test. It will: 1. **Heal** Java + Apache JMeter **5.6.3** + plugins under `~/.perfsage` (Docker fallback if needed) 2. **Import** HAR / OpenAPI / Postman traffic 3. **Auto-correlate** tokens, cookies, and IDs into JMeter variables 4. **Discover** the throughput knee when you don’t know the workload 5. **Report** a PASS / WARN / FAIL led by **p95 + p99** (never averages alone) > Analysis, not dashboards. Every run ends in a decision. --- ## ⚡ 60-second setup Requires **Python 3.10+**. Prefer [uv](https://docs.astral.sh/uv/) (macOS system `python3` is often 3.9; uv-managed Pythons also block bare `pip` via PEP 668). ```bash # try it (no install) uvx perfsage-jmeter-mcp --version uvx perfsage-jmeter-mcp ``` ```bash # install as a user tool (recommended) uv tool install perfsage-jmeter-mcp perfsage-jmeter-mcp --version ``` ```bash # or inside a project venv uv venv --python 3.12 source .venv/bin/activate # Windows: .venv\Scripts\activate uv pip install perfsage-jmeter-mcp ``` > **Do not** run `python3.12 -m pip install …` against a uv-managed interpreter — you’ll get `externally-managed-en…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.