mcp-jvm-diagnostics 0.1.9 → 0.1.11

package/README.md

@@ -31,7 +31,7 @@ It analyzes **offline** artifacts (thread dumps, GC logs, heap histograms) rathe
 - Priority support
 
 <!-- TODO: replace placeholder Stripe Payment Link once STRIPE_SECRET_KEY is configured -->
-**$9.99/month** — [Get Pro License](https://buy.stripe.com/PLACEHOLDER)
+**$9.00/month** — [Get Pro License](https://buy.stripe.com/PLACEHOLDER)
 
 Pro license key activates the `generate_report` MCP tool in mcp-jvm-diagnostics.
 

package/build/index.js

@@ -13,7 +13,7 @@ import { parseJfrSummary } from "./parsers/jfr-summary.js";
 import { generateReportFromThreadDump, analyzeThreadDumpMarkdown, } from "./reporting.js";
 // Handle --help
 if (process.argv.includes("--help") || process.argv.includes("-h")) {
-    console.log(`mcp-jvm-diagnostics v0.1.9 — MCP server for JVM diagnostics
+    console.log(`mcp-jvm-diagnostics v0.1.11 — MCP server for JVM diagnostics
 
 Usage:
   mcp-jvm-diagnostics [options]
@@ -33,7 +33,7 @@ Tools provided:
 }
 const server = new McpServer({
     name: "mcp-jvm-diagnostics",
-    version: "0.1.9",
+    version: "0.1.11",
 });
 // --- 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. Handles both platform threads and virtual threads (Java 21+). Note: deadlock detection covers synchronized monitor locks only — java.util.concurrent.locks.ReentrantLock and other j.u.c lock types do not expose their waiters in thread dump lock info and will not be detected.", {
@@ -345,15 +345,15 @@ server.tool("analyze_jfr", "Parse JDK Flight Recorder summary output and analyze
     }
 });
 // --- Tool: diagnose_jvm ---
-server.tool("diagnose_jvm", "Unified JVM diagnosis combining thread dump and GC log analysis. Provide one or both inputs for comprehensive root cause analysis.", {
+server.tool("diagnose_jvm", "Unified JVM diagnosis combining thread dump and GC log analysis with cross-correlation. Detects deadlocks, lock contention, GC pressure, and GC-induced cascading thread blocks. When both inputs are provided from the same time window, cross-correlates high GC overhead with contention and flags long GC pauses causing thread starvation. Either input can be omitted for single-source analysis.", {
     thread_dump: z
         .string()
         .optional()
-        .describe("Thread dump text (from jstack)"),
+        .describe("Thread dump text (from jstack, kill -3, or VisualVM). Capture at the same time as the GC log for accurate cross-correlation."),
     gc_log: z
         .string()
         .optional()
-        .describe("GC log text (from -Xlog:gc*)"),
+        .describe("GC log text (from -Xlog:gc* for Java 9+, or -verbose:gc for Java 8). Capture at the same time as the thread dump for accurate cross-correlation."),
 }, async ({ thread_dump, gc_log }) => {
     try {
         if (!thread_dump && !gc_log) {

package/build/parsers/jfr-summary.js

@@ -119,6 +119,7 @@ function analyzeJfrEvents(events, totalEvents, totalSize) {
     const threadStart = byName.get("jdk.ThreadStart");
     if (threadStart && threadStart.count > 200) {
         issues.push(`${threadStart.count.toLocaleString()} threads started — possible thread churn. Consider thread pooling.`);
+        recommendations.push("Replace ad-hoc thread creation with a fixed-size thread pool (Executors.newFixedThreadPool) or virtual threads (Java 21+) to eliminate thread creation overhead.");
     }
     // Check for exception events
     const exceptions = byName.get("jdk.JavaExceptionThrow");
@@ -130,6 +131,7 @@ function analyzeJfrEvents(events, totalEvents, totalSize) {
     const classLoad = byName.get("jdk.ClassLoad");
     if (classLoad && classLoad.count > 1000) {
         issues.push(`${classLoad.count.toLocaleString()} class loads — excessive class loading may indicate classloader leak or dynamic proxy overuse.`);
+        recommendations.push("Use `analyze_heap_histo` to check java.lang.Class instance count. If growing, look for frameworks that generate proxies or bytecode at runtime (Hibernate, Spring AOP, reflection-heavy libraries).");
     }
     // Check for file/socket I/O
     const fileRead = byName.get("jdk.FileRead");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-jvm-diagnostics",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "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",