mcp-mat 0.1.0

package/dist/src/tools/schemas.d.ts

@@ -0,0 +1,231 @@
+import { z } from "zod";
+export declare const matHealthcheckSchema: z.ZodObject<{
+    mat_home: z.ZodOptional<z.ZodString>;
+    java_path: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    mat_home?: string | undefined;
+    java_path?: string | undefined;
+}, {
+    mat_home?: string | undefined;
+    java_path?: string | undefined;
+}>;
+export declare const matParseReportSchema: z.ZodObject<{
+    heap_path: z.ZodString;
+    report_id: z.ZodString;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    xmx_mb: z.ZodOptional<z.ZodNumber>;
+    timeout_sec: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    heap_path: string;
+    report_id: string;
+    options?: Record<string, string | number | boolean> | undefined;
+    xmx_mb?: number | undefined;
+    timeout_sec?: number | undefined;
+}, {
+    heap_path: string;
+    report_id: string;
+    options?: Record<string, string | number | boolean> | undefined;
+    xmx_mb?: number | undefined;
+    timeout_sec?: number | undefined;
+}>;
+export declare const matOqlQuerySchema: z.ZodObject<{
+    heap_path: z.ZodString;
+    oql: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<["txt", "html", "csv"]>>;
+    unzip: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    xmx_mb: z.ZodOptional<z.ZodNumber>;
+    timeout_sec: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    heap_path: string;
+    oql: string;
+    xmx_mb?: number | undefined;
+    timeout_sec?: number | undefined;
+    limit?: number | undefined;
+    format?: "txt" | "html" | "csv" | undefined;
+    unzip?: boolean | undefined;
+}, {
+    heap_path: string;
+    oql: string;
+    xmx_mb?: number | undefined;
+    timeout_sec?: number | undefined;
+    limit?: number | undefined;
+    format?: "txt" | "html" | "csv" | undefined;
+    unzip?: boolean | undefined;
+}>;
+export declare const matIndexStatusSchema: z.ZodObject<{
+    heap_path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    heap_path: string;
+}, {
+    heap_path: string;
+}>;
+export declare const matRunCommandSchema: z.ZodObject<{
+    heap_path: z.ZodString;
+    command_name: z.ZodString;
+    command_args: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<["txt", "html", "csv"]>>;
+    unzip: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    xmx_mb: z.ZodOptional<z.ZodNumber>;
+    timeout_sec: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    heap_path: string;
+    command_name: string;
+    xmx_mb?: number | undefined;
+    timeout_sec?: number | undefined;
+    limit?: number | undefined;
+    format?: "txt" | "html" | "csv" | undefined;
+    unzip?: boolean | undefined;
+    command_args?: string | undefined;
+}, {
+    heap_path: string;
+    command_name: string;
+    xmx_mb?: number | undefined;
+    timeout_sec?: number | undefined;
+    limit?: number | undefined;
+    format?: "txt" | "html" | "csv" | undefined;
+    unzip?: boolean | undefined;
+    command_args?: string | undefined;
+}>;
+export declare const matOqlSpecSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export declare const toolDefinitions: readonly [{
+    readonly name: "mat_healthcheck";
+    readonly description: "Validate MAT launcher and Java runtime availability.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly mat_home: {
+                readonly type: "string";
+            };
+            readonly java_path: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "mat_parse_report";
+    readonly description: "Run a predefined MAT report headlessly and return generated artifacts.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["heap_path", "report_id"];
+        readonly properties: {
+            readonly heap_path: {
+                readonly type: "string";
+            };
+            readonly report_id: {
+                readonly type: "string";
+            };
+            readonly options: {
+                readonly type: "object";
+                readonly additionalProperties: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                    }, {
+                        readonly type: "number";
+                    }, {
+                        readonly type: "boolean";
+                    }];
+                };
+            };
+            readonly xmx_mb: {
+                readonly type: "integer";
+            };
+            readonly timeout_sec: {
+                readonly type: "integer";
+            };
+        };
+    };
+}, {
+    readonly name: "mat_oql_query";
+    readonly description: "Execute a single MAT OQL query and return result artifacts.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["heap_path", "oql"];
+        readonly properties: {
+            readonly heap_path: {
+                readonly type: "string";
+            };
+            readonly oql: {
+                readonly type: "string";
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["txt", "html", "csv"];
+            };
+            readonly unzip: {
+                readonly type: "boolean";
+            };
+            readonly limit: {
+                readonly type: "integer";
+            };
+            readonly xmx_mb: {
+                readonly type: "integer";
+            };
+            readonly timeout_sec: {
+                readonly type: "integer";
+            };
+        };
+    };
+}, {
+    readonly name: "mat_index_status";
+    readonly description: "Report whether MAT index artifacts already exist for a heap dump.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["heap_path"];
+        readonly properties: {
+            readonly heap_path: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "mat_run_command";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["heap_path", "command_name"];
+        readonly properties: {
+            readonly heap_path: {
+                readonly type: "string";
+            };
+            readonly command_name: {
+                readonly type: "string";
+                readonly description: string;
+            };
+            readonly command_args: {
+                readonly type: "string";
+                readonly description: string;
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["txt", "html", "csv"];
+            };
+            readonly unzip: {
+                readonly type: "boolean";
+            };
+            readonly limit: {
+                readonly type: "integer";
+            };
+            readonly xmx_mb: {
+                readonly type: "integer";
+            };
+            readonly timeout_sec: {
+                readonly type: "integer";
+            };
+        };
+    };
+}, {
+    readonly name: "mat_oql_spec";
+    readonly description: "Return MAT OQL parser-mode guidance, supported patterns, and known limitations.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {};
+    };
+}];

