@neverinfamous/mysql-mcp 2.1.0 → 2.3.0

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

@@ -1,33 +1,40 @@
 /**
  * MySQL Resource - Indexes
- * 
+ *
  * Index usage statistics and recommendations.
  */
-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 createIndexesResource(adapter: MySQLAdapter): ResourceDefinition {
-    return {
-        uri: 'mysql://indexes',
-        name: 'Index Statistics',
-        title: 'MySQL Index Statistics',
-        description: 'Index usage statistics, unused indexes, and duplicate detection',
-        mimeType: 'application/json',
-        annotations: {
-            audience: ['user', 'assistant'],
-            priority: 0.7
-        },
-        handler: async (_uri: string, _context: RequestContext) => {
-            // Get current database
-            const dbResult = await adapter.executeQuery('SELECT DATABASE() as db');
-            const database = (dbResult.rows?.[0]?.['db'] as string) ?? '';
+export function createIndexesResource(
+  adapter: MySQLAdapter,
+): ResourceDefinition {
+  return {
+    uri: "mysql://indexes",
+    name: "Index Statistics",
+    title: "MySQL Index Statistics",
+    description:
+      "Index usage statistics, unused indexes, and duplicate detection",
+    mimeType: "application/json",
+    annotations: {
+      audience: ["user", "assistant"],
+      priority: 0.7,
+    },
+    handler: async (_uri: string, _context: RequestContext) => {
+      // Get current database
+      const dbResult = await adapter.executeQuery("SELECT DATABASE() as db");
+      const database = (dbResult.rows?.[0]?.["db"] as string) ?? "";
 
-            if (!database) {
-                return { error: 'No database selected' };
-            }
+      if (!database) {
+        return { error: "No database selected" };
+      }
 
-            // Get index statistics
-            const indexResult = await adapter.executeQuery(`
+      // Get index statistics
+      const indexResult = await adapter.executeQuery(
+        `
                 SELECT 
                     TABLE_NAME as table_name,
                     INDEX_NAME as index_name,
@@ -39,12 +46,15 @@ export function createIndexesResource(adapter: MySQLAdapter): ResourceDefinition
                 FROM information_schema.STATISTICS
                 WHERE TABLE_SCHEMA = ?
                 ORDER BY TABLE_NAME, INDEX_NAME, SEQ_IN_INDEX
-            `, [database]);
+            `,
+        [database],
+      );
 
-            // Try to get index usage from performance_schema if available
-            let unusedIndexes: unknown[] = [];
-            try {
-                const unusedResult = await adapter.executeQuery(`
+      // Try to get index usage from performance_schema if available
+      let unusedIndexes: unknown[] = [];
+      try {
+        const unusedResult = await adapter.executeQuery(
+          `
                     SELECT 
                         object_schema as schema_name,
                         object_name as table_name,
@@ -54,16 +64,19 @@ export function createIndexesResource(adapter: MySQLAdapter): ResourceDefinition
                       AND index_name IS NOT NULL
                       AND index_name != 'PRIMARY'
                       AND count_star = 0
-                `, [database]);
-                unusedIndexes = unusedResult.rows ?? [];
-            } catch {
-                // Performance schema may not be available
-            }
+                `,
+          [database],
+        );
+        unusedIndexes = unusedResult.rows ?? [];
+      } catch {
+        // Performance schema may not be available
+      }
 
-            // Get duplicate/redundant indexes
-            let duplicateIndexes: unknown[] = [];
-            try {
-                const dupResult = await adapter.executeQuery(`
+      // Get duplicate/redundant indexes
+      let duplicateIndexes: unknown[] = [];
+      try {
+        const dupResult = await adapter.executeQuery(
+          `
                     SELECT 
                         a.TABLE_NAME as table_name,
                         a.INDEX_NAME as redundant_index,
@@ -80,19 +93,21 @@ export function createIndexesResource(adapter: MySQLAdapter): ResourceDefinition
                       AND a.SEQ_IN_INDEX = 1
                       AND (a.INDEX_NAME != 'PRIMARY' AND b.INDEX_NAME != 'PRIMARY')
                     GROUP BY a.TABLE_NAME, a.INDEX_NAME, a.COLUMN_NAME, b.INDEX_NAME
-                `, [database]);
-                duplicateIndexes = dupResult.rows ?? [];
-            } catch {
-                // May fail on older MySQL versions
-            }
+                `,
+          [database],
+        );
+        duplicateIndexes = dupResult.rows ?? [];
+      } catch {
+        // May fail on older MySQL versions
+      }
 
-            return {
-                database,
-                total_indexes: (indexResult.rows ?? []).length,
-                indexes: indexResult.rows ?? [],
-                unused_indexes: unusedIndexes,
-                potential_duplicates: duplicateIndexes
-            };
-        }
-    };
+      return {
+        database,
+        total_indexes: (indexResult.rows ?? []).length,
+        indexes: indexResult.rows ?? [],
+        unused_indexes: unusedIndexes,
+        potential_duplicates: duplicateIndexes,
+      };
+    },
+  };
 }

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

@@ -1,35 +1,43 @@
 /**
  * MySQL Resource - InnoDB
- * 
+ *
  * InnoDB buffer pool and engine status metrics.
  */
-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 createInnodbResource(adapter: MySQLAdapter): ResourceDefinition {
-    return {
-        uri: 'mysql://innodb',
-        name: 'InnoDB Status',
-        title: 'MySQL InnoDB Status',
-        description: 'InnoDB buffer pool statistics and engine status',
-        mimeType: 'application/json',
-        annotations: {
-            audience: ['user', 'assistant'],
-            priority: 0.7
-        },
-        handler: async (_uri: string, _context: RequestContext) => {
-            // Get buffer pool status
-            const bufferPoolResult = await adapter.executeQuery(`
+export function createInnodbResource(
+  adapter: MySQLAdapter,
+): ResourceDefinition {
+  return {
+    uri: "mysql://innodb",
+    name: "InnoDB Status",
+    title: "MySQL InnoDB Status",
+    description: "InnoDB buffer pool statistics and engine status",
+    mimeType: "application/json",
+    annotations: {
+      audience: ["user", "assistant"],
+      priority: 0.7,
+    },
+    handler: async (_uri: string, _context: RequestContext) => {
+      // Get buffer pool status
+      const bufferPoolResult = await adapter.executeQuery(`
                 SHOW GLOBAL STATUS WHERE Variable_name LIKE 'Innodb_buffer_pool%'
             `);
 
-            const bufferPool: Record<string, number> = {};
-            for (const row of bufferPoolResult.rows ?? []) {
-                bufferPool[row['Variable_name'] as string] = parseInt(row['Value'] as string, 10);
-            }
+      const bufferPool: Record<string, number> = {};
+      for (const row of bufferPoolResult.rows ?? []) {
+        bufferPool[row["Variable_name"] as string] = parseInt(
+          row["Value"] as string,
+          10,
+        );
+      }
 
-            // Get buffer pool size configuration
-            const configResult = await adapter.executeQuery(`
+      // Get buffer pool size configuration
+      const configResult = await adapter.executeQuery(`
                 SHOW GLOBAL VARIABLES WHERE Variable_name IN (
                     'innodb_buffer_pool_size', 'innodb_buffer_pool_instances',
                     'innodb_log_file_size', 'innodb_log_files_in_group',
@@ -37,13 +45,13 @@ export function createInnodbResource(adapter: MySQLAdapter): ResourceDefinition
                 )
             `);
 
-            const config: Record<string, string> = {};
-            for (const row of configResult.rows ?? []) {
-                config[row['Variable_name'] as string] = row['Value'] as string;
-            }
+      const config: Record<string, string> = {};
+      for (const row of configResult.rows ?? []) {
+        config[row["Variable_name"] as string] = row["Value"] as string;
+      }
 
-            // Get row operations
-            const opsResult = await adapter.executeQuery(`
+      // Get row operations
+      const opsResult = await adapter.executeQuery(`
                 SHOW GLOBAL STATUS WHERE Variable_name IN (
                     'Innodb_rows_read', 'Innodb_rows_inserted', 
                     'Innodb_rows_updated', 'Innodb_rows_deleted',
@@ -52,59 +60,68 @@ export function createInnodbResource(adapter: MySQLAdapter): ResourceDefinition
                 )
             `);
 
-            const operations: Record<string, number> = {};
-            for (const row of opsResult.rows ?? []) {
-                operations[row['Variable_name'] as string] = parseInt(row['Value'] as string, 10);
-            }
+      const operations: Record<string, number> = {};
+      for (const row of opsResult.rows ?? []) {
+        operations[row["Variable_name"] as string] = parseInt(
+          row["Value"] as string,
+          10,
+        );
+      }
 
-            // Calculate buffer pool efficiency
-            const readRequests = bufferPool['Innodb_buffer_pool_read_requests'] ?? 0;
-            const reads = bufferPool['Innodb_buffer_pool_reads'] ?? 0;
-            const hitRatio = readRequests > 0
-                ? Math.round(((readRequests - reads) / readRequests) * 100 * 100) / 100
-                : 100;
+      // Calculate buffer pool efficiency
+      const readRequests = bufferPool["Innodb_buffer_pool_read_requests"] ?? 0;
+      const reads = bufferPool["Innodb_buffer_pool_reads"] ?? 0;
+      const hitRatio =
+        readRequests > 0
+          ? Math.round(((readRequests - reads) / readRequests) * 100 * 100) /
+            100
+          : 100;
 
-            const pagesTotal = bufferPool['Innodb_buffer_pool_pages_total'] ?? 0;
-            const pagesFree = bufferPool['Innodb_buffer_pool_pages_free'] ?? 0;
-            const pagesData = bufferPool['Innodb_buffer_pool_pages_data'] ?? 0;
-            const pagesDirty = bufferPool['Innodb_buffer_pool_pages_dirty'] ?? 0;
+      const pagesTotal = bufferPool["Innodb_buffer_pool_pages_total"] ?? 0;
+      const pagesFree = bufferPool["Innodb_buffer_pool_pages_free"] ?? 0;
+      const pagesData = bufferPool["Innodb_buffer_pool_pages_data"] ?? 0;
+      const pagesDirty = bufferPool["Innodb_buffer_pool_pages_dirty"] ?? 0;
 
-            return {
-                buffer_pool: {
-                    size_bytes: parseInt(config['innodb_buffer_pool_size'] ?? '0', 10),
-                    instances: parseInt(config['innodb_buffer_pool_instances'] ?? '1', 10),
-                    hit_ratio_percent: hitRatio,
-                    pages: {
-                        total: pagesTotal,
-                        free: pagesFree,
-                        data: pagesData,
-                        dirty: pagesDirty,
-                        dirty_percent: pagesTotal > 0 ? Math.round((pagesDirty / pagesTotal) * 100) : 0
-                    },
-                    read_requests: readRequests,
-                    reads: reads,
-                    write_requests: bufferPool['Innodb_buffer_pool_write_requests'] ?? 0
-                },
-                configuration: {
-                    buffer_pool_size: config['innodb_buffer_pool_size'],
-                    log_file_size: config['innodb_log_file_size'],
-                    log_files_in_group: config['innodb_log_files_in_group'],
-                    flush_log_at_trx_commit: config['innodb_flush_log_at_trx_commit'],
-                    file_per_table: config['innodb_file_per_table']
-                },
-                row_operations: {
-                    reads: operations['Innodb_rows_read'] ?? 0,
-                    inserts: operations['Innodb_rows_inserted'] ?? 0,
-                    updates: operations['Innodb_rows_updated'] ?? 0,
-                    deletes: operations['Innodb_rows_deleted'] ?? 0
-                },
-                io: {
-                    data_reads: operations['Innodb_data_reads'] ?? 0,
-                    data_writes: operations['Innodb_data_writes'] ?? 0,
-                    log_writes: operations['Innodb_log_writes'] ?? 0,
-                    os_log_written: operations['Innodb_os_log_written'] ?? 0
-                }
-            };
-        }
-    };
+      return {
+        buffer_pool: {
+          size_bytes: parseInt(config["innodb_buffer_pool_size"] ?? "0", 10),
+          instances: parseInt(
+            config["innodb_buffer_pool_instances"] ?? "1",
+            10,
+          ),
+          hit_ratio_percent: hitRatio,
+          pages: {
+            total: pagesTotal,
+            free: pagesFree,
+            data: pagesData,
+            dirty: pagesDirty,
+            dirty_percent:
+              pagesTotal > 0 ? Math.round((pagesDirty / pagesTotal) * 100) : 0,
+          },
+          read_requests: readRequests,
+          reads: reads,
+          write_requests: bufferPool["Innodb_buffer_pool_write_requests"] ?? 0,
+        },
+        configuration: {
+          buffer_pool_size: config["innodb_buffer_pool_size"],
+          log_file_size: config["innodb_log_file_size"],
+          log_files_in_group: config["innodb_log_files_in_group"],
+          flush_log_at_trx_commit: config["innodb_flush_log_at_trx_commit"],
+          file_per_table: config["innodb_file_per_table"],
+        },
+        row_operations: {
+          reads: operations["Innodb_rows_read"] ?? 0,
+          inserts: operations["Innodb_rows_inserted"] ?? 0,
+          updates: operations["Innodb_rows_updated"] ?? 0,
+          deletes: operations["Innodb_rows_deleted"] ?? 0,
+        },
+        io: {
+          data_reads: operations["Innodb_data_reads"] ?? 0,
+          data_writes: operations["Innodb_data_writes"] ?? 0,
+          log_writes: operations["Innodb_log_writes"] ?? 0,
+          os_log_written: operations["Innodb_os_log_written"] ?? 0,
+        },
+      };
+    },
+  };
 }

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

@@ -1,24 +1,27 @@
 /**
  * MySQL Resource - Locks
  */
-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 createLocksResource(adapter: MySQLAdapter): ResourceDefinition {
-    return {
-        uri: 'mysql://locks',
-        name: 'Lock Contention',
-        title: 'MySQL Lock Contention',
-        description: 'Current InnoDB lock waits and blocking transactions',
-        mimeType: 'application/json',
-        annotations: {
-            audience: ['user', 'assistant'],
-            priority: 0.8
-        },
-        handler: async (_uri: string, _context: RequestContext) => {
-            try {
-                // Get current lock waits from performance_schema
-                const lockWaitsResult = await adapter.executeQuery(`
+  return {
+    uri: "mysql://locks",
+    name: "Lock Contention",
+    title: "MySQL Lock Contention",
+    description: "Current InnoDB lock waits and blocking transactions",
+    mimeType: "application/json",
+    annotations: {
+      audience: ["user", "assistant"],
+      priority: 0.8,
+    },
+    handler: async (_uri: string, _context: RequestContext) => {
+      try {
+        // Get current lock waits from performance_schema
+        const lockWaitsResult = await adapter.executeQuery(`
                     SELECT 
                         r.trx_id AS waiting_trx_id,
                         r.trx_mysql_thread_id AS waiting_thread,
@@ -33,32 +36,32 @@ export function createLocksResource(adapter: MySQLAdapter): ResourceDefinition {
                     LIMIT 20
                 `);
 
-                // Get global lock status
-                const lockStatusResult = await adapter.executeQuery(`
+        // Get global lock status
+        const lockStatusResult = await adapter.executeQuery(`
                     SHOW STATUS LIKE 'Innodb_row_lock%'
                 `);
 
-                const lockStats: Record<string, unknown> = {};
-                for (const row of (lockStatusResult.rows ?? [])) {
-                    const varName = row['Variable_name'];
-                    if (typeof varName === 'string') {
-                        lockStats[varName] = row['Value'];
-                    }
-                }
-
-                return {
-                    currentLockWaits: lockWaitsResult.rows?.length ?? 0,
-                    lockWaits: lockWaitsResult.rows ?? [],
-                    lockStatistics: lockStats
-                };
-            } catch {
-                return {
-                    currentLockWaits: 0,
-                    lockWaits: [],
-                    lockStatistics: {},
-                    error: 'Unable to retrieve lock information'
-                };
-            }
+        const lockStats: Record<string, unknown> = {};
+        for (const row of lockStatusResult.rows ?? []) {
+          const varName = row["Variable_name"];
+          if (typeof varName === "string") {
+            lockStats[varName] = row["Value"];
+          }
         }
-    };
+
+        return {
+          currentLockWaits: lockWaitsResult.rows?.length ?? 0,
+          lockWaits: lockWaitsResult.rows ?? [],
+          lockStatistics: lockStats,
+        };
+      } catch {
+        return {
+          currentLockWaits: 0,
+          lockWaits: [],
+          lockStatistics: {},
+          error: "Unable to retrieve lock information",
+        };
+      }
+    },
+  };
 }

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

@@ -1,25 +1,30 @@
 /**
  * MySQL Resource - Performance
- * 
+ *
  * Query performance metrics and slow query information.
  */
-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 createPerformanceResource(adapter: MySQLAdapter): ResourceDefinition {
-    return {
-        uri: 'mysql://performance',
-        name: 'Performance Metrics',
-        title: 'MySQL Performance Metrics',
-        description: 'Query performance statistics and slow query analysis',
-        mimeType: 'application/json',
-        annotations: {
-            audience: ['user', 'assistant'],
-            priority: 0.8
-        },
-        handler: async (_uri: string, _context: RequestContext) => {
-            // Get performance-related status variables
-            const statusResult = await adapter.executeQuery(`
+export function createPerformanceResource(
+  adapter: MySQLAdapter,
+): ResourceDefinition {
+  return {
+    uri: "mysql://performance",
+    name: "Performance Metrics",
+    title: "MySQL Performance Metrics",
+    description: "Query performance statistics and slow query analysis",
+    mimeType: "application/json",
+    annotations: {
+      audience: ["user", "assistant"],
+      priority: 0.8,
+    },
+    handler: async (_uri: string, _context: RequestContext) => {
+      // Get performance-related status variables
+      const statusResult = await adapter.executeQuery(`
                 SHOW GLOBAL STATUS WHERE Variable_name IN (
                     'Queries', 'Questions', 'Slow_queries',
                     'Select_full_join', 'Select_range_check', 'Select_scan',
@@ -30,15 +35,18 @@ export function createPerformanceResource(adapter: MySQLAdapter): ResourceDefini
                 )
             `);
 
-            const status: Record<string, number> = {};
-            for (const row of statusResult.rows ?? []) {
-                status[row['Variable_name'] as string] = parseInt(row['Value'] as string, 10);
-            }
+      const status: Record<string, number> = {};
+      for (const row of statusResult.rows ?? []) {
+        status[row["Variable_name"] as string] = parseInt(
+          row["Value"] as string,
+          10,
+        );
+      }
 
-            // Get performance schema if available (MySQL 5.6+)
-            let topQueries: unknown[] = [];
-            try {
-                const perfResult = await adapter.executeQuery(`
+      // Get performance schema if available (MySQL 5.6+)
+      let topQueries: unknown[] = [];
+      try {
+        const perfResult = await adapter.executeQuery(`
                     SELECT 
                         DIGEST_TEXT as query_pattern,
                         COUNT_STAR as execution_count,
@@ -52,49 +60,54 @@ export function createPerformanceResource(adapter: MySQLAdapter): ResourceDefini
                     ORDER BY SUM_TIMER_WAIT DESC
                     LIMIT 10
                 `);
-                topQueries = perfResult.rows ?? [];
-            } catch {
-                // Performance schema may not be available
-            }
+        topQueries = perfResult.rows ?? [];
+      } catch {
+        // Performance schema may not be available
+      }
 
-            // Calculate derived metrics
-            const tmpTablesCreated = status['Created_tmp_tables'] ?? 0;
-            const tmpDiskRatio = tmpTablesCreated > 0
-                ? Math.round(((status['Created_tmp_disk_tables'] ?? 0) / tmpTablesCreated) * 100)
-                : 0;
+      // Calculate derived metrics
+      const tmpTablesCreated = status["Created_tmp_tables"] ?? 0;
+      const tmpDiskRatio =
+        tmpTablesCreated > 0
+          ? Math.round(
+              ((status["Created_tmp_disk_tables"] ?? 0) / tmpTablesCreated) *
+                100,
+            )
+          : 0;
 
-            const fullTableScans = status['Handler_read_rnd_next'] ?? 0;
-            const indexReads = status['Handler_read_key'] ?? 0;
-            const scanVsIndexRatio = (fullTableScans + indexReads) > 0
-                ? Math.round((fullTableScans / (fullTableScans + indexReads)) * 100)
-                : 0;
+      const fullTableScans = status["Handler_read_rnd_next"] ?? 0;
+      const indexReads = status["Handler_read_key"] ?? 0;
+      const scanVsIndexRatio =
+        fullTableScans + indexReads > 0
+          ? Math.round((fullTableScans / (fullTableScans + indexReads)) * 100)
+          : 0;
 
-            return {
-                summary: {
-                    total_queries: status['Queries'] ?? 0,
-                    slow_queries: status['Slow_queries'] ?? 0,
-                    tmp_tables_to_disk_percent: tmpDiskRatio,
-                    full_scan_percent: scanVsIndexRatio
-                },
-                sorts: {
-                    merge_passes: status['Sort_merge_passes'] ?? 0,
-                    range: status['Sort_range'] ?? 0,
-                    rows: status['Sort_rows'] ?? 0,
-                    scan: status['Sort_scan'] ?? 0
-                },
-                joins: {
-                    full_join: status['Select_full_join'] ?? 0,
-                    range_check: status['Select_range_check'] ?? 0,
-                    scan: status['Select_scan'] ?? 0
-                },
-                handler: {
-                    read_key: status['Handler_read_key'] ?? 0,
-                    read_rnd: status['Handler_read_rnd'] ?? 0,
-                    read_rnd_next: status['Handler_read_rnd_next'] ?? 0,
-                    write: status['Handler_write'] ?? 0
-                },
-                top_queries: topQueries
-            };
-        }
-    };
+      return {
+        summary: {
+          total_queries: status["Queries"] ?? 0,
+          slow_queries: status["Slow_queries"] ?? 0,
+          tmp_tables_to_disk_percent: tmpDiskRatio,
+          full_scan_percent: scanVsIndexRatio,
+        },
+        sorts: {
+          merge_passes: status["Sort_merge_passes"] ?? 0,
+          range: status["Sort_range"] ?? 0,
+          rows: status["Sort_rows"] ?? 0,
+          scan: status["Sort_scan"] ?? 0,
+        },
+        joins: {
+          full_join: status["Select_full_join"] ?? 0,
+          range_check: status["Select_range_check"] ?? 0,
+          scan: status["Select_scan"] ?? 0,
+        },
+        handler: {
+          read_key: status["Handler_read_key"] ?? 0,
+          read_rnd: status["Handler_read_rnd"] ?? 0,
+          read_rnd_next: status["Handler_read_rnd_next"] ?? 0,
+          write: status["Handler_write"] ?? 0,
+        },
+        top_queries: topQueries,
+      };
+    },
+  };
 }