직접 java -jar org.eclipse.equinox.launcher_*.jar 실행을 사용하여 Eclipse MAT에 대한 헤드리스 MCP 서버.

특징

• mat_healthcheck - MAT 런처 및 Java 런타임 가용성 검증
• mat_parse_report - 사전 정의 된 MAT 보고서 실행 (자신, 시스템 개요 등)
• mat_oql_query - OQL 쿼리 실행 및 반환 인라인 결과
• mat_run_command - 56 내장 MAT 분석 명령 실행 (histogram, dominator tree, path2gc, thread overview 등)
• mat_index_status - MAT 지수가 힙 덤프에 존재하는지 확인
• mat_oql_spec - OQL 파서 가이드 및 지원 패턴 반환

지원 명령 (mat_run_command)

Dominator 나무 분석

dominator_tree, show_dominator_tree], immediate_dominators], big_drops_in_dominator_tree]

GC 루트 경로

path2gc, merge_shortest_paths, gc_roots]

Histogram & 객체 목록

histogram, delta_histogram]*, list_objects, group_by_value], duplicate_classes]

누출 검출

leakhunter, leakhunter2], find_leaks], find_leaks2, reference_leak]

스레드 분석

thread_overview, thread_details, thread_stack]

컬렉션 분석

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
• mat_parse_report — Run predefined MAT reports (leak suspects, system overview, etc.)
• mat_oql_query — Execute OQL queries and return inline results
• mat_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 dump
• mat_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

Collection analysis

collection_fill_ratio, collections_grouped_by_size, array_fill_ratio, arrays_grouped_by_size, hash_entries, map_collision_ratio, extract_list_values, hash_set_values, primitive_arrays_with_a_constant_value

Reference analysis

references_statistics, weak_references_statistics, soft_references_statistics, phantom_references_statistics, finalizer_references_statistics

Finalizer analysis

finalizer_overview, finalizer_thread, finalizer_queue, finalizer_in_processing, finalizer_thread_locals

Retained set

show_retained_set, customized_retained_set

Component & top consumers

component_report, component_report_top, top_consumers, top_consumers_html, pie_biggest_objects

String & memory waste

find_strings, waste_in_char_arrays

Heap info & misc

heap_dump_overview, unreachable_objects, system_properties, class_references, comparison_report*

Eclipse/OSGi specific

bundle_registry, leaking_bundles

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 mat_parse_report with org.eclipse.mat.api:overview and parse Class_Histogram*.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)
• MAT_XMX_MB (default 4096)
• MAT_TIMEOUT_SEC (default 1800)
• MAT_CONFIG_DIR (default /tmp/mat-config)
• MAT_DATA_DIR (default /tmp/mat-workspace)
• MAT_DEBUG (default false)