mcp-db-analyzer 0.2.3 → 0.2.5

package/README.md

@@ -376,6 +376,13 @@ Analyze PostgreSQL VACUUM maintenance status. Checks dead tuple ratios, vacuum s
 - **Connection analysis**: `analyze_connections` is PostgreSQL/MySQL only. Not available for SQLite databases.
 - **Vacuum analysis**: `analyze_vacuum` is PostgreSQL only. For MySQL, use `OPTIMIZE TABLE` or `analyze_table_bloat`.
 
+## Part of the MCP Java Backend Suite
+
+- [mcp-spring-boot-actuator](https://www.npmjs.com/package/mcp-spring-boot-actuator) — Spring Boot health, metrics, and bean analysis
+- [mcp-jvm-diagnostics](https://www.npmjs.com/package/mcp-jvm-diagnostics) — Thread dump and GC log 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/analyzers/query.js

@@ -3,6 +3,9 @@ import { queryUnsafe, getDriverType } from "../db.js";
  * Run EXPLAIN on a query and return a formatted analysis.
  */
 export async function explainQuery(sql, analyze = false) {
+    if (!sql || !sql.trim()) {
+        return "**Error**: SQL query cannot be empty.";
+    }
     // Safety: in ANALYZE mode, only allow pure SELECT statements.
     // EXPLAIN ANALYZE actually executes the query, so we must reject anything
     // that could modify data — including CTEs with write operations.
@@ -232,6 +235,16 @@ 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.`);
+        }
+    }
     if (node.Plans) {
         for (const child of node.Plans) {
             warnings.push(...collectWarnings(child));

package/build/analyzers/relationships.js

@@ -84,7 +84,7 @@ async function analyzeSqliteRelationships() {
     // Get FK info per table
     const fks = [];
     for (const table of tablesResult.rows) {
-        const fkInfo = await query(`PRAGMA foreign_key_list('${table.name}')`);
+        const fkInfo = await query(`PRAGMA foreign_key_list("${table.name.replace(/"/g, '""')}")`);
         for (const fk of fkInfo.rows) {
             fks.push({
                 source_table: table.name,

package/build/index.js

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
+import { createRequire } from "module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require("../package.json");
 import { listTables, inspectTable } from "./analyzers/schema.js";
 import { analyzeIndexUsage, findMissingIndexes } from "./analyzers/indexes.js";
 import { explainQuery } from "./analyzers/query.js";
@@ -15,7 +18,7 @@ import { closePool, initDriver, setConnectionTimeoutMs } from "./db.js";
 import { formatToolError } from "./errors.js";
 // Handle --help
 if (process.argv.includes("--help") || process.argv.includes("-h")) {
-    console.log(`mcp-db-analyzer v0.1.0 — MCP server for database analysis
+    console.log(`mcp-db-analyzer v${PKG_VERSION} — MCP server for database analysis
 
 Usage:
   mcp-db-analyzer [options]
@@ -68,7 +71,7 @@ function detectDriver() {
 }
 const server = new McpServer({
     name: "mcp-db-analyzer",
-    version: "0.1.0",
+    version: PKG_VERSION,
 });
 // Shared Zod parameter for connection timeout
 const timeoutParam = z

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "mcp-db-analyzer",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "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",
   "type": "module",
   "main": "./build/index.js",