@berthojoris/mcp-mysql-server 1.40.0 → 1.40.2

package/CHANGELOG.md

@@ -5,6 +5,46 @@ 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.40.2] - 2026-03-07
+
+### Removed
+- **Functions Management Category**: Removed category `functions_management` and all 6 tools
+  - `list_functions` - List user-defined functions
+  - `get_function_info` - Get function details
+  - `create_function` - Create function
+  - `drop_function` - Drop function
+  - `show_create_function` - Show CREATE FUNCTION statement
+  - `execute_function` - Execute function
+- **Backup & Restore Category**: Removed category `backup_restore` and all 5 tools
+  - `backup_table` - Backup a single table
+  - `backup_database` - Backup entire database
+  - `restore_from_sql` - Restore from SQL dump
+  - `get_create_table_statement` - Get CREATE TABLE statement
+  - `get_database_schema` - Get complete schema snapshot
+- Removed tool modules `src/tools/functionTools.ts` and `src/tools/backupRestoreTools.ts`
+
+### Changed
+- Updated tool count: 73 → 62 tools (-11 tools)
+- Updated category count: 15 → 13 categories (removed `functions_management`, `backup_restore`)
+- Updated `src/mcp-server.ts` to remove tool schemas and call routing for all 11 tools
+- Updated `src/index.ts` to remove MySQLMCP imports, fields, initialization, and methods for removed tool sets
+- Updated `src/config/featureConfig.ts` to remove enum values and category mappings for both categories
+- Updated CLI category help in `bin/mcp-mysql.js`
+- Updated `README.md` and `DOCUMENTATIONS.md` to reflect new category list and tool totals
+- Synchronized versions to `1.40.2` in `package.json`, `src/mcp-server.ts`, and `manifest.json`
+
+### Fixed
+- Updated procedure permission example in docs to reference `execute_stored_procedure` instead of removed function execution tool
+
+## [1.40.1] - 2026-03-06
+
+### Changed
+- Synchronized version metadata across `package.json`, `src/mcp-server.ts`, and `manifest.json` to `1.40.1`
+- Updated CLI category examples in `bin/mcp-mysql.js` to match active category set
+- Updated category examples in `README.md` and `DOCUMENTATIONS.md` to remove removed categories
+- Refactored tool registry filtering into `src/tools/toolRegistry.ts`
+- Refactored tool argument validation registry into `src/tools/toolArgumentValidation.ts`
+
 ## [1.40.0] - 2026-03-06
 
 ### Removed

package/DOCUMENTATIONS.md

@@ -1,8 +1,8 @@
 # MySQL MCP Server - Documentation
 
-**Last Updated:** 2026-03-06 00:00:00
-**Version:** 1.40.0
-**Total Tools:** 73
+**Last Updated:** 2026-03-07 10:30:00
+**Version:** 1.40.2
+**Total Tools:** 62
 
 Comprehensive documentation for the MySQL MCP Server. For quick start, see [README.md](README.md).
 
@@ -37,7 +37,7 @@ Configure MySQL MCP with two access-control layers:
         "@berthojoris/mcp-mysql-server",
         "mysql://user:password@localhost:3306/database",
         "list,read,utility",
-        "database_discovery,performance_monitoring"
+        "database_discovery,custom_queries,analysis"
       ]
     }
   }
@@ -58,7 +58,7 @@ Configure MySQL MCP with two access-control layers:
     "DB_PASSWORD": "your_password",
     "DB_NAME": "your_database",
     "MCP_PERMISSIONS": "list,read,utility",
