@berthojoris/mcp-mysql-server 1.35.0 → 1.37.0

package/CHANGELOG.md

@@ -5,6 +5,34 @@ 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.37.0] - 2026-03-06
+
+### Removed
+- **Documentation Categories**: Removed `import_export` and `data_migration` categories from documentation to reduce bundle size
+- **Import/Export Category** (6 tools): `export_query_to_json`, `export_table_to_json`, `export_table_to_sql`, `import_from_csv`, `import_from_json`, `safe_export_table`
+- **Data Migration Category** (5 tools): `clone_table`, `compare_table_structure`, `copy_table_data`, `move_table_data`, `sync_table_data`
+
+### Changed
+- Updated DOCUMENTATIONS.md to remove Data Export and Data Import sections (117 → 106 tools, 21 → 19 categories)
+- Updated README.md with new tool count (106 tools) and removed categories from Documentation Categories table
+- Updated package description to remove "data import/export" reference
+- Bumped package version to `1.37.0`
+
+## [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 +42,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-06 00:00:00
+**Version:** 1.37.0
+**Total Tools:** 106
 
 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,13 @@ 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)
-- `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)
+### 18. 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
-- `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)
+### 19. Schema Migrations (9 tools)
 - `init_migrations_table` - Initialize migrations tracking table
 - `create_migration` - Create a new migration
 - `apply_migrations` - Apply pending migrations
@@ -346,9 +313,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-06 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)
@@ -264,8 +264,6 @@ Use documentation categories to fine-tune which tools are exposed (Layer 2):
 | `cache_management` | Manage query cache and optimization | `clear_cache, configure_cache_settings, get_cache_config, get_cache_stats, invalidate_cache_for_table` |
 | `query_optimization` | Analyze and optimize SQL queries | `analyze_query, get_optimization_hints` |
 | `backup_restore` | Create backups and restore databases | `backup_database, backup_table, get_create_table_statement, get_database_schema, restore_from_sql` |
-| `import_export` | Import and export data in various formats | `export_query_to_json, export_table_to_json, export_table_to_sql, import_from_csv, import_from_json, safe_export_table` |
-| `data_migration` | Migrate data between databases or systems | `clone_table, compare_table_structure, copy_table_data, move_table_data, sync_table_data` |
 | `schema_migrations` | Version control for database schema changes | `apply_migrations, create_migration, generate_migration_from_diff, get_migration_status, get_schema_version, init_migrations_table, reset_failed_migration, rollback_migration, validate_migrations` |
 | `analysis` | Data analysis and reporting tools | `get_column_statistics, get_database_summary, get_schema_erd, get_schema_rag_context` |
 
@@ -273,7 +271,7 @@ Use documentation categories to fine-tune which tools are exposed (Layer 2):
   <summary>Copy/paste list (comma-separated, no spaces)</summary>
 
 ```text
-database_discovery,crud_operations,bulk_operations,custom_queries,schema_management,utilities,transaction_management,stored_procedures,views_management,triggers_management,functions_management,index_management,constraint_management,table_maintenance,server_management,performance_monitoring,cache_management,query_optimization,backup_restore,import_export,data_migration,schema_migrations,analysis
+database_discovery,crud_operations,bulk_operations,custom_queries,schema_management,utilities,transaction_management,stored_procedures,views_management,triggers_management,functions_management,index_management,constraint_management,table_maintenance,server_management,performance_monitoring,cache_management,query_optimization,backup_restore,schema_migrations,analysis
 ```
 
 </details>
@@ -284,7 +282,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 **106 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/config/featureConfig.d.ts

@@ -14,7 +14,7 @@ export declare enum ToolCategory {
     PROCEDURE = "procedure"
 }
 /**
- * Documentation categories from README (21 categories)
+ * Documentation categories from README (19 categories)
  * More intuitive and matches user mental model
  */
 export declare enum DocCategory {
@@ -37,8 +37,6 @@ export declare enum DocCategory {
     CACHE_MANAGEMENT = "cache_management",
     QUERY_OPTIMIZATION = "query_optimization",
     BACKUP_RESTORE = "backup_restore",
-    IMPORT_EXPORT = "import_export",
-    DATA_MIGRATION = "data_migration",
     SCHEMA_MIGRATIONS = "schema_migrations",
     ANALYSIS = "analysis"
 }

package/dist/config/featureConfig.js

@@ -24,7 +24,7 @@ var ToolCategory;
     ToolCategory["PROCEDURE"] = "procedure";
 })(ToolCategory || (exports.ToolCategory = ToolCategory = {}));
 /**
- * Documentation categories from README (21 categories)
+ * Documentation categories from README (19 categories)
  * More intuitive and matches user mental model
  */
 var DocCategory;
