MCP Server (for Claude)

Overview

LoadDensity ships a Model Context Protocol server that exposes the framework as a set of MCP tools. With it, Claude (Desktop, Code, or any MCP client) can drive load tests, generate reports, import HAR files, and inspect persisted runs without leaving the chat.

Install

pip install "je_load_density[mcp]"

Run the server

python -m je_load_density.mcp_server

The server speaks MCP over stdio. Wire it into the client of your choice (Claude Desktop claude_desktop_config.json, Claude Code, etc.):

{
  "mcpServers": {
    "loaddensity": {
      "command": "python",
      "args": ["-m", "je_load_density.mcp_server"]
    }
  }
}

Exposed tools

Tool	Purpose
`load_density.run_test`	Run a Locust-backed load test (HTTP / WS / gRPC / MQTT / Socket).
`load_density.run_action_json`	Execute an action JSON document.
`load_density.create_project`	Scaffold a project skeleton at PATH.
`load_density.list_executor_commands`	List every `LD_*` command registered in the executor.
`load_density.import_har`	Convert a HAR file into a runnable action JSON.
`load_density.generate_reports`	Emit any combination of HTML / JSON / XML / CSV / JUnit / summary.
`load_density.summary`	Return aggregated stats (totals, per-name p50/p90/p95/p99).
`load_density.persist_records`	Save the current records into a SQLite database.
`load_density.list_runs`	List recent persisted runs.
`load_density.fetch_run`	Fetch records belonging to a saved run.
`load_density.clear_records`	Drop in-memory records before a new run.