Install the CLI

CLI usage

First run caches analysis (~1–15 min); subsequent runs load in ~1 s.

Claude Code (MCP server)

Add hprof-analyzer as an MCP tool so Claude can load and analyze heap dumps directly.

Then tell Claude: "Analyze the heap dump at /path/to/dump.hprof"

Claude will call get_session_info, load_dump, get_summary, and guide you through the investigation with OQL queries.

Cline / VS Code (MCP server)

In the Cline panel click MCP Servers → Add Server, or add directly to Cline's global MCP settings at ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json (Linux/macOS) or %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json (Windows):

{
  "mcpServers": {
    "hprof": {
      "command": "hprof-analyzer",
      "args": ["mcp"]
    }
  }
}

For a single dump session, pre-load with: "args": ["mcp", "--dump", "/path/to/dump.hprof"]

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "hprof": {
      "command": "hprof-analyzer",
      "args": ["mcp"]
    }
  }
}

Web browser (this page)

Drop any .hprof, .hprof.gz, or .hprof.zip file — up to 3 GB, analyzed entirely in-browser via WebAssembly. No upload, no server required.

For dumps above 3 GB, use the CLI or run hprof-analyzer server dump.hprof and connect this page to it.