@neverinfamous/mysql-mcp 2.1.0

package/dist/adapters/mysql/MySQLAdapter.js

@@ -0,0 +1,469 @@
+/**
+ * mysql-mcp - MySQL Adapter
+ *
+ * Main MySQL database adapter with connection pooling,
+ * query execution, and tool registration.
+ */
+import { DatabaseAdapter } from '../DatabaseAdapter.js';
+import { ConnectionPool } from '../../pool/ConnectionPool.js';
+import { ConnectionError, QueryError, TransactionError } from '../../types/index.js';
+import { logger } from '../../utils/logger.js';
+// Import tool modules
+import { getCoreTools } from './tools/core.js';
+import { getTransactionTools } from './tools/transactions.js';
+import { getJsonTools, getJsonHelperTools, getJsonEnhancedTools } from './tools/json/index.js';
+import { getTextTools, getFulltextTools } from './tools/text/index.js';
+import { getPerformanceTools, getOptimizationTools } from './tools/performance/index.js';
+import { getAdminTools, getMonitoringTools, getBackupTools } from './tools/admin/index.js';
+import { getReplicationTools } from './tools/replication.js';
+import { getPartitioningTools } from './tools/partitioning.js';
+import { getRouterTools } from './tools/router.js';
+import { getProxySQLTools } from './tools/proxysql.js';
+import { getShellTools } from './tools/shell/index.js';
+// New tool modules (9 new groups)
+import { getSchemaTools } from './tools/schema/index.js';
+import { getEventTools } from './tools/events.js';
+import { getSysSchemaTools } from './tools/sysschema/index.js';
+import { getStatsTools } from './tools/stats/index.js';
+import { getSpatialTools } from './tools/spatial/index.js';
+import { getSecurityTools } from './tools/security/index.js';
+import { getClusterTools } from './tools/cluster/index.js';
+import { getRoleTools } from './tools/roles.js';
+import { getDocStoreTools } from './tools/docstore.js';
+import { getMySQLResources } from './resources/index.js';
+import { getMySQLPrompts } from './prompts/index.js';
+import { SchemaManager } from './SchemaManager.js';
+/**
+ * MySQL Database Adapter
+ */
+export class MySQLAdapter extends DatabaseAdapter {
+    type = 'mysql';
+    name = 'MySQL Adapter';
+    version = '0.1.0';
+    pool = null;
+    activeTransactions = new Map();
+    cachedToolDefinitions = null;
+    schemaManager = new SchemaManager(this);
+    // =========================================================================
+    // Connection Lifecycle
+    // =========================================================================
+    async connect(config) {
+        if (this.connected) {
+            logger.warn('Already connected');
+            return;
+        }
+        // Build pool configuration
+        const poolConfig = {
+            host: config.host ?? 'localhost',
+            port: config.port ?? 3306,
+            user: config.username ?? 'root',
+            password: config.password ?? '',
+            database: config.database ?? '',
+            pool: config.pool,
+            ssl: config.options?.ssl,
+            charset: config.options?.charset ?? 'utf8mb4',
+            timezone: config.options?.timezone ?? 'local',
+            connectTimeout: config.options?.connectTimeout ?? 10000
+        };
+        this.pool = new ConnectionPool(poolConfig);
+        try {
+            await this.pool.initialize();
+            this.connected = true;
+            logger.info('MySQL adapter connected', {
+                host: poolConfig.host,
+                port: poolConfig.port,
+                database: poolConfig.database
+            });
+        }
+        catch (error) {
+            this.pool = null;
+            throw new ConnectionError(`Failed to connect: ${String(error)}`);
+        }
+    }
+    async disconnect() {
+        if (!this.connected || !this.pool) {
+            return;
+        }
+        // Close any active transactions
+        for (const [id, conn] of this.activeTransactions) {
+            try {
+                await conn.rollback();
+                logger.warn(`Rolled back orphaned transaction: ${id}`);
+            }
+            catch (error) {
+                logger.warn(`Failed to rollback orphaned transaction ${id}: ${String(error)}`);
+            }
+            finally {
+                try {
+                    conn.release();
+                }
+                catch {
+                    // Ignore release errors
+                }
+            }
+        }
+        this.activeTransactions.clear();
+        await this.pool.shutdown();
+        this.pool = null;
+        this.connected = false;
+        logger.info('MySQL adapter disconnected');
+    }
+    async getHealth() {
+        if (!this.pool) {
+            return {
+                connected: false,
+                error: 'Not connected'
+            };
+        }
+        return this.pool.checkHealth();
+    }
+    // =========================================================================
+    // Query Execution
+    // =========================================================================
+    async executeReadQuery(sql, params, transactionId) {
+        this.validateQuery(sql, true);
+        return this.executeQuery(sql, params, transactionId);
+    }
+    async executeWriteQuery(sql, params, transactionId) {
+        this.validateQuery(sql, false);
+        return this.executeQuery(sql, params, transactionId);
+    }
+    async executeQuery(sql, params, transactionId) {
+        if (!this.pool) {
+            throw new ConnectionError('Not connected to database');
+        }
+        if (transactionId) {
+            const conn = this.getTransactionConnection(transactionId);
+            if (!conn) {
+                throw new TransactionError(`Invalid transaction ID: ${transactionId}`);
+            }
+            return this.executeOnConnection(conn, sql, params);
+        }
+        const startTime = Date.now();
+        try {
+            const [results, fields] = await this.pool.execute(sql, params);
+            return this.processExecutionResult(results, fields, startTime);
+        }
+        catch (error) {
+            if (this.isUnsupportedPreparedStatementError(error)) {
+                // Fallback to text protocol for statements not supported in prepared mode
+                try {
+                    const [results, fields] = await this.pool.query(sql, params);
+                    return this.processExecutionResult(results, fields, startTime);
+                }
+                catch (fallbackError) {
+                    const err = fallbackError;
+                    throw new QueryError(`Query fallback failed: ${err.message}`, { sql });
+                }
+            }
+            const err = error;
+            throw new QueryError(`Query failed: ${err.message}`, { sql });
+        }
+    }
+    /**
+     * Execute a query on a specific connection (for transactions)
+     */
+    async executeOnConnection(connection, sql, params) {
+        const startTime = Date.now();
+        try {
+            const [results, fields] = await connection.execute(sql, params);
+            return this.processExecutionResult(results, fields, startTime);
+        }
+        catch (error) {
+            if (this.isUnsupportedPreparedStatementError(error)) {
+                // Fallback to text protocol
+                try {
+                    const [results, fields] = await connection.query(sql, params);
+                    return this.processExecutionResult(results, fields, startTime);
+                }
+                catch (fallbackError) {
+                    const err = fallbackError;
+                    throw new QueryError(`Query fallback failed: ${err.message}`, { sql });
+                }
+            }
+            const err = error;
+            throw new QueryError(`Query failed: ${err.message}`, { sql });
+        }
+    }
+    /**
+     * Execute raw SQL using query() instead of execute()
+     * Use this for commands not supported in prepared statement protocol:
+     * - CHECK TABLE, SAVEPOINT, RELEASE SAVEPOINT, ROLLBACK TO SAVEPOINT
+     * - SHOW commands with LIKE patterns
+     */
+    async rawQuery(sql) {
+        if (!this.pool) {
+            throw new ConnectionError('Not connected');
+        }
+        const startTime = Date.now();
+        try {
+            // Use query() which doesn't use prepared statements
+            // Unlike execute(), query() is required for certain MySQL commands
+            const [results, fields] = await this.pool.query(sql);
+            return this.processExecutionResult(results, fields, startTime);
+        }
+        catch (error) {
+            const err = error;
+            throw new QueryError(`Raw query failed: ${err.message}`, { sql });
+        }
+    }
+    // =========================================================================
+    // Transaction Support
+    // =========================================================================
+    /**
+     * Begin a transaction
+     */
+    async beginTransaction(isolationLevel) {
+        if (!this.pool) {
+            throw new ConnectionError('Not connected');
+        }
+        const connection = await this.pool.getConnection();
+        const transactionId = crypto.randomUUID();
+        try {
+            if (isolationLevel) {
+                await connection.execute(`SET TRANSACTION ISOLATION LEVEL ${isolationLevel}`);
+            }
+            await connection.beginTransaction();
+            this.activeTransactions.set(transactionId, connection);
+            return transactionId;
+        }
+        catch (error) {
+            connection.release();
+            throw new TransactionError(`Failed to begin transaction: ${String(error)}`);
+        }
+    }
+    /**
+     * Commit a transaction
+     */
+    async commitTransaction(transactionId) {
+        const connection = this.activeTransactions.get(transactionId);
+        if (!connection) {
+            throw new TransactionError(`Transaction not found: ${transactionId}`);
+        }
+        try {
+            await connection.commit();
+        }
+        finally {
+            connection.release();
+            this.activeTransactions.delete(transactionId);
+        }
+    }
+    /**
+     * Rollback a transaction
+     */
+    async rollbackTransaction(transactionId) {
+        const connection = this.activeTransactions.get(transactionId);
+        if (!connection) {
+            throw new TransactionError(`Transaction not found: ${transactionId}`);
+        }
+        try {
+            await connection.rollback();
+        }
+        finally {
+            connection.release();
+            this.activeTransactions.delete(transactionId);
+        }
+    }
+    /**
+     * Get connection for a transaction
+     */
+    getTransactionConnection(transactionId) {
+        return this.activeTransactions.get(transactionId);
+    }
+    // =========================================================================
+    // Schema Operations
+    // =========================================================================
+    async getSchema() {
+        return this.schemaManager.getSchema();
+    }
+    async listTables(databaseName) {
+        return this.schemaManager.listTables(databaseName);
+    }
+    async describeTable(tableName) {
+        return this.schemaManager.describeTable(tableName);
+    }
+    async listSchemas() {
+        return this.schemaManager.listSchemas();
+    }
+    /**
+     * Get indexes for a table
+     */
+    async getTableIndexes(tableName) {
+        return this.schemaManager.getTableIndexes(tableName);
+    }
+    // =========================================================================
+    // Capabilities
+    // =========================================================================
+    getCapabilities() {
+        return {
+            json: true,
+            fullTextSearch: true,
+            vector: false, // MySQL doesn't have native vector support
+            geospatial: true,
+            transactions: true,
+            preparedStatements: true,
+            connectionPooling: true,
+            partitioning: true,
+            replication: true
+        };
+    }
+    getSupportedToolGroups() {
+        return [
+            'core',
+            'json',
+            'text',
+            'fulltext',
+            'performance',
+            'optimization',
+            'admin',
+            'monitoring',
+            'backup',
+            'replication',
+            'partitioning',
+            'transactions',
+            'router',
+            'proxysql',
+            'shell',
+            // New groups (9)
+            'schema',
+            'events',
+            'sysschema',
+            'stats',
+            'spatial',
+            'security',
+            'cluster',
+            'roles',
+            'docstore'
+        ];
+    }
+    // =========================================================================
+    // Tool/Resource/Prompt Registration
+    // =========================================================================
+    getToolDefinitions() {
+        if (this.cachedToolDefinitions) {
+            return this.cachedToolDefinitions;
+        }
+        this.cachedToolDefinitions = [
+            ...getCoreTools(this),
+            ...getTransactionTools(this),
+            ...getJsonTools(this),
+            ...getJsonHelperTools(this),
+            ...getJsonEnhancedTools(this),
+            ...getTextTools(this),
+            ...getFulltextTools(this),
+            ...getPerformanceTools(this),
+            ...getOptimizationTools(this),
+            ...getAdminTools(this),
+            ...getMonitoringTools(this),
+            ...getBackupTools(this),
+            ...getReplicationTools(this),
+            ...getPartitioningTools(this),
+            ...getRouterTools(this),
+            ...getProxySQLTools(this),
+            ...getShellTools(this),
+            // New tool groups (9 groups, 80 tools)
+            ...getSchemaTools(this),
+            ...getEventTools(this),
+            ...getSysSchemaTools(this),
+            ...getStatsTools(this),
+            ...getSpatialTools(this),
+            ...getSecurityTools(this),
+            ...getClusterTools(this),
+            ...getRoleTools(this),
+            ...getDocStoreTools(this)
+        ];
+        return this.cachedToolDefinitions;
+    }
+    getResourceDefinitions() {
+        return getMySQLResources(this);
+    }
+    getPromptDefinitions() {
+        return getMySQLPrompts(this);
+    }
+    // =========================================================================
+    // Helpers
+    // =========================================================================
+    /**
+     * Get the connection pool (for monitoring tools)
+     */
+    getPool() {
+        return this.pool;
+    }
+    /**
+     * Check if error is due to unsupported prepared statement
+     */
+    isUnsupportedPreparedStatementError(error) {
+        const err = error;
+        const code = err?.code;
+        const message = typeof err?.message === 'string' ? err.message : '';
+        // Message is e.g.: "Execute failed: This command is not supported..."
+        // No debug throw needed now
+        return (code === 'ER_UNSUPPORTED_PS' ||
+            message.toLowerCase().includes('not supported') ||
+            message.includes('ER_UNSUPPORTED_PS'));
+    }
+    /**
+     * Process execution results into QueryResult
+     */
+    /**
+     * Process execution results into QueryResult
+     */
+    processExecutionResult(results, fields, startTime) {
+        const executionTimeMs = Date.now() - startTime;
+        if (Array.isArray(results)) {
+            return {
+                rows: results,
+                executionTimeMs,
+                columns: Array.isArray(fields) ? fields.map(f => ({
+                    name: f.name,
+                    type: this.getTypeName(f.type ?? 0)
+                })) : undefined
+            };
+        }
+        const resultInfo = results;
+        return {
+            rowsAffected: resultInfo.affectedRows,
+            lastInsertId: resultInfo.insertId,
+            warningCount: resultInfo.warningStatus,
+            executionTimeMs
+        };
+    }
+    /**
+     * Convert MySQL type number to name
+     */
+    getTypeName(typeNum) {
+        // MySQL type constants
+        const types = {
+            0: 'DECIMAL',
+            1: 'TINYINT',
+            2: 'SMALLINT',
+            3: 'INT',
+            4: 'FLOAT',
+            5: 'DOUBLE',
+            6: 'NULL',
+            7: 'TIMESTAMP',
+            8: 'BIGINT',
+            9: 'MEDIUMINT',
+            10: 'DATE',
+            11: 'TIME',
+            12: 'DATETIME',
+            13: 'YEAR',
+            14: 'NEWDATE',
+            15: 'VARCHAR',
+            16: 'BIT',
+            245: 'JSON',
+            246: 'NEWDECIMAL',
+            247: 'ENUM',
+            248: 'SET',
+            249: 'TINYBLOB',
+            250: 'MEDIUMBLOB',
+            251: 'LONGBLOB',
+            252: 'BLOB',
+            253: 'VARCHAR',
+            254: 'CHAR',
+            255: 'GEOMETRY'
+        };
+        return types[typeNum] ?? `UNKNOWN(${typeNum})`;
+    }
+}
+//# sourceMappingURL=MySQLAdapter.js.map

