
Mcp Mat
Brings Eclipse Memory Analyzer Tool into your AI workflow through a headless server that wraps MAT's command-line interface. You get 56 built-in analysis commands covering dominator trees, GC root paths, leak detection, thread inspection, and collection fill ratios. The OQL query tool lets you write object queries directly, while predefined reports handle leak suspects and system overviews. Environment variables control heap size, timeouts, and workspace paths. Install via npx or build from source, point MAT_HOME at your Eclipse MAT installation, and you can analyze Java heap dumps without opening the GUI. Handy when you're debugging memory issues in chat and want programmatic access to histogram data, retained sets, or finalizer queues.
- GitHub stars
- 19
- tools
- 6
- transport
- STDIO
- env vars
- 3
- last updated
- Mar 19, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
mat_healthcheckValidate MAT launcher and Java runtime availability
Validate MAT launcher and Java runtime availability
No parameter schema in public metadata yet.
mat_parse_reportRun predefined MAT reports (leak suspects, system overview, etc.)
Run predefined MAT reports (leak suspects, system overview, etc.)
No parameter schema in public metadata yet.
mat_oql_queryExecute OQL queries and return inline results
Execute OQL queries and return inline results
No parameter schema in public metadata yet.
mat_run_commandExecute 56 built-in MAT analysis commands (histogram, dominator_tree, path2gc, thread_overview, etc.)
Execute 56 built-in MAT analysis commands (histogram, dominator_tree, path2gc, thread_overview, etc.)
No parameter schema in public metadata yet.
mat_index_statusCheck whether MAT index artifacts exist for a heap dump
Check whether MAT index artifacts exist for a heap dump
No parameter schema in public metadata yet.
mat_oql_specReturn OQL parser guidance and supported patterns
Return OQL parser guidance and supported patterns
No parameter schema in public metadata yet.
Sponsors
Configuration
MAT_HOMEPath to Eclipse MAT installation directory (e.g., /Applications/MemoryAnalyzer.app/Contents/Eclipse)
JAVA_PATHPath to Java executable (default: java)
MAT_XMX_MBMaximum JVM heap size in MB for MAT (default: 4096)
Readme
mcp-mat
Headless MCP server for Eclipse MAT using direct java -jar org.eclipse.equinox.launcher_*.jar execution.
Features
mat_healthcheck— Validate MAT launcher and Java runtime availabilitymat_parse_report— Run predefined MAT reports (leak suspects, system overview, etc.)mat_oql_query— Execute OQL queries and return inline resultsmat_run_command— Execute 56 built-in MAT analysis commands (histogram, dominator_tree, path2gc, thread_overview, etc.)mat_index_status— Check whether MAT index artifacts exist for a heap dumpmat_oql_spec— Return OQL parser guidance and supported patterns
Supported Commands (mat_run_command)
Dominator tree analysis
dominator_tree, show_dominator_tree, immediate_dominators, big_drops_in_dominator_tree
Path to GC roots
path2gc, merge_shortest_paths, gc_roots
Histogram & object listing
histogram, delta_histogram*, list_objects, group_by_value, duplicate_classes
Leak detection
leakhunter, leakhunter2, find_leaks, find_leaks2, reference_leak
Thread analysis
thread_overview, thread_details, thread_stack
Details
- Repository
- github.com/codelipenghui/mcp-mat
- Category
- Web & Browser Automation
- Package
mcp-mat- Transport
- STDIO
- Registry
- MCP registry, active