package/dist/src/tools/schemas.js

@@ -0,0 +1,165 @@
+// Copyright 2025 Penghui Li
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { z } from "zod";
+const optionValueSchema = z.union([z.string(), z.number(), z.boolean()]);
+export const matHealthcheckSchema = z
+    .object({
+    mat_home: z.string().optional(),
+    java_path: z.string().optional(),
+})
+    .strict();
+export const matParseReportSchema = z
+    .object({
+    heap_path: z.string().min(1),
+    report_id: z.string().min(1),
+    options: z.record(optionValueSchema).optional(),
+    xmx_mb: z.number().int().optional(),
+    timeout_sec: z.number().int().optional(),
+})
+    .strict();
+export const matOqlQuerySchema = z
+    .object({
+    heap_path: z.string().min(1),
+    oql: z.string().min(1),
+    format: z.enum(["txt", "html", "csv"]).optional(),
+    unzip: z.boolean().optional(),
+    limit: z.number().int().optional(),
+    xmx_mb: z.number().int().optional(),
+    timeout_sec: z.number().int().optional(),
+})
+    .strict();
+export const matIndexStatusSchema = z
+    .object({
+    heap_path: z.string().min(1),
+})
+    .strict();
+export const matRunCommandSchema = z
+    .object({
+    heap_path: z.string().min(1),
+    command_name: z.string().min(1),
+    command_args: z.string().optional(),
+    format: z.enum(["txt", "html", "csv"]).optional(),
+    unzip: z.boolean().optional(),
+    limit: z.number().int().optional(),
+    xmx_mb: z.number().int().optional(),
+    timeout_sec: z.number().int().optional(),
+})
+    .strict();
+export const matOqlSpecSchema = z.object({}).strict();
+export const toolDefinitions = [
+    {
+        name: "mat_healthcheck",
+        description: "Validate MAT launcher and Java runtime availability.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                mat_home: { type: "string" },
+                java_path: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "mat_parse_report",
+        description: "Run a predefined MAT report headlessly and return generated artifacts.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["heap_path", "report_id"],
+            properties: {
+                heap_path: { type: "string" },
+                report_id: { type: "string" },
+                options: {
+                    type: "object",
+                    additionalProperties: {
+                        anyOf: [{ type: "string" }, { type: "number" }, { type: "boolean" }],
+                    },
+                },
+                xmx_mb: { type: "integer" },
+                timeout_sec: { type: "integer" },
+            },
+        },
+    },
+    {
+        name: "mat_oql_query",
+        description: "Execute a single MAT OQL query and return result artifacts.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["heap_path", "oql"],
+            properties: {
+                heap_path: { type: "string" },
+                oql: { type: "string" },
+                format: { type: "string", enum: ["txt", "html", "csv"] },
+                unzip: { type: "boolean" },
+                limit: { type: "integer" },
+                xmx_mb: { type: "integer" },
+                timeout_sec: { type: "integer" },
+            },
+        },
+    },
+    {
+        name: "mat_index_status",
+        description: "Report whether MAT index artifacts already exist for a heap dump.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["heap_path"],
+            properties: {
+                heap_path: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "mat_run_command",
+        description: "Execute a named MAT analysis command headlessly and return result artifacts. " +
+            "Supports 56 built-in commands including: dominator_tree, path2gc, merge_shortest_paths, " +
+            "histogram, thread_overview, thread_details, collection_fill_ratio, gc_roots, " +
+            "find_strings, component_report, system_properties, and many more. " +
+            "Use mat_oql_query for OQL queries instead.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["heap_path", "command_name"],
+            properties: {
+                heap_path: { type: "string" },
+                command_name: {
+                    type: "string",
+                    description: "MAT command name, e.g. histogram, dominator_tree, path2gc, thread_overview, " +
+                        "collection_fill_ratio, gc_roots, find_strings, etc.",
+                },
+                command_args: {
+                    type: "string",
+                    description: "Optional arguments for the command. Format depends on the command, e.g. " +
+                        "an object address like '0x12345678' for path2gc, or a class pattern for histogram.",
+                },
+                format: { type: "string", enum: ["txt", "html", "csv"] },
+                unzip: { type: "boolean" },
+                limit: { type: "integer" },
+                xmx_mb: { type: "integer" },
+                timeout_sec: { type: "integer" },
+            },
+        },
+    },
+    {
+        name: "mat_oql_spec",
+        description: "Return MAT OQL parser-mode guidance, supported patterns, and known limitations.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {},
+        },
+    },
+];
+//# sourceMappingURL=schemas.js.map

