直接 java -jar org.eclipse.equinox.launcher_*.jar] 実行を使用して Eclipse MAT 用の Headless MCP サーバー。

##特徴

• [mat_healthcheck — MAT のランチャーと Java のランタイムの可用性を検証
• [mat_parse_report — 事前定義されたMATレポートを実行します(漏出疑惑、システム概要など)
• [mat_oql_query — OQL クエリを実行し、インライン結果を返す
• [mat_run_command — 56 の組み込み MAT 解析コマンド (ヒストグラム、dominator tree、path2gc、sread overview など) を実行します。
• [mat_index_status — MATインデックスがヒープダンプに存在するかどうかをチェック
• [[mat_oql_spec — OQLパーサガイドとサポートされているパターンを返す

サポートされているコマンド ([mat_run_command)

ドミネーターツリー分析

dominator_tree, show_dominator_tree, [immediate_dominators], [[big_drops_in_dominator_tree]]

##GC ルートへのパス [[T12], merge_shortest_paths, [gc_roots]]

ヒストグラム&オブジェクトリスト

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)