@berthojoris/mcp-mysql-server 1.35.0 → 1.36.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to the MySQL MCP Server will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.36.0] - 2026-03-05
+
+### Removed
+- **Data Migration Tools**: Removed 5 unused tools from `migrationTools.ts` (`copy_table_data`, `move_table_data`, `clone_table`, `compare_table_structure`, `sync_table_data`)
+- **Import/Export Tools**: Removed 4 unused tools from `dataExportTools.ts` (`export_query_to_csv`, `export_query_to_json`, `export_table_to_sql`, `import_from_csv`)
+- **Backup & Restore Tools**: Removed 5 unused tools from `backupRestoreTools.ts` (`backup_table`, `backup_database`, `restore_from_sql`, `get_create_table_statement`, `get_database_schema`)
+- **Performance Monitoring Tools**: Removed 3 unused tools from `performanceTools.ts` (`get_top_queries_by_time`, `get_top_queries_by_count`, `get_slow_queries`)
+- **Server Management Tools**: Removed 4 unused tools from `processTools.ts` (`show_engine_status`, `get_server_info`, `show_binary_logs`, `show_replication_status`)
+
+### Changed
+- Updated tool registrations in `mcp-server.ts` to remove deleted tools
+- Updated DOCUMENTATIONS.md to reflect tool/category count changes (134 → 117 tools, 23 → 21 categories)
+- Updated README.md with new tool count (117 tools)
+- Bumped package version to `1.36.0`
+
 ## [1.35.0] - 2026-03-04
 
 ### Removed
@@ -14,6 +29,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Updated category filtering config by removing `DocCategory.AI_ENHANCEMENT` and related mappings.
 - Updated README.md and DOCUMENTATIONS.md tool/category listings and totals (150 → 134 tools).
+- Fixed DOCUMENTATIONS.md to replace "AI-Enhanced Analysis" category with "Analysis" category to match actual code implementation.
 - Bumped package version to `1.35.0`.
 
 ## [1.34.0] - 2026-03-04

package/DOCUMENTATIONS.md

@@ -1,8 +1,8 @@
 # MySQL MCP Server - Documentation
 
-**Last Updated:** 2026-03-04 12:00:00  
-**Version:** 1.35.0
-**Total Tools:** 134
+**Last Updated:** 2026-03-05 00:00:00
+**Version:** 1.36.0
+**Total Tools:** 117
 
 Comprehensive documentation for the MySQL MCP Server. For quick start, see [README.md](README.md).
 
@@ -99,8 +99,8 @@ Tool enabled = (Has Permission) AND (Has Category OR No categories specified)
 - `get_all_tables_relationships` - Get all FK relationships
 - `list_all_tools` - List available MCP tools
 
-### 2. AI-Enhanced Analysis (4 tools)
-- `get_database_summary` - AI-optimized database overview
+### 2. Analysis (4 tools)
+- `get_database_summary` - Database overview with statistics
 - `get_schema_erd` - Generate Mermaid.js ER diagram
 - `get_schema_rag_context` - Compact schema for LLM context
 - `get_column_statistics` - Column data profiling
@@ -194,11 +194,8 @@ Tool enabled = (Has Permission) AND (Has Category OR No categories specified)
 - `get_transaction_status` - Check transaction state
 - `execute_in_transaction` - Execute within transaction
 
-### 14. Performance Monitoring (10 tools)
+### 14. Performance Monitoring (7 tools)
 - `get_performance_metrics` - Get overall performance metrics
-- `get_top_queries_by_time` - Get queries by execution time
-- `get_top_queries_by_count` - Get queries by execution count
-- `get_slow_queries` - Get slow query log
 - `get_table_io_stats` - Get table I/O statistics
 - `get_index_usage_stats` - Get index usage statistics
 - `get_unused_indexes` - Find unused indexes
@@ -211,16 +208,12 @@ Tool enabled = (Has Permission) AND (Has Category OR No categories specified)
 - `get_optimization_hints` - Get optimizer hints
 - `repair_query` - Repair broken SQL queries
 