-    "MCP_CATEGORIES": "database_discovery,performance_monitoring"
+    "MCP_CATEGORIES": "database_discovery,custom_queries,analysis"
   }
 }
 ```
@@ -80,7 +80,7 @@ Configure MySQL MCP with two access-control layers:
 | `ddl` | Schema changes | `create_table`, `alter_table` |
 | `utility` | Utility operations | `test_connection`, `analyze_table` |
 | `transaction` | Transaction management | `begin_transaction`, `commit_transaction` |
-| `procedure` | Stored procedures | `create_stored_procedure`, `execute_function` |
+| `procedure` | Stored procedures | `create_stored_procedure`, `execute_stored_procedure` |
 
 ### Filtering Logic
 
@@ -169,15 +169,7 @@ Tool enabled = (Has Permission) AND (Has Category OR No categories specified)
 - `drop_trigger` - Remove triggers
 - `show_create_trigger` - Show CREATE statement
 
-### 11. Functions Management (6 tools)
-- `list_functions` - List functions
-- `get_function_info` - Get function details
-- `create_function` - Create functions
-- `drop_function` - Remove functions
-- `show_create_function` - Show CREATE statement
-- `execute_function` - Execute functions
-
-### 12. Table Maintenance (8 tools)
+### 11. Table Maintenance (8 tools)
 - `analyze_table` - Update statistics
 - `optimize_table` - Reclaim space
 - `check_table` - Check for errors
@@ -187,19 +179,19 @@ Tool enabled = (Has Permission) AND (Has Category OR No categories specified)
 - `flush_table` - Close/reopen table
 - `get_table_size` - Get size information
 
-### 13. Transaction Management (5 tools)
+### 12. Transaction Management (5 tools)
 - `begin_transaction` - Start transaction
 - `commit_transaction` - Commit transaction
 - `rollback_transaction` - Rollback transaction
 - `get_transaction_status` - Check transaction state
 - `execute_in_transaction` - Execute within transaction
 
-### 14. Query Optimization (3 tools)
+### 13. Query Optimization (3 tools)
 - `analyze_query` - Analyze query performance
 - `get_optimization_hints` - Get optimizer hints
 - `repair_query` - Repair broken SQL queries
 
-### 15. Utilities (4 tools)
+### 14. Utilities (4 tools)
 - `test_connection` - Test connectivity
 - `describe_connection` - Connection info
 - `read_changelog` - Read changelog
@@ -391,4 +383,4 @@ The system provides detailed error messages indicating:
 
 ---
 
-*For detailed examples and advanced usage patterns, see the project README.md.*
+*For detailed examples and advanced usage patterns, see the project README.md.*

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-06 16:45:00
+**Last Updated:** 2026-03-07 10:30: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)
@@ -200,7 +200,7 @@ Alternative approach using environment variables instead of connection string:
         "DB_PASSWORD": "your_password",
         "DB_NAME": "your_database",
         "MCP_PERMISSIONS": "list,read,utility,create,update,delete",
-        "MCP_CATEGORIES": "database_discovery,performance_monitoring,custom_queries"
+        "MCP_CATEGORIES": "database_discovery,custom_queries,analysis"
       }
     }
   }
@@ -245,7 +245,7 @@ Use documentation categories to fine-tune which tools are exposed (Layer 2):
 
 | Category List | Use Case | List Tools |
 |---------------|----------|-----------|
-| `database_discovery` | Explore databases, tables, and schema structure | `get_all_tables_relationships, get_table_relationships, list_databases, list_tables, read_table_schema` |
+| `database_discovery` | Explore databases, tables, and schema structure | `get_all_tables_relationships, list_databases, list_tables, read_table_schema` |
 | `crud_operations` | Create, read, update, delete operations on data | `create_record, delete_record, read_records, update_record` |
 | `bulk_operations` | High-performance batch processing operations | `bulk_delete, bulk_insert, bulk_update` |
 | `custom_queries` | Execute custom SQL queries and advanced operations | `execute_write_query, run_select_query` |
@@ -255,19 +255,17 @@ Use documentation categories to fine-tune which tools are exposed (Layer 2):
 | `stored_procedures` | Create, execute, and manage stored procedures | `create_stored_procedure, drop_stored_procedure, execute_stored_procedure, get_stored_procedure_info, list_stored_procedures, show_create_procedure` |
 | `views_management` | Create and manage database views | `alter_view, create_view, drop_view, get_view_info, list_views, show_create_view` |
 | `triggers_management` | Create and manage database triggers | `create_trigger, drop_trigger, get_trigger_info, list_triggers, show_create_trigger` |
-| `functions_management` | Create and manage database functions | `create_function, drop_function, execute_function, get_function_info, list_functions, show_create_function` |
 | `index_management` | Optimize performance with index management | `analyze_index, create_index, drop_index, get_index_info, list_indexes` |
 | `constraint_management` | Manage data integrity constraints | `add_check_constraint, add_foreign_key, add_unique_constraint, drop_constraint, drop_foreign_key, list_constraints, list_foreign_keys` |
 | `table_maintenance` | Table optimization, repair, and maintenance | `analyze_table, check_table, flush_table, get_table_size, get_table_status, optimize_table, repair_table, truncate_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` |
 | `analysis` | Data analysis and reporting tools | `get_column_statistics, get_database_summary, get_schema_erd, get_schema_rag_context` |
 
 <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,query_optimization,backup_restore,analysis
+database_discovery,crud_operations,bulk_operations,custom_queries,schema_management,utilities,transaction_management,stored_procedures,views_management,triggers_management,index_management,constraint_management,table_maintenance,query_optimization,analysis
 ```
 
 </details>
