Skip to main content
Glama
threshbyte

sleuths-mcp

by threshbyte
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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

Related MCP server: mcp-dotnet-diagnostics

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

License

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • jdwp-mcp

    dronsv
    A
    license
    B
    quality
    C
    maintenance
    Сonnects to live JVMs via JDWP protocol, enabling LLM agents to autonomously debug Java applications — attach to a running process, pause threads, set breakpoints (including conditional), inspect stacks with auto-resolved object fields, evaluate methods, set variable values, and diagnose issues like deadlocks and hung queries.
    28
    1
    MIT

  • mcp-dotnet-diagnostics

    aayushmdesai
    A
    license
    A
    quality
    C
    maintenance
    Live .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.
    7
    2
    MIT

  • ThreadMine MCP Server

    maschiojv
    A
    license
    A
    quality
    D
    maintenance
    Enables analysis of JVM thread dumps to detect deadlocks, CPU spikes, pool exhaustion, and virtual thread pinning, returning a health score and interactive report link.
    2
    14 npm
    MIT