-### 16. Server Management (9 tools)
+### 16. Server Management (5 tools)
 - `show_process_list` - Show running processes
 - `kill_process` - Terminate processes
 - `show_status` - Server status variables
 - `show_variables` - Server configuration
 - `explain_query` - Query execution plan
-- `show_engine_status` - Storage engine status
-- `get_server_info` - Comprehensive server info
-- `show_binary_logs` - Show binary log files
-- `show_replication_status` - Show replication status
 
 ### 17. Cache Management (4 tools)
 - `get_cache_stats` - Query cache statistics
@@ -228,39 +221,21 @@ Tool enabled = (Has Permission) AND (Has Category OR No categories specified)
 - `configure_cache` - Configure cache settings
 - `clear_cache` - Clear cached results
 
-### 18. Data Export (6 tools)
+### 18. Data Export (4 tools)
 - `export_table_to_csv` - Export table to CSV
-- `export_query_to_csv` - Export query to CSV
 - `export_table_to_json` - Export table to JSON
-- `export_query_to_json` - Export query to JSON
 - `safe_export_table` - Export with PII masking
-- `export_table_to_sql` - Export table to SQL dump
 
-### 19. Backup & Restore (5 tools)
-- `backup_table` - Backup single table
-- `backup_database` - Backup entire database
-- `restore_from_sql` - Restore from SQL dump
-- `get_create_table_statement` - Get CREATE TABLE
-- `get_database_schema` - Get complete schema
-
-### 20. Utilities (4 tools)
+### 19. Utilities (4 tools)
 - `test_connection` - Test connectivity
 - `describe_connection` - Connection info
 - `read_changelog` - Read changelog
 - `invalidate_table_cache` - Clear table cache
 
-### 21. Data Import (2 tools)
-- `import_from_csv` - Import data from CSV file
+### 20. Data Import (1 tool)
 - `import_from_json` - Import data from JSON file
 
-### 22. Data Migration (5 tools)
-- `copy_table_data` - Copy data from one table to another
-- `move_table_data` - Move data between tables
-- `clone_table` - Clone a table with its structure and data
-- `compare_table_structure` - Compare structure between two tables
-- `sync_table_data` - Synchronize data between tables
-
-### 23. Schema Migrations (9 tools)
+### 21. Schema Migrations (9 tools)
 - `init_migrations_table` - Initialize migrations tracking table
 - `create_migration` - Create a new migration
 - `apply_migrations` - Apply pending migrations
