Skip to content

README.md

Latest commit

 

History

History
103 lines (74 loc) · 3.45 KB

README.md

File metadata and controls

103 lines (74 loc) · 3.45 KB

Fast Java Thread

Release

Cross-platform desktop application for analyzing Java thread dumps. Built with Tauri v2 and TypeScript.

Download

Pre-built binaries for Windows, macOS, and Linux are available on the Releases page.

Features

  • Open thread dump files (.tdump, .txt, .log) or drag-and-drop
  • Thread state distribution chart (pie chart)
  • Hot methods analysis
  • Deadlock detection with cycle visualization
  • Collapsible sidebar grouped by thread state
  • Thread detail view with full stack trace
  • Dark / Light theme toggle
  • MCP server with 5 analysis tools for AI assistant integration
  • Configurable MCP settings (transport, port, authentication)
  • Fully offline — no network access, no telemetry

Screenshots

app-image

MCP Integration

The app includes a built-in Model Context Protocol server that lets AI assistants analyze thread dumps directly.

Available tools

Tool Description
analyze_thread_dump Full analysis: thread states, hot methods, deadlocks
detect_deadlocks Find deadlock cycles with lock chain details
get_hot_methods Most frequent methods across all stack traces
get_thread_summary Thread count, state breakdown, JVM version
find_threads_by_method Search threads by method name or regex

Usage

  1. Click the MCP button in the toolbar to start the server
  2. Configure transport and port in Settings (gear icon)
  3. Connect your MCP client (e.g. Claude Code) to localhost:3100 (HTTP) or via stdio

For stdio mode, run the server directly:

npm run mcp:build
node lib/FastJavaThread/out/src/mcp/server.js

Note: MCP server requires Node.js 20+ installed on your machine.

Prerequisites

Windows

macOS

Linux

  • System packages: 
    sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf
  • Rust
  • Node.js 20+

Getting Started

git clone --recurse-submodules https://github.com/martin5211/FastJavaThread-app.git
cd FastJavaThread-app
npm install
npm run dev        # development mode with hot reload
npm run build      # production build
npm test           # run tests

Build Output

Platform Artifacts
Windows src-tauri/target/release/bundle/msi/*.msi, src-tauri/target/release/bundle/nsis/*.exe
macOS src-tauri/target/release/bundle/dmg/*.dmg
Linux src-tauri/target/release/bundle/deb/*.deb, src-tauri/target/release/bundle/appimage/*.AppImage

Architecture

The core parsing logic lives in the FastJavaThread git submodule at lib/FastJavaThread/. The desktop app imports directly from the submodule.

License

Eclipse Public License - v 2.0