MCP.Market

Mat MCP server

by codelipenghui·io.github.codelipenghui/mcp-mat·v0.1.0·25 stars
No reviews yet

Headless Eclipse MAT MCP server for Java heap dump analysis

B75/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B75/100

full report

Adoption
Growing

25 stars50 downloads/wk

Reviews

Write one

Nobody has reviewed Mat yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Mat tools (6, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • mat_healthcheck

    Validate MAT launcher and Java runtime availability.

  • mat_index_status

    Report whether MAT index artifacts already exist for a heap dump.

  • mat_oql_querywrite action

    Execute a single MAT OQL query and return result artifacts.

  • mat_oql_spec

    Return MAT OQL parser-mode guidance, supported patterns, and known limitations.

  • mat_parse_reportwrite action

    Run a predefined MAT report headlessly and return generated artifacts.

  • mat_run_commandwrite action

    Execute a named MAT analysis command headlessly and return result artifacts.

Public scan report

scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan41 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 193 days ago4/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Mat compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
75/100
higher than 45% of 48,255 servers
Tools
6
the typical server has 7
Tools that change things
50%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
25
more than 91% of 28,688 servers
Downloads a week
50
more than 42% of 12,191 servers with a package

What its tools let an agent do: 3 read · 3 change

Install Mat in Claude Code, Cursor or VS Code

Runs npx -y mcp-mat on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-mat -- npx -y mcp-mat
Add to Cursor

What the publisher says

From the Mat repository's README, as published. We do not edit it. Read it on GitHub

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 availability
  • matparsereport — Run predefined MAT reports (leak suspects, system overview, etc.)
  • matoqlquery — Execute OQL queries and return inline results
  • matruncommand — Execute 56 built-in MAT analysis commands (histogram, dominatortree, path2gc, threadoverview, etc.)
  • matindexstatus — Check whether MAT index artifacts exist for a heap dump
  • matoqlspec — Return OQL parser guidance and supported patterns

Supported Commands (matruncommand)

Dominator tree analysis

dominatortree, showdominatortree, immediatedominators, bigdropsindominatortree

Path to GC roots

path2gc, mergeshortestpaths, gc_roots

Histogram & object listing

histogram, deltahistogram, listobjects, groupbyvalue, duplicateclasses

Leak detection

leakhunter, leakhunter2, findleaks, findleaks2, reference_leak

Thread analysis

threadoverview, threaddetails, thread_stack

Collection analysis

collectionfillratio, collectionsgroupedbysize, arrayfillratio, arraysgroupedbysize, hashentries, mapcollisionratio, extractlistvalues, hashsetvalues, primitivearrayswithaconstantvalue

Reference analysis

referencesstatistics, weakreferencesstatistics, softreferencesstatistics, phantomreferencesstatistics, finalizerreferences_statistics

Finalizer analysis

finalizeroverview, finalizerthread, finalizerqueue, finalizerinprocessing, finalizerthread_locals

Retained set

showretainedset, customizedretainedset

Component & top consumers

componentreport, componentreporttop, topconsumers, topconsumershtml, piebiggestobjects

String & memory waste

findstrings, wasteinchararrays

Heap info & misc

heapdumpoverview, unreachableobjects, systemproperties, classreferences, comparisonreport*

Eclipse/OSGi specific

bundleregistry, leakingbundles

Export

export_hprof

\* Requires a baseline heap dump (second .hprof file).

OQL mode notes

  • This server normalizes client OQL input and wraps it for MAT parse-app command mode.
  • You can send OQL with or without outer quotes.
  • For class ranking and top consumers, prefer matparsereport with org.eclipse.mat.api:overview and parse ClassHistogram.txt.
  • For object inspection, use simple field-level OQL patterns (INSTANCEOF, OBJECTS 0x...).

Environment

All environment variables are optional:

  • MAT_HOME
  • MAT_LAUNCHER
  • JAVA_PATH (default java)
  • MATXMXMB (default 4096)
  • MATTIMEOUTSEC (default 1800)
  • MATCONFIGDIR (default /tmp/mat-config)
  • MATDATADIR (default /tmp/mat-workspace)
  • MAT_DEBUG (default false)
  • MATDEBUGLOG_DIR (default /tmp/mcp-mat-logs)
  • MATPRIVACYMODE (default false)
  • MATOQLMAX_BYTES (default 16384)
  • MATRESULTPREVIEW_LINES (default 20)

Run

npm install
npm run build
MAT_HOME=/path/to/mat node dist/src/server.js

Test

npm test

Install via npx

No build step required. Install directly from npm:

Claude Code

Add to ~/.claude/settings.json or project .claude/settings.json:

{
  "mcpServers": {
    "mat": {
      "command": "npx",
      "args": ["-y", "mcp-mat"],
      "env": {
        "MAT_HOME": "/Applications/MemoryAnalyzer.app/Contents/Eclipse"
      }
    }
  }
}

Codex

codex mcp add \
  --env MAT_HOME=/Applications/MemoryAnalyzer.app/Contents/Eclipse \
  mat \
  npx -y mcp-mat

Install in Claude Code (from source)

Add the MCP server to Claude Code settings (~/.claude/settings.json or project .claude/settings.json):

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Mat: common questions

Is Mat MCP server safe?
Mostly: it is graded B (75/100). Read the Mat safety report
How do I install Mat?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Mat need an API key?
No secret keys are declared. It reads 3 settings from the environment.
Is Mat maintained?
The last commit was 230 days ago (2026-03-19). The latest release is v0.1.0.
How does Mat compare with other MCP servers?
safety score 75/100 (higher than 45% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.