sleuths-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sleuths-mcp analyze this thread dump for deadlocks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sleuths-mcp
A production-troubleshooting MCP server for AI agents. Turns thread dumps, GC logs and heap histograms into deterministic structured diagnostics (deadlocks, hot locks, bottleneck frames), so Cursor / Claude / Copilot pinpoint the problem directly — instead of hallucinating from raw logs.
▶ Live Demo · English · 中文
Install
Requires Node.js 18+. No global install needed — run directly with npx:
npx -y sleuths-mcpOr install globally:
npm install -g sleuths-mcpRelated MCP server: ThreadMine MCP Server
Setup with your AI client
Add sleuths to your MCP client (Cursor / Claude / Copilot):
{
"mcpServers": {
"sleuths": {
"command": "npx",
"args": ["-y", "sleuths-mcp"]
}
}
}Then just say: "analyze this thread dump".
Features
Deterministic parsing: no LLM hallucination; reproducible and testable
Standard MCP protocol: STDIO transport, works with Cursor / Claude / Copilot
Zero intrusion: only parses existing diagnostic artifacts; never attaches to your app
One-command install:
npx -y sleuths-mcp, no Java runtime required
Tools
Tool | Description | Status |
| Thread dumps: deadlocks, state distribution, hot locks, top frames | ✅ MVP |
| Exception aggregation: group by type, root-cause chain, count | ✅ MVP |
| GC logs: Young/Full counts, avg/max pause, memory trend | ✅ MVP |
| Heap histogram: top classes by bytes, suspected leaks | ✅ MVP |
Develop
npm install
npm run build
node dist/index.jsLicense
Available Tools
4 toolsanalyze_gc_logAnalyze GC LogB
Parse JVM GC logs and return: total GC events, Young/Full counts, average and max pause time, memory trend, and whether Full GC is frequent.
Inputs: logs (required).
analyze_heap_histoAnalyze Heap HistogramA
Parse jmap -histo output: top classes by bytes, total heap, and suspected application-level memory leaks (non-JDK classes taking >5% heap).
Inputs: histo (required).
analyze_thread_dumpAnalyze Thread DumpA
Parse a jstack / jcmd Thread.print thread dump text and return: total thread count, state distribution, deadlocked threads, hot locks, top frames.
Inputs: dump (required).
parse_exception_logParse Exception LogsA
Aggregate raw exception logs: group by exception type, count occurrences, extract root cause (Caused-by chain) and first frame. Returns a structured summary you can use to tell which error dominates and where it originates.
Inputs: logs (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct JVM diagnostic artifact: thread dumps, exception logs, GC logs, and heap histograms. There is no meaningful overlap in purpose, so an agent can select the right tool from the input type alone.
All names follow a consistent snake_case verb_noun pattern. The verbs alternate between analyze and parse, but both are semantically appropriate and the structure remains highly predictable.
Four tools is well-scoped for a focused JVM diagnostics server. Each tool covers a distinct and commonly needed artifact, so none feels redundant or out of place.
The surface covers the core JVM troubleshooting artifacts: thread dumps, exception aggregation, GC logs, and heap histograms. Minor gaps exist around heap dump analysis and JFR-style profiling, but the main diagnostic workflows are supported.
Maintenance
Related MCP Connectors
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
AI agent observability for production traces, natural-language insights, and improvement loops.
Ship better Java with your coding agent.
Finds what's broken in your product, explains why, and fixes it from your agent.
Related MCP Servers
- AlicenseAqualityCmaintenanceLive .NET runtime diagnostics for AI assistants. Ask Claude to diagnose memory leaks, GC pressure, LOH fragmentation, and thread starvation in any running .NET process — no code changes required.72MIT
- AlicenseAqualityCmaintenanceEnables analysis of JVM thread dumps to detect deadlocks, CPU spikes, pool exhaustion, and virtual thread pinning, returning a health score and interactive report link.286 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to analyze JVM thread dumps and GC logs, detecting deadlocks, lock contention, and GC pressure, without requiring a JVM runtime.740 npm2MIT
- AlicenseNot gradedqualityBmaintenanceLets AI agents diagnose and debug live Java applications by auto-discovering JVMs and attaching Arthas to run diagnostic commands like thread, trace, watch, and ognl.5MIT