@@ -48,8 +48,6 @@ var DocCategory;
     DocCategory["CACHE_MANAGEMENT"] = "cache_management";
     DocCategory["QUERY_OPTIMIZATION"] = "query_optimization";
     DocCategory["BACKUP_RESTORE"] = "backup_restore";
-    DocCategory["IMPORT_EXPORT"] = "import_export";
-    DocCategory["DATA_MIGRATION"] = "data_migration";
     DocCategory["SCHEMA_MIGRATIONS"] = "schema_migrations";
     DocCategory["ANALYSIS"] = "analysis";
 })(DocCategory || (exports.DocCategory = DocCategory = {}));
@@ -331,19 +329,6 @@ exports.toolDocCategoryMap = {
     restoreFromSql: DocCategory.BACKUP_RESTORE,
     getCreateTableStatement: DocCategory.BACKUP_RESTORE,
     getDatabaseSchema: DocCategory.BACKUP_RESTORE,
-    // Import/Export
-    exportTableToJSON: DocCategory.IMPORT_EXPORT,
-    exportQueryToJSON: DocCategory.IMPORT_EXPORT,
-    exportTableToSql: DocCategory.IMPORT_EXPORT,
-    safe_export_table: DocCategory.IMPORT_EXPORT,
-    importFromCSV: DocCategory.IMPORT_EXPORT,
-    importFromJSON: DocCategory.IMPORT_EXPORT,
-    // Data Migration
-    copyTableData: DocCategory.DATA_MIGRATION,
-    moveTableData: DocCategory.DATA_MIGRATION,
-    cloneTable: DocCategory.DATA_MIGRATION,
-    compareTableStructure: DocCategory.DATA_MIGRATION,
-    syncTableData: DocCategory.DATA_MIGRATION,
     // Schema Migrations
     initMigrationsTable: DocCategory.SCHEMA_MIGRATIONS,
     createMigration: DocCategory.SCHEMA_MIGRATIONS,
@@ -390,18 +375,14 @@ const legacyToDocCategoryMap = {
     create: [
         DocCategory.CRUD_OPERATIONS,
         DocCategory.BULK_OPERATIONS,
-        DocCategory.IMPORT_EXPORT,
-        DocCategory.DATA_MIGRATION,
     ],
     update: [
         DocCategory.CRUD_OPERATIONS,
         DocCategory.BULK_OPERATIONS,
-        DocCategory.DATA_MIGRATION,
     ],
     delete: [
         DocCategory.CRUD_OPERATIONS,
         DocCategory.BULK_OPERATIONS,
-        DocCategory.DATA_MIGRATION,
     ],
     execute: [DocCategory.CUSTOM_QUERIES, DocCategory.SERVER_MANAGEMENT],
     ddl: [
@@ -412,7 +393,6 @@ const legacyToDocCategoryMap = {
         DocCategory.CONSTRAINT_MANAGEMENT,
         DocCategory.TABLE_MAINTENANCE,
         DocCategory.BACKUP_RESTORE,
-        DocCategory.DATA_MIGRATION,
         DocCategory.SCHEMA_MIGRATIONS,
     ],
     utility: [
@@ -422,7 +402,6 @@ const legacyToDocCategoryMap = {
         DocCategory.CACHE_MANAGEMENT,
         DocCategory.QUERY_OPTIMIZATION,
         DocCategory.BACKUP_RESTORE,
-        DocCategory.IMPORT_EXPORT,
     ],
     transaction: [DocCategory.TRANSACTION_MANAGEMENT],
     procedure: [DocCategory.STORED_PROCEDURES, DocCategory.FUNCTIONS_MANAGEMENT],

package/dist/index.d.ts

@@ -321,183 +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[];
-        pagination?: {
-            page: number;
-            limit: number;
-        };
-        sorting?: {
-            field: string;
-            direction: "asc" | "desc";
-        };
-        pretty?: boolean;
-        database?: string;
-    }): Promise<{
-        status: string;
-        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;
-        has_headers?: boolean;
-        column_mapping?: Record<string, string>;
-        skip_errors?: boolean;
-        batch_size?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    importFromJSON(params: {
-        table_name: string;
-        json_data: string;
-        column_mapping?: Record<string, string>;
-        skip_errors?: boolean;
-        batch_size?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        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 +916,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;