# JVMind MAT Heap Dump Analyzer MCP server

> Analyze Java heap dumps using the Eclipse MAT engine to diagnose memory leaks, OOM errors, and connection pool issues via natural language.

- Repository: https://github.com/kengrary/web_mat_project
- Page: https://hostedmcp.org/servers/kengrary/web-mat-project
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.2.1

## Install

### Claude Code

```sh
claude mcp add web-mat-project -- uvx jvmind-mat-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "web-mat-project": {
      "command": "uvx",
      "args": [
        "jvmind-mat-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "web-mat-project": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "jvmind-mat-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"web-mat-project","type":"stdio","command":"uvx","args":["jvmind-mat-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "web-mat-project": {
      "command": "uvx",
      "args": [
        "jvmind-mat-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add web-mat-project -- uvx jvmind-mat-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.web-mat-project]
command = "uvx"
args = ["jvmind-mat-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user web-mat-project uvx -- jvmind-mat-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "web-mat-project": {
      "command": "uvx",
      "args": [
        "jvmind-mat-mcp"
      ]
    }
  }
}
```

## Tools (19)

- `open_heapdump`
- `get_heapdump_status`
- `list_heapdumps`
- `close_heapdump`
- `list_java_processes`
- `dump_java_heap`
- `mat_overview`
- `mat_histogram`
- `mat_dominator`
- `mat_threads`
- `mat_threadlocals`
- `mat_object`
- `mat_path2gc`
- `mat_oql`
- `mat_leak_suspects`
- `mat_diagnose_oom`
- `mat_connection_pools`
- `mat_top_consumers`
- `mat_sql_in_threads`

## FAQ

### Can I capture a live heap dump from a running JVM?

Yes, the server can discover local Java processes and capture a live heap dump using jmap.

### Do my heap dumps leave my machine?

No, heap dumps never leave your machine; the MAT helper is bound to 127.0.0.1 only.

### What are the system requirements for this server?

You need Python 3.10+, JDK 21+, and Eclipse MAT 1.17.x installed.
