mcp-jvm-diagnostics 0.1.11 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/build/index.js CHANGED
@@ -13,7 +13,7 @@ import { parseJfrSummary } from "./parsers/jfr-summary.js";
13
13
  import { generateReportFromThreadDump, analyzeThreadDumpMarkdown, } from "./reporting.js";
14
14
  // Handle --help
15
15
  if (process.argv.includes("--help") || process.argv.includes("-h")) {
16
- console.log(`mcp-jvm-diagnostics v0.1.11 — MCP server for JVM diagnostics
16
+ console.log(`mcp-jvm-diagnostics v0.1.12 — MCP server for JVM diagnostics
17
17
 
18
18
  Usage:
19
19
  mcp-jvm-diagnostics [options]
@@ -33,7 +33,7 @@ Tools provided:
33
33
  }
34
34
  const server = new McpServer({
35
35
  name: "mcp-jvm-diagnostics",
36
- version: "0.1.11",
36
+ version: "0.1.12",
37
37
  });
38
38
  // --- Tool: analyze_thread_dump ---
39
39
  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.", {
@@ -349,11 +349,11 @@ server.tool("diagnose_jvm", "Unified JVM diagnosis combining thread dump and GC
349
349
  thread_dump: z
350
350
  .string()
351
351
  .optional()
352
- .describe("Thread dump text (from jstack, kill -3, or VisualVM). Capture at the same time as the GC log for accurate cross-correlation."),
352
+ .describe("Thread dump text (from jstack, kill -3, or VisualVM). Capture during active symptoms for meaningful cross-correlation — a dump from a healthy period will not correlate with GC pressure visible in the log."),
353
353
  gc_log: z
354
354
  .string()
355
355
  .optional()
356
- .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."),
356
+ .describe("GC log text (from -Xlog:gc* for Java 9+, or -verbose:gc for Java 8). Provide the portion covering the time window when the thread dump was taken — trim the log to the symptom window if it is large. Logs from a different time period produce spurious correlations."),
357
357
  }, async ({ thread_dump, gc_log }) => {
358
358
  try {
359
359
  if (!thread_dump && !gc_log) {
@@ -122,6 +122,7 @@ export function parseGcLog(text) {
122
122
  heapAfterMb: Math.round(parseInt(parallelRegionMatch[3], 10) / 1024),
123
123
  heapTotalMb: Math.round(parseInt(parallelRegionMatch[4], 10) / 1024),
124
124
  });
125
+ continue;
125
126
  }
126
127
  }
127
128
  // Calculate time span
@@ -142,7 +142,8 @@ function analyzeJfrEvents(events, totalEvents, totalSize) {
142
142
  .filter(Boolean)
143
143
  .reduce((sum, e) => sum + e.count, 0);
144
144
  if (ioCount > 5000) {
145
- issues.push(`High I/O activity: ${ioCount.toLocaleString()} file/socket events. Consider batching or buffering.`);
145
+ issues.push(`High I/O activity: ${ioCount.toLocaleString()} file/socket events recorded.`);
146
+ recommendations.push("Profile I/O call sites with async-profiler or VisualVM. Common causes: unbuffered writes, per-record DB queries, missing connection pooling. Consider batching writes and reads.");
146
147
  }
147
148
  // Check for compilation events
148
149
  const compilation = byName.get("jdk.Compilation");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-jvm-diagnostics",
3
- "version": "0.1.11",
3
+ "version": "0.1.12",
4
4
  "description": "MCP server for JVM diagnostics — analyze thread dumps, detect deadlocks, parse GC logs, and get JVM tuning recommendations",
5
5
  "mcpName": "io.github.dmitriusan/mcp-jvm-diagnostics",
6
6
  "author": "Dmytro Lisnichenko",