package/dist/adapters/mysql/MySQLAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLAdapter.js","sourceRoot":"","sources":["../../../src/adapters/mysql/MySQLAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/mysql/SchemaManager.d.ts

@@ -0,0 +1,36 @@
+import type { QueryResult, TableInfo, SchemaInfo, IndexInfo } from '../../types/index.js';
+export interface QueryExecutor {
+    executeQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+}
+export declare class SchemaManager {
+    private executor;
+    private metadataCache;
+    private cacheTtlMs;
+    constructor(executor: QueryExecutor);
+    /**
+     * Get cached value if not expired
+     */
+    private getCached;
+    /**
+     * Set cache value
+     */
+    private setCache;
+    /**
+     * Clear all cached metadata (useful after schema changes)
+     */
+    clearCache(): void;
+    getSchema(): Promise<SchemaInfo>;
+    /**
+     * Get all indexes across all tables in a single query
+     * Performance optimization: eliminates N+1 query pattern
+     */
+    private getAllIndexes;
+    listTables(databaseName?: string): Promise<TableInfo[]>;
+    describeTable(tableName: string): Promise<TableInfo>;
+    listSchemas(): Promise<string[]>;
+    /**
+     * Get indexes for a table
+     */
+    getTableIndexes(tableName: string): Promise<IndexInfo[]>;
+}
+//# sourceMappingURL=SchemaManager.d.ts.map

package/dist/adapters/mysql/SchemaManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaManager.d.ts","sourceRoot":"","sources":["../../../src/adapters/mysql/SchemaManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAc,MAAM,sBAAsB,CAAC;AAGtG,MAAM,WAAW,aAAa;IAC1B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACvE;AAYD,qBAAa,aAAa;IAIV,OAAO,CAAC,QAAQ;IAH5B,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,UAAU,CAAwB;gBAEtB,QAAQ,EAAE,aAAa;IAE3C;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIZ,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAetC;;;OAGG;YACW,aAAa;IAiDrB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAmCvD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA4EpD,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQtC;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAwDjE"}