@@ -346,9 +321,9 @@ await mcp.call("get_optimization_hints", {
 
 ## Advanced Features
 
-### AI-Enhanced Analysis
+### Analysis
 
-The server includes AI-optimized tools for intelligent database analysis:
+The server includes analysis tools for database insights:
 
 - **Database Summary**: Provides readable overviews with statistics
 - **ER Diagram Generation**: Automatic Mermaid.js diagrams

package/README.md

@@ -4,7 +4,7 @@
 
 **A production-ready Model Context Protocol (MCP) server for MySQL database integration with AI agents**
 
-**Last Updated:** 2026-03-04 12:00:00
+**Last Updated:** 2026-03-05 00:00:00
 
 [![npm version](https://img.shields.io/npm/v/@berthojoris/mcp-mysql-server)](https://www.npmjs.com/package/@berthojoris/mcp-mysql-server)
 [![npm downloads](https://img.shields.io/npm/dm/@berthojoris/mcp-mysql-server)](https://www.npmjs.com/package/@berthojoris/mcp-mysql-server)
@@ -284,7 +284,7 @@ Full category → tool mapping (and examples) lives in **[DOCUMENTATIONS.md →
 
 ## Available Tools
 
-The server exposes **134 tools** organized into categories (CRUD, schema, backups, migrations, and perf/monitoring).
+The server exposes **117 tools** organized into categories (CRUD, schema, migrations, and perf/monitoring).
 
 - Complete list of tools: **[DOCUMENTATIONS.md → Complete Tools Reference](DOCUMENTATIONS.md#🔧-complete-tools-reference)**
 

package/dist/index.d.ts

@@ -321,15 +321,6 @@ export declare class MySQLMCP {
         data?: any;
         error?: string;
     }>;
-    exportQueryToCSV(params: {
-        query: string;
-        params?: any[];
-        include_headers?: boolean;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
     exportTableToJSON(params: {
         table_name: string;
         filters?: any[];
@@ -348,26 +339,6 @@ export declare class MySQLMCP {
         data?: any;
         error?: string;
     }>;
-    exportQueryToJSON(params: {
-        query: string;
-        params?: any[];
-        pretty?: boolean;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    exportTableToSql(params: {
-        table_name: string;
-        filters?: any[];
-        include_create_table?: boolean;
-        batch_size?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
     importFromCSV(params: {
         table_name: string;
         csv_data: string;
@@ -393,111 +364,6 @@ export declare class MySQLMCP {
         data?: any;
         error?: string;
     }>;
-    backupTable(params: {
-        table_name: string;
-        include_data?: boolean;
-        include_drop?: boolean;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    backupDatabase(params: {
-        include_data?: boolean;
-        include_drop?: boolean;
-        tables?: string[];
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    restoreFromSql(params: {
-        sql_dump: string;
-        stop_on_error?: boolean;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    getCreateTableStatement(params: {
-        table_name: string;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    getDatabaseSchema(params: {
-        database?: string;
-        include_views?: boolean;
-        include_procedures?: boolean;
-        include_functions?: boolean;
-        include_triggers?: boolean;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    copyTableData(params: {
-        source_table: string;
-        target_table: string;
-        column_mapping?: Record<string, string>;
-        filters?: any[];
-        batch_size?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    moveTableData(params: {
-        source_table: string;
-        target_table: string;
-        column_mapping?: Record<string, string>;
-        filters?: any[];
-        batch_size?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    cloneTable(params: {
-        source_table: string;
-        new_table_name: string;
-        include_data?: boolean;
-        include_indexes?: boolean;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    compareTableStructure(params: {
-        table1: string;
-        table2: string;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    syncTableData(params: {
-        source_table: string;
-        target_table: string;
-        key_column: string;
-        columns_to_sync?: string[];
-        sync_mode?: "insert_only" | "update_only" | "upsert";
-        batch_size?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
     /**
      * Initialize the migrations tracking table
      */
@@ -1093,57 +959,11 @@ export declare class MySQLMCP {
         data?: any;
         error?: string;
     }>;
-    showEngineStatus(params?: {
-        engine?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    getServerInfo(): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    showBinaryLogs(): Promise<{
-        status: string;
-        data?: any[];
-        error?: string;
-    }>;
-    showReplicationStatus(params?: {
-        type?: "MASTER" | "REPLICA" | "SLAVE";
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
     getPerformanceMetrics(): Promise<{
         status: string;
         data?: any;
         error?: string;
     }>;
-    getTopQueriesByTime(params?: {
-        limit?: number;
-    }): Promise<{
-        status: string;
-        data?: any[];
-        error?: string;
-    }>;
-    getTopQueriesByCount(params?: {
-        limit?: number;
-    }): Promise<{
-        status: string;
-        data?: any[];
-        error?: string;
-    }>;
-    getSlowQueries(params?: {
-        limit?: number;
-        threshold_seconds?: number;
-    }): Promise<{
-        status: string;
-        data?: any[];
-        error?: string;
-    }>;
     getTableIOStats(params?: {
         limit?: number;
         table_schema?: string;

package/dist/index.js

@@ -346,13 +346,6 @@ class MySQLMCP {
         }
         return await this.dataExportTools.exportTableToCSV(params);
     }
-    async exportQueryToCSV(params) {
-        const check = this.checkToolEnabled("exportQueryToCSV");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.dataExportTools.exportQueryToCSV(params);
-    }
     // Extended Data Export Tools (JSON, SQL)
     async exportTableToJSON(params) {
         const check = this.checkToolEnabled("exportTableToJSON");
@@ -361,20 +354,6 @@ class MySQLMCP {
         }
         return await this.dataExportTools.exportTableToJSON(params);
     }
-    async exportQueryToJSON(params) {
-        const check = this.checkToolEnabled("exportQueryToJSON");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.dataExportTools.exportQueryToJSON(params);
-    }
-    async exportTableToSql(params) {
-        const check = this.checkToolEnabled("exportTableToSql");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.dataExportTools.exportTableToSql(params);
-    }
     // Data Import Tools
     async importFromCSV(params) {
         const check = this.checkToolEnabled("importFromCSV");
@@ -390,78 +369,6 @@ class MySQLMCP {
         }
         return await this.dataExportTools.importFromJSON(params);
     }
-    // Backup and Restore Tools
-    async backupTable(params) {
-        const check = this.checkToolEnabled("backupTable");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.backupRestoreTools.backupTable(params);
-    }
-    async backupDatabase(params) {
-        const check = this.checkToolEnabled("backupDatabase");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.backupRestoreTools.backupDatabase(params);
-    }
-    async restoreFromSql(params) {
-        const check = this.checkToolEnabled("restoreFromSql");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.backupRestoreTools.restoreFromSql(params);
-    }
-    async getCreateTableStatement(params) {
-        const check = this.checkToolEnabled("getCreateTableStatement");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.backupRestoreTools.getCreateTableStatement(params);
-    }
-    async getDatabaseSchema(params) {
-        const check = this.checkToolEnabled("getDatabaseSchema");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.backupRestoreTools.getDatabaseSchema(params);
-    }
-    // Data Migration Tools
-    async copyTableData(params) {
-        const check = this.checkToolEnabled("copyTableData");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.migrationTools.copyTableData(params);
-    }
-    async moveTableData(params) {
-        const check = this.checkToolEnabled("moveTableData");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.migrationTools.moveTableData(params);
-    }
-    async cloneTable(params) {
-        const check = this.checkToolEnabled("cloneTable");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.migrationTools.cloneTable(params);
-    }
-    async compareTableStructure(params) {
-        const check = this.checkToolEnabled("compareTableStructure");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.migrationTools.compareTableStructure(params);
-    }
-    async syncTableData(params) {
-        const check = this.checkToolEnabled("syncTableData");
-        if (!check.enabled) {
-            return { status: "error", error: check.error };
-        }
-        return await this.migrationTools.syncTableData(params);
-    }
     // ==========================================
     // Schema Versioning and Migrations Tools
     // ==========================================
@@ -998,30 +905,6 @@ class MySQLMCP {
             return { status: "error", error: check.error };
         return await this.processTools.explainQuery(params);
     }
-    async showEngineStatus(params) {
-        const check = this.checkToolEnabled("showEngineStatus");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.processTools.showEngineStatus(params);
-    }
-    async getServerInfo() {
-        const check = this.checkToolEnabled("getServerInfo");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.processTools.getServerInfo();
-    }
-    async showBinaryLogs() {
-        const check = this.checkToolEnabled("showBinaryLogs");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.processTools.showBinaryLogs();
-    }
-    async showReplicationStatus(params) {
-        const check = this.checkToolEnabled("showReplicationStatus");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.processTools.showReplicationStatus(params);
-    }
     // ==========================================
     // Performance Monitoring Tools
     // ==========================================
@@ -1031,24 +914,6 @@ class MySQLMCP {
             return { status: "error", error: check.error };
         return await this.performanceTools.getPerformanceMetrics();
     }
-    async getTopQueriesByTime(params) {
-        const check = this.checkToolEnabled("getTopQueriesByTime");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.performanceTools.getTopQueriesByTime(params);
-    }
-    async getTopQueriesByCount(params) {
-        const check = this.checkToolEnabled("getTopQueriesByCount");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.performanceTools.getTopQueriesByCount(params);
-    }
-    async getSlowQueries(params) {
-        const check = this.checkToolEnabled("getSlowQueries");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.performanceTools.getSlowQueries(params);
-    }
     async getTableIOStats(params) {
         const check = this.checkToolEnabled("getTableIOStats");
         if (!check.enabled)

package/dist/mcp-server.js

@@ -3174,9 +3174,6 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "export_table_to_csv":
                 result = await mysqlMCP.exportTableToCSV((args || {}));
                 break;
-            case "export_query_to_csv":
-                result = await mysqlMCP.exportQueryToCSV((args || {}));
-                break;
             // Cache Management Tools
             case "get_cache_stats":
                 result = mysqlMCP.getCacheStats();
@@ -3333,70 +3330,17 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "explain_query":
                 result = await mysqlMCP.explainQuery((args || {}));
                 break;
-            case "show_engine_status":
-                result = await mysqlMCP.showEngineStatus((args || {}));
-                break;
-            case "get_server_info":
-                result = await mysqlMCP.getServerInfo();
-                break;
-            case "show_binary_logs":
-                result = await mysqlMCP.showBinaryLogs();
-                break;
-            case "show_replication_status":
-                result = await mysqlMCP.showReplicationStatus((args || {}));
-                break;
-            // Backup and Restore Tools
-            case "backup_table":
-                result = await mysqlMCP.backupTable((args || {}));
-                break;
-            case "backup_database":
-                result = await mysqlMCP.backupDatabase((args || {}));
-                break;
-            case "restore_from_sql":
-                result = await mysqlMCP.restoreFromSql((args || {}));
-                break;
-            case "get_create_table_statement":
-                result = await mysqlMCP.getCreateTableStatement((args || {}));
-                break;
-            case "get_database_schema":
-                result = await mysqlMCP.getDatabaseSchema((args || {}));
-                break;
             // Extended Data Export Tools
             case "export_table_to_json":
                 result = await mysqlMCP.exportTableToJSON((args || {}));
                 break;
-            case "export_query_to_json":
-                result = await mysqlMCP.exportQueryToJSON((args || {}));
-                break;
             case "safe_export_table":
                 result = await mysqlMCP.safeExportTable((args || {}));
                 break;
-            case "export_table_to_sql":
-                result = await mysqlMCP.exportTableToSql((args || {}));
-                break;
             // Data Import Tools
-            case "import_from_csv":
-                result = await mysqlMCP.importFromCSV((args || {}));
-                break;
             case "import_from_json":
                 result = await mysqlMCP.importFromJSON((args || {}));
                 break;
-            // Data Migration Tools
-            case "copy_table_data":
-                result = await mysqlMCP.copyTableData((args || {}));
-                break;
-            case "move_table_data":
-                result = await mysqlMCP.moveTableData((args || {}));
-                break;
-            case "clone_table":
-                result = await mysqlMCP.cloneTable((args || {}));
-                break;
-            case "compare_table_structure":
-                result = await mysqlMCP.compareTableStructure((args || {}));
-                break;
-            case "sync_table_data":
-                result = await mysqlMCP.syncTableData((args || {}));
-                break;
             // Schema Versioning and Migrations Tools
             case "init_migrations_table":
                 result = await mysqlMCP.initMigrationsTable((args || {}));
@@ -3429,15 +3373,6 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "get_performance_metrics":
                 result = await mysqlMCP.getPerformanceMetrics();
                 break;
-            case "get_top_queries_by_time":
-                result = await mysqlMCP.getTopQueriesByTime((args || {}));
-                break;
-            case "get_top_queries_by_count":
-                result = await mysqlMCP.getTopQueriesByCount((args || {}));
-                break;
-            case "get_slow_queries":
-                result = await mysqlMCP.getSlowQueries((args || {}));
-                break;
             case "get_table_io_stats":
                 result = await mysqlMCP.getTableIOStats((args || {}));
                 break;