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.
English | 中文
Install
Requires Node.js 18+. No global install needed — run directly with npx:
npx -y sleuths-mcp
Or install globally:
npm install -g sleuths-mcp
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 |
|---|---|---|
analyze_thread_dump |
Thread dumps: deadlocks, state distribution, hot locks, top frames | ✅ MVP |
analyze_gc_log |
GC logs: Full GC frequency, memory pressure, pauses | 🚧 planned |
analyze_heap_histo |
Heap histogram: top classes, suspected leaks | 🚧 planned |
parse_exception_log |
Aggregated exceptions, root-cause chain | 🚧 planned |
Develop
npm install
npm run build
node dist/index.js