Heap Seance MCP server

Heap Seance is a helper for finding memory leaks in Java programs. It plugs into Claude Code and runs a set of standard Java tools for you, then tells you what it found and how sure it is. It is handy if you look after a Java service that slowly eats memory until it falls over.

What this MCP server does

You tell your AI which Java app to look at, by name or by process number. The AI calls this helper, and the helper runs the Java tools on that app to take snapshots of what is in memory and how often garbage collection is running. It can also record a JFR file, take a full heap dump, and run Eclipse MAT to find what is holding onto objects. Then it gives you back a verdict with a confidence level, the evidence it used, and suggested next steps. If the first pass looks weak, you can ask for a deeper investigation.

Click to zoom

What you can do with it

• List the Java programs running on your machine
• Take a snapshot of which classes have the most objects in memory
• Watch garbage collection over time to see if memory is under pressure
• Record a JFR file and summarize the events inside it
• Take a full heap dump for closer inspection
• Run Eclipse MAT to find likely leak suspects
• Profile where new objects are being allocated

Try asking your AI

• “Scan my-service for a memory leak”
• “Do a deep leak investigation on process 12345”
• “List the Java processes running right now”
• “Take a heap dump of my-service and run MAT on it”

What it gives back to you

You get a short report in the chat: a verdict, a confidence level like low or high, the key evidence, the suspect classes, and where any files were saved. Deep mode also suggests who is holding onto the objects and how you might fix it. The raw files, like .jfr and .hprof, are kept on disk so you or your team can look at them later.

Before you start

Who it's for

Java developers and anyone who has to keep a Java service running without it slowly running out of memory.