package/dist/src/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,102 @@
+export type MatErrorCategory = "MAT_NOT_FOUND" | "HEAP_NOT_FOUND" | "WRITE_PERMISSION_DENIED" | "MAT_PARSE_FAILED" | "MAT_TIMEOUT" | "INVALID_QUERY";
+export interface MatErrorResponse {
+    status: "error";
+    category: MatErrorCategory;
+    message: string;
+    hint: string;
+    stdout_tail: string;
+    stderr_tail: string;
+    exit_code: number | null;
+}
+export interface RunCommand {
+    command: string;
+    args: string[];
+    timeoutSec: number;
+    maxBufferChars?: number;
+}
+export interface RunResult {
+    command: string;
+    args: string[];
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    timedOut: boolean;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+}
+export interface MatParseReportSuccess {
+    status: "ok";
+    exit_code: number;
+    report_dir: string | null;
+    report_zip: string | null;
+    generated_files: string[];
+    stdout_tail: string;
+    stderr_tail: string;
+}
+export interface MatOqlQuerySuccess {
+    status: "ok";
+    exit_code: number;
+    query_dir: string | null;
+    query_zip: string | null;
+    result_txt: string | null;
+    result_preview: string[];
+    generated_files: string[];
+    stdout_tail: string;
+    stderr_tail: string;
+}
+export interface MatHealthcheckSuccess {
+    status: "ok";
+    ok: true;
+    mat_launcher: string;
+    java_version: string;
+    notes: string[];
+}
+export interface MatIndexStatusSuccess {
+    status: "ok";
+    index_present: boolean;
+    index_files: string[];
+    threads_file: string | null;
+    last_modified: string | null;
+}
+export interface MatOqlSpecSuccess {
+    status: "ok";
+    parser_mode: string;
+    command_format: string;
+    client_input_rules: string[];
+    supported_patterns: Array<{
+        name: string;
+        query: string;
+        description: string;
+    }>;
+    unsupported_patterns: string[];
+    notes: string[];
+}
+export interface MatRunCommandSuccess {
+    status: "ok";
+    exit_code: number;
+    command_name: string;
+    query_dir: string | null;
+    query_zip: string | null;
+    result_txt: string | null;
+    result_preview: string[];
+    generated_files: string[];
+    stdout_tail: string;
+    stderr_tail: string;
+}
+export type ToolResponse = MatHealthcheckSuccess | MatParseReportSuccess | MatOqlQuerySuccess | MatIndexStatusSuccess | MatOqlSpecSuccess | MatRunCommandSuccess | MatErrorResponse;
+export declare class MatMcpError extends Error {
+    readonly category: MatErrorCategory;
+    readonly hint: string;
+    readonly stdoutTail: string;
+    readonly stderrTail: string;
+    readonly exitCode: number | null;
+    constructor(params: {
+        category: MatErrorCategory;
+        message: string;
+        hint: string;
+        stdoutTail?: string;
+        stderrTail?: string;
+        exitCode?: number | null;
+    });
+    toResponse(): MatErrorResponse;
+}

package/dist/src/types.js

@@ -0,0 +1,41 @@
+// Copyright 2025 Penghui Li
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export class MatMcpError extends Error {
+    category;
+    hint;
+    stdoutTail;
+    stderrTail;
+    exitCode;
+    constructor(params) {
+        super(params.message);
+        this.name = "MatMcpError";
+        this.category = params.category;
+        this.hint = params.hint;
+        this.stdoutTail = params.stdoutTail ?? "";
+        this.stderrTail = params.stderrTail ?? "";
+        this.exitCode = params.exitCode ?? null;
+    }
+    toResponse() {
+        return {
+            status: "error",
+            category: this.category,
+            message: this.message,
+            hint: this.hint,
+            stdout_tail: this.stdoutTail,
+            stderr_tail: this.stderrTail,
+            exit_code: this.exitCode,
+        };
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAgHjC,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,QAAQ,CAAmB;IAC3B,IAAI,CAAS;IACb,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,QAAQ,CAAgB;IAExC,YAAY,MAOX;QACC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,UAAU;QACR,OAAO;YACL,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,SAAS,EAAE,IAAI,CAAC,QAAQ;SACzB,CAAC;IACJ,CAAC;CACF"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "mcp-mat",
+  "version": "0.1.0",
+  "description": "Headless Eclipse MAT MCP server",
+  "mcpName": "io.github.codelipenghui/mcp-mat",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/src/server.js",
+  "bin": {
+    "mcp-mat": "dist/src/server.js"
+  },
+  "files": [
+    "dist/src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codelipenghui/mcp-mat.git"
+  },
+  "keywords": [
+    "mcp",
+    "eclipse-mat",
+    "heap-dump",
+    "memory-analysis",
+    "java"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/server.ts",
+    "start": "node dist/src/server.js",
+    "test": "tsx --test test/**/*.test.ts",
+    "prepublishOnly": "npm run build && node scripts/prepublish.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}