@neverinfamous/mysql-mcp 2.1.0 → 2.3.0

package/src/adapters/mysql/resources/docstore.ts

@@ -1,31 +1,36 @@
 /**
  * MySQL Resource - Document Store
  */
-import type { MySQLAdapter } from '../MySQLAdapter.js';
-import type { ResourceDefinition, RequestContext } from '../../../types/index.js';
+import type { MySQLAdapter } from "../MySQLAdapter.js";
+import type {
+  ResourceDefinition,
+  RequestContext,
+} from "../../../types/index.js";
 
-export function createDocstoreResource(adapter: MySQLAdapter): ResourceDefinition {
-    return {
-        uri: 'mysql://docstore',
-        name: 'Document Store Collections',
-        title: 'MySQL Document Store',
-        description: 'X DevAPI document collections in the current database',
-        mimeType: 'application/json',
-        annotations: {
-            audience: ['user', 'assistant'],
-            priority: 0.5
-        },
-        handler: async (_uri: string, _context: RequestContext) => {
-            try {
-                // Check if X Plugin is enabled
-                const pluginResult = await adapter.executeQuery(
-                    "SELECT PLUGIN_STATUS FROM information_schema.PLUGINS WHERE PLUGIN_NAME = 'mysqlx'"
-                );
-                const pluginRow = pluginResult.rows?.[0];
-                const xPluginEnabled = pluginRow?.['PLUGIN_STATUS'] === 'ACTIVE';
+export function createDocstoreResource(
+  adapter: MySQLAdapter,
+): ResourceDefinition {
+  return {
+    uri: "mysql://docstore",
+    name: "Document Store Collections",
+    title: "MySQL Document Store",
+    description: "X DevAPI document collections in the current database",
+    mimeType: "application/json",
+    annotations: {
+      audience: ["user", "assistant"],
+      priority: 0.5,
+    },
+    handler: async (_uri: string, _context: RequestContext) => {
+      try {
+        // Check if X Plugin is enabled
+        const pluginResult = await adapter.executeQuery(
+          "SELECT PLUGIN_STATUS FROM information_schema.PLUGINS WHERE PLUGIN_NAME = 'mysqlx'",
+        );
+        const pluginRow = pluginResult.rows?.[0];
+        const xPluginEnabled = pluginRow?.["PLUGIN_STATUS"] === "ACTIVE";
 
-                // Get collections (tables with _id column and doc JSON column)
-                const collectionsResult = await adapter.executeQuery(`
+        // Get collections (tables with _id column and doc JSON column)
+        const collectionsResult = await adapter.executeQuery(`
                     SELECT 
                         t.TABLE_NAME as collection_name,
                         t.TABLE_ROWS as row_count,
@@ -48,22 +53,22 @@ export function createDocstoreResource(adapter: MySQLAdapter): ResourceDefinitio
                     ORDER BY t.TABLE_NAME
                 `);
 
-                return {
-                    xPluginEnabled,
-                    collectionCount: collectionsResult.rows?.length ?? 0,
-                    collections: collectionsResult.rows ?? [],
-                    note: xPluginEnabled
-                        ? 'X Plugin is active - X Protocol available on port 33060'
-                        : 'X Plugin not active - document store limited to SQL access'
-                };
-            } catch {
-                return {
-                    xPluginEnabled: false,
-                    collectionCount: 0,
-                    collections: [],
-                    error: 'Unable to retrieve document store information'
-                };
-            }
-        }
-    };
+        return {
+          xPluginEnabled,
+          collectionCount: collectionsResult.rows?.length ?? 0,
+          collections: collectionsResult.rows ?? [],
+          note: xPluginEnabled
+            ? "X Plugin is active - X Protocol available on port 33060"
+            : "X Plugin not active - document store limited to SQL access",
+        };
+      } catch {
+        return {
+          xPluginEnabled: false,
+          collectionCount: 0,
+          collections: [],
+          error: "Unable to retrieve document store information",
+        };
+      }
+    },
+  };
 }

package/src/adapters/mysql/resources/events.ts

@@ -1,31 +1,37 @@
 /**
  * MySQL Resource - Events
  */
-import type { MySQLAdapter } from '../MySQLAdapter.js';
-import type { ResourceDefinition, RequestContext } from '../../../types/index.js';
+import type { MySQLAdapter } from "../MySQLAdapter.js";
+import type {
+  ResourceDefinition,
+  RequestContext,
+} from "../../../types/index.js";
 
-export function createEventsResource(adapter: MySQLAdapter): ResourceDefinition {
-    return {
-        uri: 'mysql://events',
-        name: 'Scheduled Events',
-        title: 'MySQL Scheduled Events',
-        description: 'Event Scheduler status and scheduled events overview',
-        mimeType: 'application/json',
-        annotations: {
-            audience: ['user', 'assistant'],
-            priority: 0.6
-        },
-        handler: async (_uri: string, _context: RequestContext) => {
-            // Get scheduler status
-            const schedulerResult = await adapter.executeQuery(
-                "SHOW VARIABLES LIKE 'event_scheduler'"
-            );
-            const schedulerRow = schedulerResult.rows?.[0];
-            const schedulerVal = schedulerRow?.['Value'];
-            const schedulerStatus = typeof schedulerVal === 'string' ? schedulerVal : 'OFF';
+export function createEventsResource(
+  adapter: MySQLAdapter,
+): ResourceDefinition {
+  return {
+    uri: "mysql://events",
+    name: "Scheduled Events",
+    title: "MySQL Scheduled Events",
+    description: "Event Scheduler status and scheduled events overview",
+    mimeType: "application/json",
+    annotations: {
+      audience: ["user", "assistant"],
+      priority: 0.6,
+    },
+    handler: async (_uri: string, _context: RequestContext) => {
+      // Get scheduler status
+      const schedulerResult = await adapter.executeQuery(
+        "SHOW VARIABLES LIKE 'event_scheduler'",
+      );
+      const schedulerRow = schedulerResult.rows?.[0];
+      const schedulerVal = schedulerRow?.["Value"];
+      const schedulerStatus =
+        typeof schedulerVal === "string" ? schedulerVal : "OFF";
 
-            // Get all events
-            const eventsResult = await adapter.executeQuery(`
+      // Get all events
+      const eventsResult = await adapter.executeQuery(`
                 SELECT 
                     EVENT_SCHEMA as schema_name,
                     EVENT_NAME as name,
@@ -39,12 +45,12 @@ export function createEventsResource(adapter: MySQLAdapter): ResourceDefinition
                 ORDER BY EVENT_SCHEMA, EVENT_NAME
             `);
 
-            return {
-                schedulerEnabled: schedulerStatus === 'ON',
-                schedulerStatus,
-                eventCount: eventsResult.rows?.length ?? 0,
-                events: eventsResult.rows ?? []
-            };
-        }
-    };
+      return {
+        schedulerEnabled: schedulerStatus === "ON",
+        schedulerStatus,
+        eventCount: eventsResult.rows?.length ?? 0,
+        events: eventsResult.rows ?? [],
+      };
+    },
+  };
 }

package/src/adapters/mysql/resources/health.ts

@@ -1,28 +1,33 @@
 /**
  * MySQL Resource - Health
- * 
+ *
  * Comprehensive database health status including connection pool,
  * thread activity, and InnoDB status.
  */
-import type { MySQLAdapter } from '../MySQLAdapter.js';
-import type { ResourceDefinition, RequestContext } from '../../../types/index.js';
+import type { MySQLAdapter } from "../MySQLAdapter.js";
+import type {
+  ResourceDefinition,
+  RequestContext,
+} from "../../../types/index.js";
 
-export function createHealthResource(adapter: MySQLAdapter): ResourceDefinition {
-    return {
-        uri: 'mysql://health',
-        name: 'Database Health',
-        title: 'MySQL Database Health',
-        description: 'Comprehensive database health status',
-        mimeType: 'application/json',
-        annotations: {
-            audience: ['user', 'assistant'],
-            priority: 1.0
-        },
-        handler: async (_uri: string, _context: RequestContext) => {
-            // Execute health queries in parallel for better performance
-            const [statusResult, maxConnResult] = await Promise.all([
-                // Get uptime and connection info
-                adapter.executeQuery(`
+export function createHealthResource(
+  adapter: MySQLAdapter,
+): ResourceDefinition {
+  return {
+    uri: "mysql://health",
+    name: "Database Health",
+    title: "MySQL Database Health",
+    description: "Comprehensive database health status",
+    mimeType: "application/json",
+    annotations: {
+      audience: ["user", "assistant"],
+      priority: 1.0,
+    },
+    handler: async (_uri: string, _context: RequestContext) => {
+      // Execute health queries in parallel for better performance
+      const [statusResult, maxConnResult] = await Promise.all([
+        // Get uptime and connection info
+        adapter.executeQuery(`
                     SHOW GLOBAL STATUS WHERE Variable_name IN (
                         'Uptime', 'Threads_connected', 'Threads_running', 
                         'Max_used_connections', 'Connections', 'Aborted_connects',
@@ -31,66 +36,85 @@ export function createHealthResource(adapter: MySQLAdapter): ResourceDefinition
                         'Innodb_buffer_pool_reads', 'Table_locks_waited', 'Table_locks_immediate'
                     )
                 `),
-                // Get max_connections for percentage calculation
-                adapter.executeQuery(
-                    "SHOW GLOBAL VARIABLES LIKE 'max_connections'"
-                )
-            ]);
+        // Get max_connections for percentage calculation
+        adapter.executeQuery("SHOW GLOBAL VARIABLES LIKE 'max_connections'"),
+      ]);
 
-            const status: Record<string, string> = {};
-            for (const row of statusResult.rows ?? []) {
-                status[row['Variable_name'] as string] = row['Value'] as string;
-            }
+      const status: Record<string, string> = {};
+      for (const row of statusResult.rows ?? []) {
+        status[row["Variable_name"] as string] = row["Value"] as string;
+      }
 
-            const maxConnections = parseInt(
-                (maxConnResult.rows?.[0]?.['Value'] as string) ?? '151',
-                10
-            );
+      const maxConnections = parseInt(
+        (maxConnResult.rows?.[0]?.["Value"] as string) ?? "151",
+        10,
+      );
 
-            // Calculate health metrics
-            const threadsConnected = parseInt(status['Threads_connected'] ?? '0', 10);
-            const connectionUsagePercent = Math.round((threadsConnected / maxConnections) * 100);
+      // Calculate health metrics
+      const threadsConnected = parseInt(status["Threads_connected"] ?? "0", 10);
+      const connectionUsagePercent = Math.round(
+        (threadsConnected / maxConnections) * 100,
+      );
 
-            const bufferPoolRequests = parseInt(status['Innodb_buffer_pool_read_requests'] ?? '0', 10);
-            const bufferPoolReads = parseInt(status['Innodb_buffer_pool_reads'] ?? '0', 10);
-            const bufferPoolHitRatio = bufferPoolRequests > 0
-                ? Math.round(((bufferPoolRequests - bufferPoolReads) / bufferPoolRequests) * 100 * 100) / 100
-                : 100;
+      const bufferPoolRequests = parseInt(
+        status["Innodb_buffer_pool_read_requests"] ?? "0",
+        10,
+      );
+      const bufferPoolReads = parseInt(
+        status["Innodb_buffer_pool_reads"] ?? "0",
+        10,
+      );
+      const bufferPoolHitRatio =
+        bufferPoolRequests > 0
+          ? Math.round(
+              ((bufferPoolRequests - bufferPoolReads) / bufferPoolRequests) *
+                100 *
+                100,
+            ) / 100
+          : 100;
 
-            const tableLockWaited = parseInt(status['Table_locks_waited'] ?? '0', 10);
-            const tableLockImmediate = parseInt(status['Table_locks_immediate'] ?? '0', 10);
-            const tableLockContention = (tableLockWaited + tableLockImmediate) > 0
-                ? Math.round((tableLockWaited / (tableLockWaited + tableLockImmediate)) * 100 * 100) / 100
-                : 0;
+      const tableLockWaited = parseInt(status["Table_locks_waited"] ?? "0", 10);
+      const tableLockImmediate = parseInt(
+        status["Table_locks_immediate"] ?? "0",
+        10,
+      );
+      const tableLockContention =
+        tableLockWaited + tableLockImmediate > 0
+          ? Math.round(
+              (tableLockWaited / (tableLockWaited + tableLockImmediate)) *
+                100 *
+                100,
+            ) / 100
+          : 0;
 
-            // Get connection pool stats if available
-            const pool = adapter.getPool();
-            const poolStats = pool?.getStats();
+      // Get connection pool stats if available
+      const pool = adapter.getPool();
+      const poolStats = pool?.getStats();
 
-            return {
-                status: 'healthy',
-                uptime_seconds: parseInt(status['Uptime'] ?? '0', 10),
-                connections: {
-                    current: threadsConnected,
-                    running: parseInt(status['Threads_running'] ?? '0', 10),
-                    max_used: parseInt(status['Max_used_connections'] ?? '0', 10),
-                    max_allowed: maxConnections,
-                    usage_percent: connectionUsagePercent
-                },
-                performance: {
-                    questions: parseInt(status['Questions'] ?? '0', 10),
-                    slow_queries: parseInt(status['Slow_queries'] ?? '0', 10),
-                    buffer_pool_hit_ratio: bufferPoolHitRatio,
-                    table_lock_contention_percent: tableLockContention
-                },
-                queries: {
-                    select: parseInt(status['Com_select'] ?? '0', 10),
-                    insert: parseInt(status['Com_insert'] ?? '0', 10),
-                    update: parseInt(status['Com_update'] ?? '0', 10),
-                    delete: parseInt(status['Com_delete'] ?? '0', 10)
-                },
-                pool: poolStats ?? null
-            };
-        }
-    };
+      return {
+        status: "healthy",
+        uptime_seconds: parseInt(status["Uptime"] ?? "0", 10),
+        connections: {
+          current: threadsConnected,
+          running: parseInt(status["Threads_running"] ?? "0", 10),
+          max_used: parseInt(status["Max_used_connections"] ?? "0", 10),
+          max_allowed: maxConnections,
+          usage_percent: connectionUsagePercent,
+        },
+        performance: {
+          questions: parseInt(status["Questions"] ?? "0", 10),
+          slow_queries: parseInt(status["Slow_queries"] ?? "0", 10),
+          buffer_pool_hit_ratio: bufferPoolHitRatio,
+          table_lock_contention_percent: tableLockContention,
+        },
+        queries: {
+          select: parseInt(status["Com_select"] ?? "0", 10),
+          insert: parseInt(status["Com_insert"] ?? "0", 10),
+          update: parseInt(status["Com_update"] ?? "0", 10),
+          delete: parseInt(status["Com_delete"] ?? "0", 10),
+        },
+        pool: poolStats ?? null,
+      };
+    },
+  };
 }

package/src/adapters/mysql/resources/index.ts

@@ -1,39 +1,39 @@
 /**
  * MySQL MCP Resources
- * 
+ *
  * Provides structured data access via URI patterns.
  * 18 resources total.
  */
-import type { MySQLAdapter } from '../MySQLAdapter.js';
-import type { ResourceDefinition } from '../../../types/index.js';
+import type { MySQLAdapter } from "../MySQLAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
 
 // Core resources
-import { createSchemaResource } from './schema.js';
-import { createTablesResource } from './tables.js';
-import { createVariablesResource } from './variables.js';
-import { createStatusResource } from './status.js';
-import { createProcesslistResource } from './processlist.js';
-import { createPoolResource } from './pool.js';
+import { createSchemaResource } from "./schema.js";
+import { createTablesResource } from "./tables.js";
+import { createVariablesResource } from "./variables.js";
+import { createStatusResource } from "./status.js";
+import { createProcesslistResource } from "./processlist.js";
+import { createPoolResource } from "./pool.js";
 
 // Extended monitoring resources
-import { createCapabilitiesResource } from './capabilities.js';
-import { createHealthResource } from './health.js';
-import { createPerformanceResource } from './performance.js';
-import { createIndexesResource } from './indexes.js';
-import { createReplicationResource } from './replication.js';
-import { createInnodbResource } from './innodb.js';
+import { createCapabilitiesResource } from "./capabilities.js";
+import { createHealthResource } from "./health.js";
+import { createPerformanceResource } from "./performance.js";
+import { createIndexesResource } from "./indexes.js";
+import { createReplicationResource } from "./replication.js";
+import { createInnodbResource } from "./innodb.js";
 
 // New resources (6)
-import { createEventsResource } from './events.js';
-import { createSysSchemaResource } from './sysschema.js';
-import { createLocksResource } from './locks.js';
-import { createClusterResource } from './cluster.js';
-import { createSpatialResource } from './spatial.js';
-import { createDocstoreResource } from './docstore.js';
+import { createEventsResource } from "./events.js";
+import { createSysSchemaResource } from "./sysschema.js";
+import { createLocksResource } from "./locks.js";
+import { createClusterResource } from "./cluster.js";
+import { createSpatialResource } from "./spatial.js";
+import { createDocstoreResource } from "./docstore.js";
 
 /**
- * Get all MySQL resources (12 total)
- * 
+ * Get all MySQL resources (18 total)
+ *
  * Core (6):
  * - mysql://schema - Full database schema
  * - mysql://tables - Table listing with metadata
@@ -41,7 +41,7 @@ import { createDocstoreResource } from './docstore.js';
  * - mysql://status - Server status metrics
  * - mysql://processlist - Active connections and queries
  * - mysql://pool - Connection pool statistics
- * 
+ *
  * Extended Monitoring (6):
  * - mysql://capabilities - Server version, features, tool categories
  * - mysql://health - Comprehensive database health status
@@ -49,29 +49,37 @@ import { createDocstoreResource } from './docstore.js';
  * - mysql://indexes - Index usage and statistics
  * - mysql://replication - Replication status and lag
  * - mysql://innodb - InnoDB buffer pool and engine metrics
+ *
+ * New (6):
+ * - mysql://events - Event Scheduler status and scheduled events
+ * - mysql://sysschema - sys schema diagnostics summary
+ * - mysql://locks - InnoDB lock contention detection
+ * - mysql://cluster - Group Replication/InnoDB Cluster status
+ * - mysql://spatial - Spatial columns and indexes
+ * - mysql://docstore - Document Store collections
  */
 export function getMySQLResources(adapter: MySQLAdapter): ResourceDefinition[] {
-    return [
-        // Core resources
-        createSchemaResource(adapter),
-        createTablesResource(adapter),
-        createVariablesResource(adapter),
-        createStatusResource(adapter),
-        createProcesslistResource(adapter),
-        createPoolResource(adapter),
-        // Extended monitoring resources
-        createCapabilitiesResource(adapter),
-        createHealthResource(adapter),
-        createPerformanceResource(adapter),
-        createIndexesResource(adapter),
-        createReplicationResource(adapter),
-        createInnodbResource(adapter),
-        // New resources (6)
-        createEventsResource(adapter),
-        createSysSchemaResource(adapter),
-        createLocksResource(adapter),
-        createClusterResource(adapter),
-        createSpatialResource(adapter),
-        createDocstoreResource(adapter)
-    ];
+  return [
+    // Core resources
+    createSchemaResource(adapter),
+    createTablesResource(adapter),
+    createVariablesResource(adapter),
+    createStatusResource(adapter),
+    createProcesslistResource(adapter),
+    createPoolResource(adapter),
+    // Extended monitoring resources
+    createCapabilitiesResource(adapter),
+    createHealthResource(adapter),
+    createPerformanceResource(adapter),
+    createIndexesResource(adapter),
+    createReplicationResource(adapter),
+    createInnodbResource(adapter),
+    // New resources (6)
+    createEventsResource(adapter),
+    createSysSchemaResource(adapter),
+    createLocksResource(adapter),
+    createClusterResource(adapter),
+    createSpatialResource(adapter),
+    createDocstoreResource(adapter),
+  ];
 }