mcp-db-analyzer 0.2.6 → 0.2.7

package/README.md

@@ -21,6 +21,19 @@ Other analytical MCP servers (CrystalDBA, pg-dash, MCP-PostgreSQL-Ops) cover Pos
 - **Markdown output** optimized for LLM consumption
 - **Zero configuration** — just set `DATABASE_URL`
 
+## Pro Tier
+
+**Generate exportable diagnostic reports (HTML + PDF)** with a Pro license key.
+
+- Full JVM thread dump analysis report with actionable recommendations
+- PDF export for sharing with your team
+- 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)
+
+Pro license key activates the `generate_report` MCP tool in mcp-jvm-diagnostics.
+
 ## Installation
 
 ```bash

package/build/analyzers/connections.js

@@ -63,7 +63,7 @@ async function analyzePostgresConnections() {
         lines.push("| PID | User | Duration | Query |");
         lines.push("|-----|------|----------|-------|");
         for (const row of idleTxn.rows) {
-            lines.push(`| ${row.pid} | ${row.usename} | ${row.duration} | ${row.query} |`);
+            lines.push(`| ${row.pid} | ${row.usename} | ${row.duration} | ${row.query.replace(/\|/g, "\\|")} |`);
         }
         lines.push("");
     }
@@ -83,7 +83,7 @@ async function analyzePostgresConnections() {
         lines.push("| PID | User | Duration | Wait | Query |");
         lines.push("|-----|------|----------|------|-------|");
         for (const row of longQueries.rows) {
-            lines.push(`| ${row.pid} | ${row.usename} | ${row.duration} | ${row.wait_event_type || "-"} | ${row.query} |`);
+            lines.push(`| ${row.pid} | ${row.usename} | ${row.duration} | ${row.wait_event_type || "-"} | ${row.query.replace(/\|/g, "\\|")} |`);
         }
         lines.push("");
     }
@@ -112,7 +112,7 @@ async function analyzePostgresConnections() {
         lines.push("| Blocked PID | Blocking PID | Blocked Query | Blocking Query |");
         lines.push("|-------------|--------------|---------------|----------------|");
         for (const row of blocked.rows) {
-            lines.push(`| ${row.blocked_pid} | ${row.blocking_pid} | ${row.blocked_query} | ${row.blocking_query} |`);
+            lines.push(`| ${row.blocked_pid} | ${row.blocking_pid} | ${row.blocked_query.replace(/\|/g, "\\|")} | ${row.blocking_query.replace(/\|/g, "\\|")} |`);
         }
         lines.push("");
     }

package/build/analyzers/query.js

@@ -237,14 +237,19 @@ function collectWarnings(node) {
     if (node["Sort Method"] === "external merge") {
         warnings.push(`**Disk sort** detected. Increase \`work_mem\` or add an index to avoid sorting.`);
     }
-    // Stale statistics: actual rows deviate significantly from planner estimate
-    if (node["Actual Rows"] !== undefined &&
-        node["Plan Rows"] > 0 &&
-        node["Actual Rows"] > 0) {
-        const ratio = node["Actual Rows"] / node["Plan Rows"];
-        if (ratio > 10 || ratio < 0.1) {
-            const relation = node["Relation Name"] ?? node["Node Type"];
-            warnings.push(`**Stale statistics** on \`${relation}\`: planner estimated ${node["Plan Rows"]} rows but got ${node["Actual Rows"]} (${ratio > 1 ? ratio.toFixed(0) + "× over" : (1 / ratio).toFixed(0) + "× under"}estimate). Run \`ANALYZE ${node["Relation Name"] ?? ""}\` to refresh table statistics.`);
+    // Stale statistics: actual rows deviate significantly from planner estimate.
+    // Handle Plan Rows = 0 separately — the planner expected an empty result but
+    // got rows, which is the most misleading case for query planning.
+    if (node["Actual Rows"] !== undefined) {
+        const relation = node["Relation Name"] ?? node["Node Type"];
+        if (node["Plan Rows"] === 0 && node["Actual Rows"] > 0) {
+            warnings.push(`**Stale statistics** on \`${relation}\`: planner estimated 0 rows but got ${node["Actual Rows"]}. Run \`ANALYZE ${node["Relation Name"] ?? ""}\` to refresh table statistics.`);
+        }
+        else if (node["Plan Rows"] > 0 && node["Actual Rows"] > 0) {
+            const ratio = node["Actual Rows"] / node["Plan Rows"];
+            if (ratio > 10 || ratio < 0.1) {
+                warnings.push(`**Stale statistics** on \`${relation}\`: planner estimated ${node["Plan Rows"]} rows but got ${node["Actual Rows"]} (${ratio > 1 ? ratio.toFixed(0) + "× over" : (1 / ratio).toFixed(0) + "× under"}estimate). Run \`ANALYZE ${node["Relation Name"] ?? ""}\` to refresh table statistics.`);
+            }
         }
     }
     if (node.Plans) {

package/build/db-mysql.js

@@ -49,7 +49,13 @@ export function createMysqlAdapter() {
                     return { rows: rows };
                 }
                 catch (err) {
-                    await conn.rollback();
+                    try {
+                        await conn.rollback();
+                    }
+                    catch {
+                        // Transaction may not have started (e.g. beginTransaction threw);
+                        // suppress the secondary error so the original cause is preserved.
+                    }
                     throw err;
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-db-analyzer",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "MCP server for PostgreSQL, MySQL, and SQLite schema analysis, index optimization, and query plan inspection",
   "mcpName": "io.github.dmitriusan/mcp-db-analyzer",
   "author": "Dmytro Lisnichenko",