@berthojoris/mcp-mysql-server 1.33.5 → 1.35.0

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.35.0] - 2026-03-04
+
+### Removed
+- Removed AI enhancement category (`ai_enhancement`) and 16 AI tools from MCP exposure and runtime routing.
+- Removed AI enhancement tool modules: intelligent query assistant, smart discovery, documentation generator, schema design, security audit, index recommendation, test data generation, schema pattern analysis, query visualization, and forecasting tools.
+
+### 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).
+- Bumped package version to `1.35.0`.
+
+## [1.34.0] - 2026-03-04
+
+### Removed
+- **REST API Server**: Removed `src/server.ts` and all REST API functionality to reduce bundle size and simplify the codebase
+- Removed unused dependencies: `express`, `cors`, `helmet`, `morgan`, `express-rate-limit`, `jsonwebtoken`
+- Removed unused devDependencies: `@types/cors`, `@types/express`, `@types/helmet`, `@types/morgan`, `@types/jsonwebtoken`
+- Removed npm scripts: `start:mcp`, `start:api`, `dev:mcp`, `dev:api` (consolidated to `start` and `dev`)
+- This reduces the package size and attack surface, focusing purely on MCP protocol via stdio
+
+### Changed
+- Simplified npm scripts: `start` now runs `mcp-server.js`, `dev` now runs `mcp-server.ts`
+
+## [1.33.6] - 2026-01-25
+
+### Documentation
+- **Added `"type": "stdio"` to all configuration examples**: Some MCP clients (like Droid CLI, Factory) require explicit `"type": "stdio"` in the configuration to establish proper connection
+- Updated README.md and DOCUMENTATIONS.md with the required `type` field in all JSON config examples
+- This fixes "disconnected" status issues when using the MCP server with certain AI agent clients
+
 ## [1.33.5] - 2026-01-25
 
 ### Fixed

package/DOCUMENTATIONS.md

@@ -1,8 +1,8 @@
 # MySQL MCP Server - Documentation
 
-**Last Updated:** 2026-01-25 11:30:00  
-**Version:** 1.33.5
-**Total Tools:** 150
+**Last Updated:** 2026-03-04 12:00:00  
+**Version:** 1.35.0
+**Total Tools:** 134
 
 Comprehensive documentation for the MySQL MCP Server. For quick start, see [README.md](README.md).
 
