mcp-jvm-diagnostics 0.1.2 → 0.1.4

package/README.md

@@ -9,7 +9,7 @@ A Model Context Protocol (MCP) server that gives AI assistants the ability to an
 
 JVM diagnostic MCP servers exist (TDA, jfr-mcp, Arthas) — but they're all **Java-based**, requiring a JVM runtime just to diagnose JVM problems. This tool runs on **Node.js** via `npx` — no JVM, no Docker, no SSH.
 
-It analyzes **offline** artifacts (thread dumps, GC logs, heap histograms) rather than requiring a running JVM. Paste a thread dump or GC log and get instant analysis. Part of the [MCP Java Backend Suite](https://www.npmjs.com/package/mcp-java-backend-suite) — 5 tools covering databases, JVM, migrations, Spring Boot, and Redis for Java backend developers.
+It analyzes **offline** artifacts (thread dumps, GC logs, heap histograms) rather than requiring a running JVM. Paste a thread dump or GC log and get instant analysis.
 
 ## Features
 
@@ -160,6 +160,13 @@ Add these JVM flags to your application:
 - **HotSpot/OpenJDK only**: Parser targets HotSpot/OpenJDK thread dump format. GraalVM native-image or Eclipse OpenJ9 dumps may parse incompletely.
 - **Classloader leak detection**: Heap analysis flags growing ClassLoader instances but cannot definitively prove a leak without memory profiler data.
 
+## Part of the MCP Java Backend Suite
+
+- [mcp-db-analyzer](https://www.npmjs.com/package/mcp-db-analyzer) — PostgreSQL/MySQL/SQLite schema analysis
+- [mcp-spring-boot-actuator](https://www.npmjs.com/package/mcp-spring-boot-actuator) — Spring Boot health, metrics, and bean analysis
+- [mcp-redis-diagnostics](https://www.npmjs.com/package/mcp-redis-diagnostics) — Redis memory, slowlog, and client diagnostics
+- [mcp-migration-advisor](https://www.npmjs.com/package/mcp-migration-advisor) — Flyway/Liquibase migration risk analysis
+
 ## License
 
 MIT

package/build/index.js

@@ -10,12 +10,9 @@ import { analyzeGcPressure } from "./analyzers/gc-pressure.js";
 import { parseHeapHisto } from "./parsers/heap-histo.js";
 import { compareHeapHistos } from "./analyzers/heap-diff.js";
 import { parseJfrSummary } from "./parsers/jfr-summary.js";
-import { validateLicense, formatUpgradePrompt } from "./license.js";
-// License check (reads MCP_LICENSE_KEY env var once at startup)
-const license = validateLicense(process.env.MCP_LICENSE_KEY, "jvm-diagnostics");
 // Handle --help
 if (process.argv.includes("--help") || process.argv.includes("-h")) {
-    console.log(`mcp-jvm-diagnostics v0.1.0 — MCP server for JVM diagnostics
+    console.log(`mcp-jvm-diagnostics v0.1.4 — MCP server for JVM diagnostics
 
 Usage:
   mcp-jvm-diagnostics [options]
@@ -34,7 +31,7 @@ Tools provided:
 }
 const server = new McpServer({
     name: "mcp-jvm-diagnostics",
-    version: "0.1.0",
+    version: "0.1.4",
 });
 // --- Tool: analyze_thread_dump ---
 server.tool("analyze_thread_dump", "Parse a JVM thread dump (jstack output) and analyze thread states, detect deadlocks, identify lock contention hotspots, and find thread starvation patterns.", {
@@ -240,18 +237,6 @@ server.tool("compare_heap_histos", "Compare two jmap -histo snapshots taken at d
         .string()
         .describe("The SECOND (later) jmap -histo output"),
 }, async ({ before, after }) => {
-    if (!license.isPro) {
-        return {
-            content: [{
-                    type: "text",
-                    text: formatUpgradePrompt("compare_heap_histos", "Heap histogram comparison with:\n" +
-                        "- Memory growth pattern detection between snapshots\n" +
-                        "- Leak candidate identification\n" +
-                        "- New class allocation tracking\n" +
-                        "- Shrinking class analysis"),
-                }],
-        };
-    }
     try {
         const report = compareHeapHistos(before, after);
         const sections = [];
@@ -391,18 +376,6 @@ server.tool("diagnose_jvm", "Unified JVM diagnosis combining thread dump and GC
         .optional()
         .describe("GC log text (from -Xlog:gc*)"),
 }, async ({ thread_dump, gc_log }) => {
-    if (!license.isPro) {
-        return {
-            content: [{
-                    type: "text",
-                    text: formatUpgradePrompt("diagnose_jvm", "Unified JVM diagnosis with:\n" +
-                        "- Combined thread dump + GC log analysis\n" +
-                        "- Cross-correlation of GC pauses and thread contention\n" +
-                        "- Root cause identification\n" +
-                        "- Prioritized remediation plan"),
-                }],
-        };
-    }
     try {
         if (!thread_dump && !gc_log) {
             return {

package/build/parsers/gc-log.js

@@ -14,6 +14,9 @@ const UNIFIED_CONCURRENT_RE = /\[(\d+[.,]\d+)s\].*?GC\(\d+\)\s+(Concurrent\s+\S+
 const LEGACY_GC_RE = /\[(Full )?GC\s*\(([^)]+)\)\s+(\d+)K->(\d+)K\((\d+)K\),\s+(\d+[.,]\d+)\s+secs\]/;
 // ZGC format: [0.123s][info][gc] GC(0) Garbage Collection (Warmup) 24M(1%)->8M(0%) 1.234ms
 const ZGC_RE = /\[(\d+[.,]\d+)s\].*?GC\(\d+\)\s+Garbage Collection\s+\([^)]+\)\s+(\d+)M\(\d+%\)->(\d+)M\(\d+%\)\s+(\d+[.,]\d+)ms/;
+// Shenandoah pause format: [0.521s][info][gc] GC(0) Pause Init Mark 2.606ms
+// Pauses include: Pause Init Mark, Pause Final Mark, Pause Init Update Refs, Pause Final Update Refs, Pause Full
+const SHENANDOAH_PAUSE_RE = /\[(\d+[.,]\d+)s\].*?GC\(\d+\)\s+(Pause\s+(?:Init|Final)\s+\S+(?:\s+\S+)?|Pause Full(?:\s+\([^)]*\))?)\s+(\d+[.,]\d+)ms/;
 export function parseGcLog(text) {
     const lines = text.replace(/\r\n/g, "\n").split("\n");
     const events = [];
@@ -75,6 +78,19 @@ export function parseGcLog(text) {
             });
             continue;
         }
+        // Try Shenandoah pause format (no heap sizes in pause events)
+        const shenandoahMatch = line.match(SHENANDOAH_PAUSE_RE);
+        if (shenandoahMatch) {
+            events.push({
+                timestamp: parseFloat(shenandoahMatch[1].replace(",", ".")),
+                type: shenandoahMatch[2].trim(),
+                pauseMs: parseFloat(shenandoahMatch[3].replace(",", ".")),
+                heapBeforeMb: 0,
+                heapAfterMb: 0,
+                heapTotalMb: 0,
+            });
+            continue;
+        }
         // Try legacy format
         const legacyMatch = line.match(LEGACY_GC_RE);
         if (legacyMatch) {

package/build/parsers/jfr-summary.js

@@ -110,6 +110,11 @@ function analyzeJfrEvents(events, totalEvents, totalSize) {
         issues.push(`${monitorEnter.count.toLocaleString()} monitor enter events — significant lock contention.`);
         recommendations.push("Use `analyze_thread_dump` to identify contention hotspots and consider lock-free alternatives.");
     }
+    // Check for threads spending time in Object.wait() — indicates producer-consumer imbalance
+    if (monitorWait && monitorWait.count > 2000) {
+        issues.push(`${monitorWait.count.toLocaleString()} Object.wait() events — threads frequently waiting for notifications. Producers may be slower than consumers.`);
+        recommendations.push("Profile the producer side of producer-consumer queues. Consider bounded queues with backpressure or increasing producer thread count.");
+    }
     // Check for thread starts (churn)
     const threadStart = byName.get("jdk.ThreadStart");
     if (threadStart && threadStart.count > 200) {

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "mcp-jvm-diagnostics",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "MCP server for JVM diagnostics — analyze thread dumps, detect deadlocks, parse GC logs, and get JVM tuning recommendations",
+  "mcpName": "io.github.dmitriusan/mcp-jvm-diagnostics",
   "author": "Dmytro Lisnichenko",
   "type": "module",
   "main": "./build/index.js",

package/build/license.js

@@ -1,114 +0,0 @@
-/**
- * License validation for MCP Migration Advisor (Pro features).
- *
- * Validates license keys offline using HMAC-SHA256.
- * Missing or invalid keys gracefully degrade to free mode — never errors.
- *
- * Key format: MCPJBS-XXXXX-XXXXX-XXXXX-XXXXX
- * Payload (12 bytes = 20 base32 chars):
- *   [0]     product mask (8 bits)
- *   [1-2]   expiry days since 2026-01-01 (16 bits)
- *   [3-5]   customer ID (24 bits)
- *   [6-11]  HMAC-SHA256 truncated (48 bits)
- */
-import { createHmac } from "node:crypto";
-const KEY_PREFIX = "MCPJBS-";
-const EPOCH = new Date("2026-01-01T00:00:00Z");
-const BASE32_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
-const HMAC_SECRET = "mcp-java-backend-suite-license-v1";
-const PRODUCTS = {
-    "db-analyzer": 0,
-    "jvm-diagnostics": 1,
-    "migration-advisor": 2,
-    "spring-boot-actuator": 3,
-    "redis-diagnostics": 4,
-};
-export function validateLicense(key, product) {
-    const FREE = {
-        isPro: false,
-        expiresAt: null,
-        customerId: null,
-        reason: "No license key provided",
-    };
-    if (!key || key.trim().length === 0)
-        return FREE;
-    const trimmed = key.trim().toUpperCase();
-    if (!trimmed.startsWith(KEY_PREFIX)) {
-        return { ...FREE, reason: "Invalid key format: missing MCPJBS- prefix" };
-    }
-    const body = trimmed.slice(KEY_PREFIX.length).replace(/-/g, "");
-    if (body.length < 20) {
-        return { ...FREE, reason: "Invalid key format: too short" };
-    }
-    let decoded;
-    try {
-        decoded = base32Decode(body.slice(0, 20));
-    }
-    catch {
-        return { ...FREE, reason: "Invalid key format: bad base32 encoding" };
-    }
-    if (decoded.length < 12) {
-        return { ...FREE, reason: "Invalid key format: decoded data too short" };
-    }
-    const payload = decoded.subarray(0, 6);
-    const providedSignature = decoded.subarray(6, 12);
-    const expectedHmac = createHmac("sha256", HMAC_SECRET)
-        .update(payload)
-        .digest();
-    const expectedSignature = expectedHmac.subarray(0, 6);
-    if (!providedSignature.equals(expectedSignature)) {
-        return { ...FREE, reason: "Invalid license key: signature mismatch" };
-    }
-    const productMask = payload[0];
-    const daysSinceEpoch = (payload[1] << 8) | payload[2];
-    const customerId = (payload[3] << 16) | (payload[4] << 8) | payload[5];
-    const productBit = PRODUCTS[product];
-    if (productBit === undefined) {
-        return { ...FREE, reason: `Unknown product: ${product}` };
-    }
-    if ((productMask & (1 << productBit)) === 0) {
-        return { ...FREE, customerId, reason: `License does not include ${product}` };
-    }
-    const expiresAt = new Date(EPOCH.getTime() + daysSinceEpoch * 24 * 60 * 60 * 1000);
-    if (new Date() > expiresAt) {
-        return {
-            isPro: false,
-            expiresAt,
-            customerId,
-            reason: `License expired on ${expiresAt.toISOString().slice(0, 10)}`,
-        };
-    }
-    return { isPro: true, expiresAt, customerId, reason: "Valid Pro license" };
-}
-export function formatUpgradePrompt(toolName, featureDescription) {
-    return [
-        `## ${toolName} (Pro Feature)`,
-        "",
-        "This analysis is available with MCP Java Backend Suite Pro.",
-        "",
-        `**What you'll get:**`,
-        featureDescription,
-        "",
-        "**Upgrade**: https://mcpjbs.dev/pricing",
-        "**Price**: $19/month or $190/year",
-        "",
-        "> Already have a key? Set `MCP_LICENSE_KEY` in your Claude Desktop config.",
-    ].join("\n");
-}
-function base32Decode(encoded) {
-    const bytes = [];
-    let bits = 0;
-    let value = 0;
-    for (const char of encoded) {
-        const idx = BASE32_CHARS.indexOf(char);
-        if (idx === -1)
-            throw new Error(`Invalid base32 character: ${char}`);
-        value = (value << 5) | idx;
-        bits += 5;
-        if (bits >= 8) {
-            bits -= 8;
-            bytes.push((value >> bits) & 0xff);
-        }
-    }
-    return Buffer.from(bytes);
-}