@berthojoris/mcp-mysql-server 1.40.0 → 1.40.1

package/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.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,7 +1,7 @@
 # MySQL MCP Server - Documentation
 
-**Last Updated:** 2026-03-06 00:00:00
-**Version:** 1.40.0
+**Last Updated:** 2026-03-06 17:30:00
+**Version:** 1.40.1
 **Total Tools:** 73
 
 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"
   }
 }
 ```
@@ -391,4 +391,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-06 17: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` |

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):");
@@ -69,13 +69,10 @@ if (!mysqlUrl) {
     "  views_management, triggers_management, functions_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",
+    "  backup_restore, analysis",
   );
   console.error("");
   console.error("Filtering Logic:");

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)
@@ -2104,7 +2105,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.1",
 }, {
     capabilities: {
         tools: {},
@@ -2112,17 +2113,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 +2124,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: [
@@ -2488,52 +2479,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.1",
   "tools": [
     {
       "name": "list_databases",
@@ -730,4 +730,4 @@
       }
     }
   ]
-}
+}

package/package.json

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