@@ -278,7 +276,7 @@ Full category → tool mapping (and examples) lives in **[DOCUMENTATIONS.md →
 
 ## Available Tools
 
-The server exposes **73 tools** organized into categories (CRUD, schema, and utilities).
+The server exposes **62 tools** organized into categories (CRUD, schema, and utilities).
 
 - Complete list of tools: **[DOCUMENTATIONS.md → Complete Tools Reference](DOCUMENTATIONS.md#🔧-complete-tools-reference)**
 
@@ -291,7 +289,6 @@ For comprehensive documentation, see **[DOCUMENTATIONS.md](DOCUMENTATIONS.md)**:
 - **DDL Operations** - Create, alter, and drop tables
 - **Data Export Tools** - Export to CSV, JSON, and SQL formats
 - **Data Import Tools** - Import from CSV and JSON sources
-- **Database Backup & Restore** - Full backup/restore with SQL dumps
 - **Data Migration Tools** - Copy, move, clone, compare, and sync data
 - **Schema Versioning** - Version control for database schema changes
 - **Transaction Management** - ACID transactions

package/bin/mcp-mysql.js

@@ -50,7 +50,7 @@ if (!mysqlUrl) {
     "  # Dual-layer: Permissions + Categories (fine-grained control)",
   );
   console.error(
-    '  mcp-mysql mysql://root:pass@localhost:3306/mydb "list,read,utility" "database_discovery,performance_monitoring"',
+    '  mcp-mysql mysql://root:pass@localhost:3306/mydb "list,read,utility" "database_discovery,custom_queries,analysis"',
   );
   console.error("");
   console.error("Permissions (Layer 1 - Broad Control):");
@@ -66,16 +66,13 @@ if (!mysqlUrl) {
     "  schema_management, utilities, transaction_management, stored_procedures,",
   );
   console.error(
-    "  views_management, triggers_management, functions_management, index_management,",
+    "  views_management, triggers_management, index_management,",
   );
   console.error(
-    "  constraint_management, table_maintenance, server_management,",
+    "  constraint_management, table_maintenance, query_optimization,",
   );
   console.error(
-    "  performance_monitoring, cache_management, query_optimization,",
-  );
-  console.error(
-    "  backup_restore, import_export, data_migration, schema_migrations",
+    "  analysis",
   );
   console.error("");
   console.error("Filtering Logic:");

package/dist/config/featureConfig.d.ts

@@ -14,7 +14,7 @@ export declare enum ToolCategory {
     PROCEDURE = "procedure"
 }
 /**
- * Documentation categories from README (15 categories)
+ * Documentation categories from README (13 categories)
  * More intuitive and matches user mental model
  */
 export declare enum DocCategory {
@@ -28,12 +28,10 @@ export declare enum DocCategory {
     STORED_PROCEDURES = "stored_procedures",
     VIEWS_MANAGEMENT = "views_management",
     TRIGGERS_MANAGEMENT = "triggers_management",
-    FUNCTIONS_MANAGEMENT = "functions_management",
     INDEX_MANAGEMENT = "index_management",
     CONSTRAINT_MANAGEMENT = "constraint_management",
     TABLE_MAINTENANCE = "table_maintenance",
     QUERY_OPTIMIZATION = "query_optimization",
-    BACKUP_RESTORE = "backup_restore",
     ANALYSIS = "analysis"
 }
 /**

package/dist/config/featureConfig.js

@@ -24,7 +24,7 @@ var ToolCategory;
     ToolCategory["PROCEDURE"] = "procedure";
 })(ToolCategory || (exports.ToolCategory = ToolCategory = {}));
 /**
- * Documentation categories from README (15 categories)
+ * Documentation categories from README (13 categories)
  * More intuitive and matches user mental model
  */
 var DocCategory;
@@ -39,12 +39,10 @@ var DocCategory;
     DocCategory["STORED_PROCEDURES"] = "stored_procedures";
     DocCategory["VIEWS_MANAGEMENT"] = "views_management";
     DocCategory["TRIGGERS_MANAGEMENT"] = "triggers_management";
-    DocCategory["FUNCTIONS_MANAGEMENT"] = "functions_management";
     DocCategory["INDEX_MANAGEMENT"] = "index_management";
     DocCategory["CONSTRAINT_MANAGEMENT"] = "constraint_management";
     DocCategory["TABLE_MAINTENANCE"] = "table_maintenance";
     DocCategory["QUERY_OPTIMIZATION"] = "query_optimization";
-    DocCategory["BACKUP_RESTORE"] = "backup_restore";
     DocCategory["ANALYSIS"] = "analysis";
 })(DocCategory || (exports.DocCategory = DocCategory = {}));
 /**
@@ -112,13 +110,6 @@ exports.toolCategoryMap = {
     createTrigger: ToolCategory.DDL,
     dropTrigger: ToolCategory.DDL,
     showCreateTrigger: ToolCategory.LIST,
-    // Function tools
-    listFunctions: ToolCategory.LIST,
-    getFunctionInfo: ToolCategory.LIST,
-    createFunction: ToolCategory.PROCEDURE,
-    dropFunction: ToolCategory.PROCEDURE,
-    showCreateFunction: ToolCategory.LIST,
-    executeFunction: ToolCategory.PROCEDURE,
     // Index tools
     listIndexes: ToolCategory.LIST,
     getIndexInfo: ToolCategory.LIST,
@@ -142,12 +133,6 @@ exports.toolCategoryMap = {
     getTableStatus: ToolCategory.LIST,
     flushTable: ToolCategory.UTILITY,
     getTableSize: ToolCategory.LIST,
-    // Backup and restore tools
-    backupTable: ToolCategory.UTILITY,
-    backupDatabase: ToolCategory.UTILITY,
-    restoreFromSql: ToolCategory.UTILITY,
-    getCreateTableStatement: ToolCategory.UTILITY,
-    getDatabaseSchema: ToolCategory.UTILITY,
     // Full-Text Search Tools
     createFulltextIndex: ToolCategory.DDL,
     fulltextSearch: ToolCategory.READ,
@@ -215,13 +200,6 @@ exports.toolDocCategoryMap = {
     createTrigger: DocCategory.TRIGGERS_MANAGEMENT,
     dropTrigger: DocCategory.TRIGGERS_MANAGEMENT,
     showCreateTrigger: DocCategory.TRIGGERS_MANAGEMENT,
-    // Functions Management
-    listFunctions: DocCategory.FUNCTIONS_MANAGEMENT,
-    getFunctionInfo: DocCategory.FUNCTIONS_MANAGEMENT,
-    createFunction: DocCategory.FUNCTIONS_MANAGEMENT,
-    dropFunction: DocCategory.FUNCTIONS_MANAGEMENT,
-    showCreateFunction: DocCategory.FUNCTIONS_MANAGEMENT,
-    executeFunction: DocCategory.FUNCTIONS_MANAGEMENT,
     // Index Management
     listIndexes: DocCategory.INDEX_MANAGEMENT,
     getIndexInfo: DocCategory.INDEX_MANAGEMENT,
@@ -249,12 +227,6 @@ exports.toolDocCategoryMap = {
     analyzeQuery: DocCategory.QUERY_OPTIMIZATION,
     getOptimizationHints: DocCategory.QUERY_OPTIMIZATION,
     repairQuery: DocCategory.QUERY_OPTIMIZATION,
-    // Backup & Restore
-    backupTable: DocCategory.BACKUP_RESTORE,
-    backupDatabase: DocCategory.BACKUP_RESTORE,
-    restoreFromSql: DocCategory.BACKUP_RESTORE,
-    getCreateTableStatement: DocCategory.BACKUP_RESTORE,
-    getDatabaseSchema: DocCategory.BACKUP_RESTORE,
     // Analysis
     getDatabaseSummary: DocCategory.ANALYSIS,
     getSchemaERD: DocCategory.ANALYSIS,
@@ -278,7 +250,6 @@ const legacyToDocCategoryMap = {
         DocCategory.STORED_PROCEDURES,
         DocCategory.VIEWS_MANAGEMENT,
         DocCategory.TRIGGERS_MANAGEMENT,
-        DocCategory.FUNCTIONS_MANAGEMENT,
         DocCategory.INDEX_MANAGEMENT,
         DocCategory.CONSTRAINT_MANAGEMENT,
         DocCategory.TABLE_MAINTENANCE,
@@ -306,16 +277,14 @@ const legacyToDocCategoryMap = {
         DocCategory.INDEX_MANAGEMENT,
         DocCategory.CONSTRAINT_MANAGEMENT,
         DocCategory.TABLE_MAINTENANCE,
-        DocCategory.BACKUP_RESTORE,
     ],
     utility: [
         DocCategory.UTILITIES,
         DocCategory.TABLE_MAINTENANCE,
         DocCategory.QUERY_OPTIMIZATION,
-        DocCategory.BACKUP_RESTORE,
     ],
     transaction: [DocCategory.TRANSACTION_MANAGEMENT],
-    procedure: [DocCategory.STORED_PROCEDURES, DocCategory.FUNCTIONS_MANAGEMENT],
+    procedure: [DocCategory.STORED_PROCEDURES],
 };
 /**
  * Class to manage feature configuration based on runtime or environment variables

package/dist/index.d.ts

@@ -13,11 +13,9 @@ export declare class MySQLMCP {
     private dataExportTools;
     private viewTools;
     private triggerTools;
-    private functionTools;
     private indexTools;
     private constraintTools;
     private maintenanceTools;
-    private backupRestoreTools;
     private analysisTools;
     private aiTools;
     private macroTools;
@@ -510,52 +508,6 @@ export declare class MySQLMCP {
         data?: any;
         error?: string;
     }>;
-    listFunctions(params: {
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any[];
-        error?: string;
-    }>;
-    getFunctionInfo(params: {
-        function_name: string;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    createFunction(params: any): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    dropFunction(params: {
-        function_name: string;
-        if_exists?: boolean;
-        database?: string;
-    }): Promise<{
-        status: string;
-        message?: string;
-        error?: string;
-    }>;
-    showCreateFunction(params: {
-        function_name: string;
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
-    executeFunction(params: {
-        function_name: string;
-        parameters?: any[];
-        database?: string;
-    }): Promise<{
-        status: string;
-        data?: any;
-        error?: string;
-    }>;
     listIndexes(params: {
         table_name: string;
         database?: string;

package/dist/index.js

@@ -14,11 +14,9 @@ const storedProcedureTools_1 = require("./tools/storedProcedureTools");
 const dataExportTools_1 = require("./tools/dataExportTools");
 const viewTools_1 = require("./tools/viewTools");
 const triggerTools_1 = require("./tools/triggerTools");
-const functionTools_1 = require("./tools/functionTools");
 const indexTools_1 = require("./tools/indexTools");
 const constraintTools_1 = require("./tools/constraintTools");
 const maintenanceTools_1 = require("./tools/maintenanceTools");
-const backupRestoreTools_1 = require("./tools/backupRestoreTools");
 const analysisTools_1 = require("./tools/analysisTools");
 const aiTools_1 = require("./tools/aiTools");
 const macroTools_1 = require("./tools/macroTools");
@@ -45,11 +43,9 @@ class MySQLMCP {
         this.dataExportTools = new dataExportTools_1.DataExportTools(this.security);
         this.viewTools = new viewTools_1.ViewTools(this.security);
         this.triggerTools = new triggerTools_1.TriggerTools(this.security);
-        this.functionTools = new functionTools_1.FunctionTools(this.security);
         this.indexTools = new indexTools_1.IndexTools(this.security);
         this.constraintTools = new constraintTools_1.ConstraintTools(this.security);
         this.maintenanceTools = new maintenanceTools_1.MaintenanceTools(this.security);
-        this.backupRestoreTools = new backupRestoreTools_1.BackupRestoreTools(this.security);
         this.analysisTools = new analysisTools_1.AnalysisTools(this.security);
         this.aiTools = new aiTools_1.AiTools(this.security);
         this.macroTools = new macroTools_1.MacroTools(this.security);
@@ -515,45 +511,6 @@ class MySQLMCP {
         return await this.triggerTools.showCreateTrigger(params);
     }
     // ==========================================
-    // Function Tools
-    // ==========================================
-    async listFunctions(params) {
-        const check = this.checkToolEnabled("listFunctions");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.functionTools.listFunctions(params);
-    }
-    async getFunctionInfo(params) {
-        const check = this.checkToolEnabled("getFunctionInfo");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.functionTools.getFunctionInfo(params);
-    }
-    async createFunction(params) {
-        const check = this.checkToolEnabled("createFunction");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.functionTools.createFunction(params);
-    }
-    async dropFunction(params) {
-        const check = this.checkToolEnabled("dropFunction");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.functionTools.dropFunction(params);
-    }
-    async showCreateFunction(params) {
-        const check = this.checkToolEnabled("showCreateFunction");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.functionTools.showCreateFunction(params);
-    }
-    async executeFunction(params) {
-        const check = this.checkToolEnabled("executeFunction");
-        if (!check.enabled)
-            return { status: "error", error: check.error };
-        return await this.functionTools.executeFunction(params);
-    }
-    // ==========================================
     // Index Tools
     // ==========================================
     async listIndexes(params) {

package/dist/mcp-server.js

@@ -5,7 +5,8 @@ const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const index_js_2 = require("./index.js");
-const inputValidation_js_1 = require("./validation/inputValidation.js");
+const toolRegistry_js_1 = require("./tools/toolRegistry.js");
+const toolArgumentValidation_js_1 = require("./tools/toolArgumentValidation.js");
 // Get permissions and categories from environment variables (set by bin/mcp-mysql.js)
 // Layer 1 (Permissions): MCP_PERMISSIONS or MCP_CONFIG (backward compatible)
 // Layer 2 (Categories): MCP_CATEGORIES (optional, for fine-grained control)
@@ -602,7 +603,7 @@ const TOOLS = [
     },
     {
         name: "drop_table",
-        description: '🗑️ DESTRUCTIVE: Permanently deletes a table and ALL its data. Cannot be undone! Consider backup_table first. Requires "ddl" permission. ⚠️ WARNING: IRREVERSIBLE!',
+        description: '🗑️ DESTRUCTIVE: Permanently deletes a table and ALL its data. Cannot be undone! Requires "ddl" permission. ⚠️ WARNING: IRREVERSIBLE!',
         inputSchema: {
             type: "object",
             properties: {
@@ -1252,139 +1253,6 @@ const TOOLS = [
             required: ["trigger_name"],
         },
     },
-    // Function Tools
-    {
-        name: "list_functions",
-        description: "Lists all user-defined functions in the database.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-        },
-    },
-    {
-        name: "get_function_info",
-        description: "Gets detailed information about a specific function including parameters.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                function_name: { type: "string", description: "Name of the function" },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-            required: ["function_name"],
-        },
-    },
-    {
-        name: "create_function",
-        description: "Creates a new user-defined function. Requires 'ddl' permission.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                function_name: { type: "string", description: "Name of the function" },
-                parameters: {
-                    type: "array",
-                    description: "Array of parameter definitions",
-                    items: {
-                        type: "object",
-                        properties: {
-                            name: { type: "string" },
-                            data_type: { type: "string" },
-                        },
-                        required: ["name", "data_type"],
-                    },
-                },
-                returns: { type: "string", description: "Return data type" },
-                body: { type: "string", description: "Function body (SQL statements)" },
-                deterministic: {
-                    type: "boolean",
-                    description: "Whether function always returns same result for same input",
-                },
-                data_access: {
-                    type: "string",
-                    enum: [
-                        "CONTAINS SQL",
-                        "NO SQL",
-                        "READS SQL DATA",
-                        "MODIFIES SQL DATA",
-                    ],
-                },
-                security: { type: "string", enum: ["DEFINER", "INVOKER"] },
-                comment: { type: "string", description: "Optional comment" },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-            required: ["function_name", "returns", "body"],
-        },
-    },
-    {
-        name: "drop_function",
-        description: "Drops a user-defined function. Requires 'ddl' permission.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                function_name: {
-                    type: "string",
-                    description: "Name of the function to drop",
-                },
-                if_exists: {
-                    type: "boolean",
-                    description: "If true, will not error if function does not exist",
-                },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-            required: ["function_name"],
-        },
-    },
-    {
-        name: "show_create_function",
-        description: "Shows the CREATE statement for a function.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                function_name: { type: "string", description: "Name of the function" },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-            required: ["function_name"],
-        },
-    },
-    {
-        name: "execute_function",
-        description: "Executes a user-defined function and returns its result.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                function_name: {
-                    type: "string",
-                    description: "Name of the function to execute",
-                },
-                parameters: {
-                    type: "array",
-                    description: "Array of parameter values",
-                    items: {},
-                },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-            required: ["function_name"],
-        },
-    },
     // Index Tools
     {
         name: "list_indexes",
@@ -1737,7 +1605,7 @@ const TOOLS = [
     },
     {
         name: "truncate_table",
-        description: "🗑️ DESTRUCTIVE: Removes ALL rows from a table instantly (faster than DELETE). Resets auto-increment counters. Cannot be undone! Consider backup_table first. Requires 'ddl' permission. ⚠️ WARNING: IRREVERSIBLE!",
+        description: "🗑️ DESTRUCTIVE: Removes ALL rows from a table instantly (faster than DELETE). Resets auto-increment counters. Cannot be undone! Requires 'ddl' permission. ⚠️ WARNING: IRREVERSIBLE!",
         inputSchema: {
             type: "object",
             properties: {
@@ -1808,128 +1676,6 @@ const TOOLS = [
             },
         },
     },
-    // Backup and Restore Tools
-    {
-        name: "backup_table",
-        description: "Backup a single table to SQL dump format including structure and optionally data.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                table_name: {
-                    type: "string",
-                    description: "Name of the table to backup",
-                },
-                include_data: {
-                    type: "boolean",
-                    description: "Include table data in the backup (default: true)",
-                },
-                include_drop: {
-                    type: "boolean",
-                    description: "Include DROP TABLE IF EXISTS statement (default: true)",
-                },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-            required: ["table_name"],
-        },
-    },
-    {
-        name: "backup_database",
-        description: "💾 Creates SQL dump backup of entire database or specific tables. Includes structure and optionally data. Returns backup as SQL text. Use before major schema changes or migrations.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                include_data: {
-                    type: "boolean",
-                    description: "Include table data in the backup (default: true)",
-                },
-                include_drop: {
-                    type: "boolean",
-                    description: "Include DROP TABLE IF EXISTS statements (default: true)",
-                },
-                tables: {
-                    type: "array",
-                    items: { type: "string" },
-                    description: "Optional: specific tables to backup (default: all tables)",
-                },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-        },
-    },
-    {
-        name: "restore_from_sql",
-        description: "Restore database from SQL dump content. Executes SQL statements from the provided dump. Requires 'ddl' permission.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                sql_dump: {
-                    type: "string",
-                    description: "SQL dump content to restore",
-                },
-                stop_on_error: {
-                    type: "boolean",
-                    description: "Stop execution on first error (default: true)",
-                },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-            required: ["sql_dump"],
-        },
-    },
-    {
-        name: "get_create_table_statement",
-        description: "Get the CREATE TABLE statement for a specific table.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                table_name: {
-                    type: "string",
-                    description: "Name of the table",
-                },
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-            },
-            required: ["table_name"],
-        },
-    },
-    {
-        name: "get_database_schema",
-        description: "Get complete database schema including tables, views, procedures, functions, and triggers.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                database: {
-                    type: "string",
-                    description: "Optional: specific database name",
-                },
-                include_views: {
-                    type: "boolean",
-                    description: "Include views in schema (default: true)",
-                },
-                include_procedures: {
-                    type: "boolean",
-                    description: "Include stored procedures in schema (default: true)",
-                },
-                include_functions: {
-                    type: "boolean",
-                    description: "Include functions in schema (default: true)",
-                },
-                include_triggers: {
-                    type: "boolean",
-                    description: "Include triggers in schema (default: true)",
-                },
-            },
-        },
-    },
     {
         name: "create_fulltext_index",
         description: "Creates a FULLTEXT index on one or more text columns in a table. Supports ngram and mecab parsers for advanced text search capabilities (useful for languages like Chinese, Japanese, Korean). Use this to enable full-text search on text columns.",
@@ -2104,7 +1850,7 @@ const TOOLS = [
 // Create the MCP server
 const server = new index_js_1.Server({
     name: "mysql-mcp-server",
-    version: "1.28.0",
+    version: "1.40.2",
 }, {
     capabilities: {
         tools: {},
@@ -2112,17 +1858,7 @@ const server = new index_js_1.Server({
 });
 // Handle list tools request - filter tools based on permissions and categories
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
-    // Filter tools to only return those that are enabled based on current config
-    const enabledTools = TOOLS.filter((tool) => {
-        // Convert tool name from snake_case to camelCase for checking
-        // e.g., "list_databases" -> "listDatabases"
-        const toolNameCamelCase = tool.name.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
-        // Check if tool is enabled based on permissions and categories
-        // Most tools are keyed in featureConfig using camelCase, but a few legacy/meta tools
-        // are keyed using their snake_case MCP names (e.g., read_changelog, list_all_tools).
-        return (mysqlMCP.isToolEnabled(toolNameCamelCase) ||
-            mysqlMCP.isToolEnabled(tool.name));
-    });
+    const enabledTools = (0, toolRegistry_js_1.getEnabledTools)(mysqlMCP, TOOLS);
     // Log the filtering results
     console.error(`Tools available: ${enabledTools.length} of ${TOOLS.length} total tools`);
     return {
@@ -2133,7 +1869,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
 server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     // Validate tool arguments before execution
-    const validation = validateToolArguments(name, args);
+    const validation = (0, toolArgumentValidation_js_1.validateToolArguments)(name, args);
     if (!validation.valid) {
         return {
             content: [
@@ -2308,25 +2044,6 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "show_create_trigger":
                 result = await mysqlMCP.showCreateTrigger((args || {}));
                 break;
-            // Function Tools
-            case "list_functions":
-                result = await mysqlMCP.listFunctions((args || {}));
-                break;
-            case "get_function_info":
-                result = await mysqlMCP.getFunctionInfo((args || {}));
-                break;
-            case "create_function":
-                result = await mysqlMCP.createFunction((args || {}));
-                break;
-            case "drop_function":
-                result = await mysqlMCP.dropFunction((args || {}));
-                break;
-            case "show_create_function":
-                result = await mysqlMCP.showCreateFunction((args || {}));
-                break;
-            case "execute_function":
-                result = await mysqlMCP.executeFunction((args || {}));
-                break;
             // Index Tools
             case "list_indexes":
                 result = await mysqlMCP.listIndexes((args || {}));
@@ -2488,52 +2205,6 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
         };
     }
 });
-// Validation function to validate tool arguments before execution
-function validateToolArguments(name, args) {
-    if (!args)
-        return { valid: true }; // Some tools don't require arguments
-    try {
-        switch (name) {
-            case "create_record":
-                return (0, inputValidation_js_1.validateCreateRecord)(args);
-            case "read_records":
-                return (0, inputValidation_js_1.validateReadRecords)(args);
-            case "update_record":
-                return (0, inputValidation_js_1.validateUpdateRecord)(args);
-            case "delete_record":
-                return (0, inputValidation_js_1.validateDeleteRecord)(args);
-            case "run_select_query":
-            case "execute_write_query":
-            case "execute_ddl":
-                return (0, inputValidation_js_1.validateQuery)({ query: args?.query || "" });
-            case "bulk_insert":
-                return (0, inputValidation_js_1.validateBulkInsert)(args);
-            case "list_tables":
-            case "get_schema_erd":
-            case "get_schema_rag_context":
-            case "get_database_summary":
-                if (args.database !== undefined) {
-                    const validation = (0, inputValidation_js_1.validateValue)(args.database);
-                    if (!validation.valid)
-                        return { valid: false, errors: [validation.error || 'Invalid database name'] };
-                }
-                return { valid: true };
-            case "get_column_statistics":
-            case "read_table_schema":
-                if (args.table_name) {
-                    const validation = (0, inputValidation_js_1.validateTableName)(args.table_name);
-                    if (!validation.valid)
-                        return { valid: false, errors: [validation.error || 'Invalid table name'] };
-                }
-                return { valid: true };
-            default:
-                return { valid: true }; // For tools without specific validation
-        }
-    }
-    catch (error) {
-        return { valid: false, errors: [`Validation error: ${error instanceof Error ? error.message : 'Unknown validation error'}`] };
-    }
-}
 // Start the server
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();

package/dist/tools/toolArgumentValidation.d.ts

@@ -0,0 +1,4 @@
+export declare function validateToolArguments(name: string, args: any): {
+    valid: boolean;
+    errors?: string[];
+};

package/dist/tools/toolArgumentValidation.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateToolArguments = validateToolArguments;
+const inputValidation_js_1 = require("../validation/inputValidation.js");
+function validateToolArguments(name, args) {
+    if (!args)
+        return { valid: true };
+    try {
+        switch (name) {
+            case "create_record":
+                return (0, inputValidation_js_1.validateCreateRecord)(args);
+            case "read_records":
+                return (0, inputValidation_js_1.validateReadRecords)(args);
+            case "update_record":
+                return (0, inputValidation_js_1.validateUpdateRecord)(args);
+            case "delete_record":
+                return (0, inputValidation_js_1.validateDeleteRecord)(args);
+            case "run_select_query":
+            case "execute_write_query":
+            case "execute_ddl":
+                return (0, inputValidation_js_1.validateQuery)({ query: args?.query || "" });
+            case "bulk_insert":
+                return (0, inputValidation_js_1.validateBulkInsert)(args);
+            case "list_tables":
+            case "get_schema_erd":
+            case "get_schema_rag_context":
+            case "get_database_summary":
+                if (args.database !== undefined) {
+                    const validation = (0, inputValidation_js_1.validateValue)(args.database);
+                    if (!validation.valid) {
+                        return {
+                            valid: false,
+                            errors: [validation.error || "Invalid database name"],
+                        };
+                    }
+                }
+                return { valid: true };
+            case "get_column_statistics":
+            case "read_table_schema":
+                if (args.table_name) {
+                    const validation = (0, inputValidation_js_1.validateTableName)(args.table_name);
+                    if (!validation.valid) {
+                        return {
+                            valid: false,
+                            errors: [validation.error || "Invalid table name"],
+                        };
+                    }
+                }
+                return { valid: true };
+            default:
+                return { valid: true };
+        }
+    }
+    catch (error) {
+        return {
+            valid: false,
+            errors: [
+                `Validation error: ${error instanceof Error ? error.message : "Unknown validation error"}`,
+            ],
+        };
+    }
+}

package/dist/tools/toolRegistry.d.ts

@@ -0,0 +1,4 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { MySQLMCP } from "../index.js";
+export declare const isToolEnabled: (mysqlMCP: MySQLMCP, tool: Tool) => boolean;
+export declare const getEnabledTools: (mysqlMCP: MySQLMCP, tools: Tool[]) => Tool[];

package/dist/tools/toolRegistry.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnabledTools = exports.isToolEnabled = void 0;
+const toCamelCase = (value) => value.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+const isToolEnabled = (mysqlMCP, tool) => {
+    const camelCaseName = toCamelCase(tool.name);
+    return mysqlMCP.isToolEnabled(camelCaseName) || mysqlMCP.isToolEnabled(tool.name);
+};
+exports.isToolEnabled = isToolEnabled;
+const getEnabledTools = (mysqlMCP, tools) => tools.filter((tool) => (0, exports.isToolEnabled)(mysqlMCP, tool));
+exports.getEnabledTools = getEnabledTools;

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "mysql-mcp",
   "description": "A Model Context Protocol for MySQL database interaction",
-  "version": "1.26.1",
+  "version": "1.40.2",
   "tools": [
     {
       "name": "list_databases",
@@ -730,4 +730,4 @@
       }
     }
   ]
-}
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.40.0",
-  "description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions, backup/restore capabilities",
+  "version": "1.40.2",
+  "description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",
@@ -77,4 +77,4 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.2.2"
   }
-}
+}