@@ -31,6 +31,7 @@ Configure MySQL MCP with two access-control layers:
   "mcpServers": {
     "mysql": {
       "command": "npx",
+      "type": "stdio",
       "args": [
         "-y",
         "@berthojoris/mcp-mysql-server",
@@ -270,24 +271,6 @@ Tool enabled = (Has Permission) AND (Has Category OR No categories specified)
 - `reset_failed_migration` - Reset a failed migration
 - `generate_migration_from_diff` - Generate migration from schema diff
 
-### 24. AI Enhancement (16 tools)
-- `build_query_from_intent` - Convert natural language to SQL
-- `suggest_query_improvements` - Suggest query optimizations
-- `smart_search` - Semantic search for tables, columns, data
-- `find_similar_columns` - Find columns similar to a given column
-- `discover_data_patterns` - Discover data patterns in tables
-- `generate_documentation` - Generate database documentation
-- `generate_data_dictionary` - Generate data dictionary for tables
-- `generate_business_glossary` - Generate business glossary
-- `design_schema_from_requirements` - Design schema from requirements
-- `audit_database_security` - Audit database security
-- `recommend_indexes` - Recommend indexes for optimization
-- `generate_test_data` - Generate test data for tables
-- `analyze_schema_patterns` - Analyze schema design patterns
-- `visualize_query` - Visualize query execution plan
-- `predict_query_performance` - Predict query performance
-- `forecast_database_growth` - Forecast database growth
-
 ---
 
 ## Core Operations

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-01-25 11:30:00
+**Last Updated:** 2026-03-04 12: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)
@@ -33,6 +33,7 @@ Add to your AI agent config (`.mcp.json`, `.cursor/mcp.json`, etc.):
   "mcpServers": {
     "mysql": {
       "command": "npx",
+      "type": "stdio",
       "args": [
         "-y",
         "@berthojoris/mcp-mysql-server",
@@ -124,6 +125,7 @@ If you want ready-to-copy snippets per client (Claude Code/Cursor/Windsurf/Cline
   "mcpServers": {
     "mysql": {
       "command": "npx",
+      "type": "stdio",
       "args": [
         "-y",
         "@berthojoris/mcp-mysql-server",
@@ -141,6 +143,7 @@ If you want ready-to-copy snippets per client (Claude Code/Cursor/Windsurf/Cline
   "mcpServers": {
     "mysql": {
       "command": "npx",
+      "type": "stdio",
       "args": [
         "-y",
         "@berthojoris/mcp-mysql-server",
@@ -166,6 +169,7 @@ Alternative approach using environment variables instead of connection string:
   "mcpServers": {
     "mysql": {
       "command": "npx",
+      "type": "stdio",
       "args": ["-y", "@berthojoris/mcp-mysql-server"],
       "env": {
         "DB_HOST": "localhost",
@@ -187,6 +191,7 @@ Alternative approach using environment variables instead of connection string:
   "mcpServers": {
     "mysql": {
       "command": "npx",
+      "type": "stdio",
       "args": ["-y", "@berthojoris/mcp-mysql-server"],
       "env": {
         "DB_HOST": "localhost",
@@ -263,13 +268,12 @@ Use documentation categories to fine-tune which tools are exposed (Layer 2):
 | `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` |
-| `ai_enhancement` | AI-powered features and smart automation | `analyze_schema_patterns, audit_database_security, build_query_from_intent, design_schema_from_requirements, discover_data_patterns, find_similar_columns, forecast_database_growth, generate_business_glossary, generate_data_dictionary, generate_documentation, generate_test_data, predict_query_performance, recommend_indexes, smart_search, suggest_query_improvements, visualize_query` |
 
 <details>
   <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,ai_enhancement
+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
 ```
 
 </details>
@@ -280,14 +284,9 @@ Full category → tool mapping (and examples) lives in **[DOCUMENTATIONS.md →
 
 ## Available Tools
 
-The server exposes **150 tools** organized into categories (CRUD, schema, backups, migrations, perf/monitoring, and AI enhancement).
+The server exposes **134 tools** organized into categories (CRUD, schema, backups, migrations, and perf/monitoring).
 
 - Complete list of tools: **[DOCUMENTATIONS.md → Complete Tools Reference](DOCUMENTATIONS.md#🔧-complete-tools-reference)**
-- AI enhancement tools overview: **[DOCUMENTATIONS.md → AI Enhancement Tools](DOCUMENTATIONS.md#🤖-ai-enhancement-tools)**
-
-### 🤖 AI Enhancement Tools
-
-The full **Phase 1–3 (implemented)** overview, examples, and per-tool documentation lives in **[DOCUMENTATIONS.md](DOCUMENTATIONS.md#🤖-ai-enhancement-tools)**.
 
 ---
 
@@ -303,7 +302,6 @@ For comprehensive documentation, see **[DOCUMENTATIONS.md](DOCUMENTATIONS.md)**:
 - **Schema Versioning** - Version control for database schema changes
 - **Transaction Management** - ACID transactions
 - **Stored Procedures** - Create and execute with IN/OUT/INOUT parameters
-- **🤖 AI Enhancement** - Natural language to SQL, smart data discovery, schema design, security audit, index recommendations, data generation, visualization, and forecasting (Phase 1-3)
 - **Query Logging** - See all SQL queries executed automatically
 - **Security Features** - Built-in security and best practices
 - **Bulk Operations** - High-performance batch processing

package/dist/config/featureConfig.d.ts

@@ -40,8 +40,7 @@ export declare enum DocCategory {
     IMPORT_EXPORT = "import_export",
     DATA_MIGRATION = "data_migration",
     SCHEMA_MIGRATIONS = "schema_migrations",
-    ANALYSIS = "analysis",
-    AI_ENHANCEMENT = "ai_enhancement"
+    ANALYSIS = "analysis"
 }
 /**
  * Map of tool names to their legacy categories

package/dist/config/featureConfig.js

@@ -52,7 +52,6 @@ var DocCategory;
     DocCategory["DATA_MIGRATION"] = "data_migration";
     DocCategory["SCHEMA_MIGRATIONS"] = "schema_migrations";
     DocCategory["ANALYSIS"] = "analysis";
-    DocCategory["AI_ENHANCEMENT"] = "ai_enhancement";
 })(DocCategory || (exports.DocCategory = DocCategory = {}));
 /**
  * Map of tool names to their legacy categories
@@ -198,25 +197,6 @@ exports.toolCategoryMap = {
     getConnectionPoolStats: ToolCategory.UTILITY,
     getDatabaseHealthCheck: ToolCategory.UTILITY,
     resetPerformanceStats: ToolCategory.UTILITY,
-    // Phase 1: AI Enhancement Tools
-    buildQueryFromIntent: ToolCategory.READ,
-    suggestQueryImprovements: ToolCategory.UTILITY,
-    smartSearch: ToolCategory.LIST,
-    findSimilarColumns: ToolCategory.LIST,
-    discoverDataPatterns: ToolCategory.READ,
-    generateDocumentation: ToolCategory.UTILITY,
-    generateDataDictionary: ToolCategory.UTILITY,
-    generateBusinessGlossary: ToolCategory.UTILITY,
-    // Phase 2: AI Enhancement Tools
-    designSchemaFromRequirements: ToolCategory.UTILITY,
-    auditDatabaseSecurity: ToolCategory.UTILITY,
-    recommendIndexes: ToolCategory.UTILITY,
-    // Phase 3: AI Enhancement Tools
-    generateTestData: ToolCategory.UTILITY,
-    analyzeSchemaPatterns: ToolCategory.UTILITY,
-    visualizeQuery: ToolCategory.UTILITY,
-    predictQueryPerformance: ToolCategory.UTILITY,
-    forecastDatabaseGrowth: ToolCategory.UTILITY,
     // Full-Text Search Tools
     createFulltextIndex: ToolCategory.DDL,
     fulltextSearch: ToolCategory.READ,
@@ -379,25 +359,6 @@ exports.toolDocCategoryMap = {
     getSchemaERD: DocCategory.ANALYSIS,
     getColumnStatistics: DocCategory.ANALYSIS,
     getSchemaRagContext: DocCategory.ANALYSIS,
-    // Phase 1: AI Enhancement
-    buildQueryFromIntent: DocCategory.AI_ENHANCEMENT,
-    suggestQueryImprovements: DocCategory.AI_ENHANCEMENT,
-    smartSearch: DocCategory.AI_ENHANCEMENT,
-    findSimilarColumns: DocCategory.AI_ENHANCEMENT,
-    discoverDataPatterns: DocCategory.AI_ENHANCEMENT,
-    generateDocumentation: DocCategory.AI_ENHANCEMENT,
-    generateDataDictionary: DocCategory.AI_ENHANCEMENT,
-    generateBusinessGlossary: DocCategory.AI_ENHANCEMENT,
-    // Phase 2: AI Enhancement
-    designSchemaFromRequirements: DocCategory.AI_ENHANCEMENT,
-    auditDatabaseSecurity: DocCategory.AI_ENHANCEMENT,
-    recommendIndexes: DocCategory.AI_ENHANCEMENT,
-    // Phase 3: AI Enhancement
-    generateTestData: DocCategory.AI_ENHANCEMENT,
-    analyzeSchemaPatterns: DocCategory.AI_ENHANCEMENT,
-    visualizeQuery: DocCategory.AI_ENHANCEMENT,
-    predictQueryPerformance: DocCategory.AI_ENHANCEMENT,
-    forecastDatabaseGrowth: DocCategory.AI_ENHANCEMENT,
     // Full-Text Search
     createFulltextIndex: DocCategory.INDEX_MANAGEMENT,
     fulltextSearch: DocCategory.INDEX_MANAGEMENT,

package/dist/index.d.ts

@@ -25,16 +25,6 @@ export declare class MySQLMCP {
     private analysisTools;
     private aiTools;
     private macroTools;
-    private intelligentQueryTools;
-    private smartDiscoveryTools;
-    private documentationGeneratorTools;
-    private schemaDesignTools;
-    private securityAuditTools;
-    private indexRecommendationTools;
-    private testDataTools;
-    private schemaPatternTools;
-    private queryVisualizationTools;
-    private forecastingTools;
     private smartQueryBuilderTools;
     private fulltextSearchTools;
     private security;
@@ -1192,387 +1182,6 @@ export declare class MySQLMCP {
         message?: string;
         error?: string;
     }>;
-    buildQueryFromIntent(params: {
-        natural_language: string;
-        context?: "analytics" | "reporting" | "data_entry" | "schema_exploration";
-        max_complexity?: "simple" | "medium" | "complex";
-        safety_level?: "strict" | "moderate" | "permissive";
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            generated_sql: string;
-            explanation: string;
-            tables_involved: string[];
-            columns_involved: string[];
-            estimated_complexity: string;
-            safety_notes: string[];
-            optimization_hints: string[];
-            alternatives?: string[];
-        };
-        error?: string;
-    }>;
-    suggestQueryImprovements(params: {
-        query: string;
-        optimization_goal?: "speed" | "memory" | "readability";
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            original_query: string;
-            suggestions: Array<{
-                type: string;
-                description: string;
-                improved_query?: string;
-            }>;
-            estimated_improvement: string;
-        };
-        error?: string;
-    }>;
-    smartSearch(params: {
-        search_term: string;
-        search_type?: "column" | "table" | "data_pattern" | "relationship" | "all";
-        similarity_threshold?: number;
-        include_sample_data?: boolean;
-        max_results?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            search_term: string;
-            search_type: string;
-            results: {
-                tables: Array<{
-                    name: string;
-                    relevance_score: number;
-                    match_reason: string;
-                    column_count: number;
-                    row_estimate: number;
-                    matching_columns?: string[];
-                }>;
-                columns: Array<{
-                    table_name: string;
-                    column_name: string;
-                    data_type: string;
-                    relevance_score: number;
-                    match_reason: string;
-                    sample_values?: any[];
-                }>;
-                data_patterns: Array<{
-                    table_name: string;
-                    column_name: string;
-                    pattern_type: string;
-                    description: string;
-                    sample_matches?: any[];
-                }>;
-                relationships: Array<{
-                    from_table: string;
-                    from_column: string;
-                    to_table: string;
-                    to_column: string;
-                    relationship_type: string;
-                    confidence: number;
-                }>;
-            };
-            total_matches: number;
-            search_time_ms: number;
-        };
-        error?: string;
-    }>;
-    findSimilarColumns(params: {
-        column_name?: string;
-        table_name?: string;
-        include_data_comparison?: boolean;
-        max_results?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            reference_column?: {
-                table: string;
-                column: string;
-                data_type: string;
-            };
-            similar_columns: Array<{
-                table_name: string;
-                column_name: string;
-                data_type: string;
-                similarity_score: number;
-                similarity_type: string;
-                data_overlap_percentage?: number;
-            }>;
-            potential_joins: Array<{
-                table1: string;
-                column1: string;
-                table2: string;
-                column2: string;
-                confidence: number;
-                reason: string;
-            }>;
-        };
-        error?: string;
-    }>;
-    discoverDataPatterns(params: {
-        table_name: string;
-        pattern_types?: Array<"unique" | "null" | "duplicate" | "format" | "range">;
-        max_columns?: number;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            table_name: string;
-            patterns: Array<{
-                column_name: string;
-                pattern_type: string;
-                description: string;
-                metrics?: Record<string, any>;
-                recommendations?: string[];
-            }>;
-            summary: {
-                columns_analyzed: number;
-                patterns_found: number;
-                data_quality_score: number;
-            };
-        };
-        error?: string;
-    }>;
-    generateDocumentation(params: {
-        scope?: "database" | "table" | "column" | "relationship";
-        table_name?: string;
-        include_business_glossary?: boolean;
-        format?: "markdown" | "html" | "json";
-        include_examples?: boolean;
-        include_statistics?: boolean;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            format: string;
-            scope: string;
-            content: string;
-            metadata: {
-                generated_at: string;
-                database: string;
-                tables_documented: number;
-                columns_documented: number;
-            };
-        };
-        error?: string;
-    }>;
-    generateDataDictionary(params: {
-        table_name: string;
-        include_sample_values?: boolean;
-        include_constraints?: boolean;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            table_name: string;
-            description: string;
-            columns: Array<{
-                name: string;
-                data_type: string;
-                description: string;
-                constraints: string[];
-                is_nullable: boolean;
-                default_value: string | null;
-                sample_values?: any[];
-                business_term?: string;
-            }>;
-            primary_key: string[];
-            foreign_keys: Array<{
-                column: string;
-                references_table: string;
-                references_column: string;
-            }>;
-            indexes: Array<{
-                name: string;
-                columns: string[];
-                is_unique: boolean;
-            }>;
-        };
-        error?: string;
-    }>;
-    generateBusinessGlossary(params: {
-        include_descriptions?: boolean;
-        group_by?: "table" | "category" | "alphabetical";
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            glossary: Array<{
-                term: string;
-                technical_name: string;
-                source_table: string;
-                data_type: string;
-                description: string;
-                category: string;
-                related_terms?: string[];
-            }>;
-            categories: string[];
-            total_terms: number;
-        };
-        error?: string;
-    }>;
-    designSchemaFromRequirements(params: {
-        requirements_text: string;
-        entities?: Array<{
-            name: string;
-            fields?: string[];
-        }>;
-        naming_convention?: "snake_case" | "camelCase";
-        include_audit_columns?: boolean;
-        id_type?: "BIGINT" | "UUID";
-        engine?: string;
-        charset?: string;
-        collation?: string;
-    }): Promise<{
-        status: string;
-        data?: {
-            input: {
-                requirements_text: string;
-                inferred_entities_count: number;
-            };
-            tables: Array<{
-                table_name: string;
-                columns: Array<{
-                    name: string;
-                    type: string;
-                    nullable: boolean;
-                    primary_key?: boolean;
-                    unique?: boolean;
-                    references?: {
-                        table: string;
-                        column: string;
-                    };
-                }>;
-                indexes: Array<{
-                    name: string;
-                    columns: string[];
-                    unique?: boolean;
-                }>;
-            }>;
-            relationships: Array<{
-                from_table: string;
-                from_column: string;
-                to_table: string;
-                to_column: string;
-                type: "one_to_many" | "many_to_one";
-            }>;
-            ddl_statements: string[];
-            notes: string[];
-        };
-        error?: string;
-    }>;
-    auditDatabaseSecurity(params?: {
-        database?: string;
-        include_user_account_checks?: boolean;
-        include_privilege_checks?: boolean;
-    }): Promise<{
-        status: string;
-        data?: {
-            database: string;
-            findings: Array<{
-                severity: "critical" | "medium" | "info" | "low" | "high";
-                title: string;
-                evidence?: string;
-                recommendation: string;
-            }>;
-            summary: {
-                critical: number;
-                high: number;
-                medium: number;
-                low: number;
-                info: number;
-            };
-            notes: string[];
-        };
-        error?: string;
-    }>;
-    recommendIndexes(params?: {
-        database?: string;
-        max_query_patterns?: number;
-        max_recommendations?: number;
-        min_execution_count?: number;
-        min_avg_time_ms?: number;
-        include_unused_index_warnings?: boolean;
-    }): Promise<{
-        status: string;
-        data?: {
-            database: string;
-            analyzed_query_patterns: number;
-            recommendations: Array<{
-                table_name: string;
-                columns: string[];
-                proposed_index_name: string;
-                create_index_sql: string;
-                reason: string;
-                supporting_query_patterns: Array<{
-                    query_pattern: string;
-                    execution_count: number;
-                    avg_execution_time_ms: number;
-                }>;
-            }>;
-            unused_index_warnings?: Array<{
-                table_schema: string;
-                table_name: string;
-                index_name: string;
-                note: string;
-            }>;
-            notes: string[];
-        };
-        error?: string;
-    }>;
-    generateTestData(params: {
-        table_name: string;
-        row_count: number;
-        batch_size?: number;
-        include_nulls?: boolean;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    analyzeSchemaPatterns(params?: {
-        scope?: "database" | "table";
-        table_name?: string;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    visualizeQuery(params: {
-        query: string;
-        include_explain_json?: boolean;
-        format?: "mermaid" | "json" | "both";
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    predictQueryPerformance(params: {
-        query: string;
-        row_growth_multiplier?: number;
-        per_table_row_growth?: Record<string, number>;
-        include_explain_json?: boolean;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    forecastDatabaseGrowth(params?: {
-        horizon_days?: number;
-        growth_rate_percent_per_day?: number;
-        growth_rate_percent_per_month?: number;
-        per_table_growth_rate_percent_per_day?: Record<string, number>;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
     startQueryBuilder(params: {
         intent: string;
         context?: "analytics" | "reporting" | "data_entry" | "schema_exploration";