Thread Dump Analyzer
TDA - Thread Dump Analyzer (for Java). Analyze your Thread Dumps with a GUI or use it as MCP Server.
What is Thread Dump Analyzer?
Thread Dump Analyzer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to tda - thread dump analyzer (for java). analyze your thread dumps with a gui or use it as mcp server.
TDA - Thread Dump Analyzer (for Java). Analyze your Thread Dumps with a GUI or use it as MCP Server.
This server falls under the Monitoring & Observability category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- TDA - Thread Dump Analyzer (for Java). Analyze your Thread D
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx tdaConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Thread Dump Analyzer
TDA (Thread Dump Analyzer) is a Java tool for analyzing JVM thread dumps that exposes its analysis capabilities as an MCP server, letting AI assistants parse, summarize, and diagnose thread dump log files through conversation. It detects deadlocks, identifies long-running and zombie threads, analyzes virtual thread carrier pinning, and provides structured summaries — saving Java developers the time of manually reading thousands of thread stack traces when debugging performance issues or production incidents.
Prerequisites
- Java 17 or later installed and on your PATH
- The TDA jar file downloaded from the GitHub releases page
- An MCP client such as Claude Desktop
- Java thread dump log files to analyze (generated by jstack, jcmd, or your application server)
Download the TDA jar
Download the latest tda.jar from the GitHub releases page at https://github.com/irockel/tda/releases.
Test TDA as an MCP server from the command line
Run TDA in headless MCP mode to verify it starts without errors. The -Djava.awt.headless=true flag is mandatory — it prevents TDA from trying to open a GUI window.
java -Djava.awt.headless=true -jar /path/to/tda.jar --mcpConfigure Claude Desktop
Add the TDA MCP server block to your Claude Desktop configuration file, using the absolute path to your tda.jar.
{
"mcpServers": {
"tda": {
"command": "java",
"args": [
"-Djava.awt.headless=true",
"-jar",
"/absolute/path/to/tda.jar",
"--mcp"
]
}
}
}Increase heap for large thread dumps
Production thread dumps with thousands of threads can be large. Add a heap size flag if you get OutOfMemoryError.
{
"mcpServers": {
"tda": {
"command": "java",
"args": [
"-Xmx2g",
"-Djava.awt.headless=true",
"-jar",
"/absolute/path/to/tda.jar",
"--mcp"
]
}
}
}Parse a thread dump and get a summary
Ask Claude to parse a thread dump log file using its absolute path. Then request a summary, deadlock check, or long-running thread analysis.
Thread Dump Analyzer Examples
Client configuration
Claude Desktop config block for TDA in headless MCP mode.
{
"mcpServers": {
"tda": {
"command": "java",
"args": [
"-Djava.awt.headless=true",
"-jar",
"/Users/you/tools/tda.jar",
"--mcp"
]
}
}
}Prompts to try
Example queries for analyzing Java thread dumps.
- "Parse the thread dump at /var/log/myapp/threaddump.log and give me a summary"
- "Are there any deadlocks in the parsed thread dump?"
- "Which threads have been running the longest without changing state?"
- "Check for virtual thread carrier pinning issues in this dump"
- "List all threads currently in native methods from dump index 0"Troubleshooting Thread Dump Analyzer
TDA fails to start with 'headless environment' error or opens a GUI window
You must include -Djava.awt.headless=true in the java args. Without this flag TDA attempts to open its Swing GUI, which fails in a server/MCP context. Double-check that the flag appears before -jar in the args list.
parse_log returns an error about file not found
Always use absolute paths when calling parse_log. Relative paths are resolved from TDA's working directory, which may differ from where you expect. Also ensure the MCP server process has read permission on the log file.
OutOfMemoryError when parsing large thread dump files
Add -Xmx2g (or larger) to the java args in your MCP config to give TDA more heap space. Production thread dumps from large JVM processes can easily exceed 100 MB when fully parsed.
Frequently Asked Questions about Thread Dump Analyzer
What is Thread Dump Analyzer?
Thread Dump Analyzer is a Model Context Protocol (MCP) server that tda - thread dump analyzer (for java). analyze your thread dumps with a gui or use it as mcp server. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Thread Dump Analyzer?
Follow the installation instructions on the Thread Dump Analyzer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Thread Dump Analyzer?
Thread Dump Analyzer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Thread Dump Analyzer free to use?
Yes, Thread Dump Analyzer is open source and available under the LGPL-2.1 license. You can use it freely in both personal and commercial projects.
Thread Dump Analyzer Alternatives — Similar Monitoring & Observability Servers
Looking for alternatives to Thread Dump Analyzer? Here are other popular monitoring & observability servers you can use with Claude, Cursor, and VS Code.
Netdata
★ 78.9kReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Kubeshark
★ 11.9keBPF-powered network observability for Kubernetes. Indexes L4/L7 traffic with full K8s context, decrypts TLS without keys. Queryable by AI agents via MCP and humans via dashboard.
Mission Control
★ 4.9kSelf-hosted AI agent orchestration platform: dispatch tasks, run multi-agent workflows, monitor spend, and govern operations from one mission control dashboard.
Grafana
★ 3.0kThis MCP server enables natural-language querying of Grafana logs by automatically detecting log sources and service labels. It provides read-only access to log data with intelligent caching for efficient repeat queries.
Sentrux
★ 2.4kReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.
OpenInference
★ 986OpenTelemetry Instrumentation for AI Observability
Browse More Monitoring & Observability MCP Servers
Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Thread Dump Analyzer in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Thread Dump Analyzer?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.