@berthojoris/mcp-mysql-server 1.40.2 → 1.40.4

package/CHANGELOG.md

@@ -5,6 +5,33 @@ 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.4] - 2026-03-07
+
+### Removed
+- **Unused Dependencies**: Removed `winston` and `@types/winston` packages (26 packages total)
+  - `winston` logging library was not used - project uses custom in-memory `QueryLogger` instead
+- **Dead Code**: Removed unused tool modules left from previous refactoring
+  - `src/tools/processTools.ts` - Remnant from removed `server_management` category
+  - `src/tools/performanceTools.ts` - Remnant from removed `performance_monitoring` category
+  - `src/auth/` folder - Empty unused directory
+  - `dist/server.js` and `dist/server.d.ts` - Obsolete build artifacts
+
+### Changed
+- Updated dependencies: 6 → 5 production dependencies (removed winston)
+- Updated devDependencies: 10 → 9 (removed @types/winston)
+- Synchronized version to `1.40.4` in `package.json`
+
+## [1.40.3] - 2026-03-07
+
+### Fixed
+- Added missing tool-category mappings for snake_case and camelCase variants in `src/config/featureConfig.ts`
+- Resolved unmapped tools: `get_schema_erd`, `repair_query`, `export_table_to_csv`, `export_query_to_csv`, `analyze_query`, `get_optimization_hints`
+- Ensured dual-layer filtering recognizes all registered MCP tools from `src/mcp-server.ts`
+
+### Changed
+- Synchronized versions to `1.40.3` in `package.json`, `src/mcp-server.ts`, and `manifest.json`
+- Updated `README.md` and `DOCUMENTATIONS.md` Last Updated metadata
+
 ## [1.40.2] - 2026-03-07
 
 ### Removed

package/DOCUMENTATIONS.md

@@ -1,7 +1,7 @@
 # MySQL MCP Server - Documentation
 
-**Last Updated:** 2026-03-07 10:30:00
-**Version:** 1.40.2
+**Last Updated:** 2026-03-07 11:05:00
+**Version:** 1.40.3
 **Total Tools:** 62
 
 Comprehensive documentation for the MySQL MCP Server. For quick start, see [README.md](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-07 10:30:00
+**Last Updated:** 2026-03-07 12:45: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)

package/dist/config/featureConfig.js

@@ -57,6 +57,8 @@ exports.toolCategoryMap = {
     // Analysis tools (added here to group with database tools)
     getDatabaseSummary: ToolCategory.LIST,
     getSchemaERD: ToolCategory.LIST,
+    getSchemaErd: ToolCategory.LIST,
+    get_schema_erd: ToolCategory.LIST,
     getSchemaRagContext: ToolCategory.LIST,
     // CRUD tools
     createRecord: ToolCategory.CREATE,
@@ -82,7 +84,11 @@ exports.toolCategoryMap = {
     testConnection: ToolCategory.UTILITY,
     getAllTablesRelationships: ToolCategory.UTILITY,
     exportTableToCSV: ToolCategory.UTILITY,
+    exportTableToCsv: ToolCategory.UTILITY,
+    export_table_to_csv: ToolCategory.UTILITY,
     exportQueryToCSV: ToolCategory.UTILITY,
+    exportQueryToCsv: ToolCategory.UTILITY,
+    export_query_to_csv: ToolCategory.UTILITY,
     read_changelog: ToolCategory.UTILITY,
     // Transaction tools
     beginTransaction: ToolCategory.TRANSACTION,
@@ -133,6 +139,13 @@ exports.toolCategoryMap = {
     getTableStatus: ToolCategory.LIST,
     flushTable: ToolCategory.UTILITY,
     getTableSize: ToolCategory.LIST,
+    // Query optimization tools
+    analyzeQuery: ToolCategory.UTILITY,
+    analyze_query: ToolCategory.UTILITY,
+    getOptimizationHints: ToolCategory.UTILITY,
+    get_optimization_hints: ToolCategory.UTILITY,
+    repairQuery: ToolCategory.UTILITY,
+    repair_query: ToolCategory.UTILITY,
     // Full-Text Search Tools
     createFulltextIndex: ToolCategory.DDL,
     fulltextSearch: ToolCategory.READ,
@@ -171,7 +184,11 @@ exports.toolDocCategoryMap = {
     testConnection: DocCategory.UTILITIES,
     describeConnection: DocCategory.UTILITIES,
     exportTableToCSV: DocCategory.UTILITIES,
+    exportTableToCsv: DocCategory.UTILITIES,
+    export_table_to_csv: DocCategory.UTILITIES,
     exportQueryToCSV: DocCategory.UTILITIES,
+    exportQueryToCsv: DocCategory.UTILITIES,
+    export_query_to_csv: DocCategory.UTILITIES,
     read_changelog: DocCategory.UTILITIES,
     list_all_tools: DocCategory.UTILITIES,
     // Transaction Management
@@ -225,11 +242,16 @@ exports.toolDocCategoryMap = {
     getTableSize: DocCategory.TABLE_MAINTENANCE,
     // Query Optimization
     analyzeQuery: DocCategory.QUERY_OPTIMIZATION,
+    analyze_query: DocCategory.QUERY_OPTIMIZATION,
     getOptimizationHints: DocCategory.QUERY_OPTIMIZATION,
+    get_optimization_hints: DocCategory.QUERY_OPTIMIZATION,
     repairQuery: DocCategory.QUERY_OPTIMIZATION,
+    repair_query: DocCategory.QUERY_OPTIMIZATION,
     // Analysis
     getDatabaseSummary: DocCategory.ANALYSIS,
     getSchemaERD: DocCategory.ANALYSIS,
+    getSchemaErd: DocCategory.ANALYSIS,
+    get_schema_erd: DocCategory.ANALYSIS,
     getColumnStatistics: DocCategory.ANALYSIS,
     getSchemaRagContext: DocCategory.ANALYSIS,
     // Full-Text Search

package/dist/mcp-server.js

@@ -1850,7 +1850,7 @@ const TOOLS = [
 // Create the MCP server
 const server = new index_js_1.Server({
     name: "mysql-mcp-server",
-    version: "1.40.2",
+    version: "1.40.4",
 }, {
     capabilities: {
         tools: {},

package/manifest.json

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.40.2",
-  "description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions",
+  "version": "1.40.4",
+  "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",
@@ -62,13 +62,11 @@
     "ajv": "^8.12.0",
     "ajv-formats": "^3.0.1",
     "dotenv": "^16.3.1",
-    "mysql2": "^3.6.1",
-    "winston": "^3.11.0"
+    "mysql2": "^3.6.1"
   },
   "devDependencies": {
     "@types/jest": "^29.5.4",
     "@types/node": "^20.6.0",
-    "@types/winston": "^2.4.4",
     "@typescript-eslint/eslint-plugin": "^8.50.1",
     "@typescript-eslint/parser": "^8.50.1",
     "eslint": "^9.39.2",
@@ -77,4 +75,4 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.2.2"
   }
-}
+}

package/dist/server.d.ts

@@ -1,2 +0,0 @@
-declare const app: import("express-serve-static-core").Express;
-export default app;

package/dist/server.js

@@ -1,345 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const express_1 = __importDefault(require("express"));
-const cors_1 = __importDefault(require("cors"));
-const helmet_1 = __importDefault(require("helmet"));
-const morgan_1 = __importDefault(require("morgan"));
-const express_rate_limit_1 = __importDefault(require("express-rate-limit"));
-const index_1 = require("./index");
-const winston_1 = require("winston");
-const inputValidation_1 = require("./validation/inputValidation");
-// Initialize the MCP instance
-const mcp = new index_1.MySQLMCP();
-// Create Winston logger
-const logger = (0, winston_1.createLogger)({
-    level: 'info',
-    format: winston_1.format.combine(winston_1.format.timestamp(), winston_1.format.json()),
-    transports: [
-        new winston_1.transports.Console(),
-        new winston_1.transports.File({ filename: 'logs/error.log', level: 'error' }),
-        new winston_1.transports.File({ filename: 'logs/combined.log' })
-    ]
-});
-// Initialize Express app
-const app = (0, express_1.default)();
-const PORT = process.env.PORT || 3000;
-// Middleware
-app.use((0, helmet_1.default)()); // Security headers
-app.use((0, cors_1.default)()); // Enable CORS
-app.use(express_1.default.json()); // Parse JSON bodies
-app.use((0, morgan_1.default)('combined')); // HTTP request logging
-// Rate limiting
-const apiLimiter = (0, express_rate_limit_1.default)({
-    windowMs: 15 * 60 * 1000, // 15 minutes
-    max: 100, // Limit each IP to 100 requests per windowMs
-    standardHeaders: true,
-    legacyHeaders: false,
-});
-app.use(apiLimiter);
-// No authentication middleware needed for MCP server
-// Input validation middleware
-const validateInput = (validator) => {
-    return (req, res, next) => {
-        const validation = validator(req.body);
-        if (!validation.valid) {
-            return res.status(400).json({
-                error: {
-                    code: 'VALIDATION_ERROR',
-                    message: 'Input validation failed',
-                    details: validation.errors
-                }
-            });
-        }
-        next();
-    };
-};
-// Parameter sanitization middleware
-const sanitizeParams = (req, res, next) => {
-    // Sanitize route parameters
-    if (req.params.tableName) {
-        req.params.tableName = (0, inputValidation_1.sanitizeTableName)(req.params.tableName);
-    }
-    if (req.params.id) {
-        req.params.id = (0, inputValidation_1.sanitizeFieldName)(req.params.id);
-    }
-    // Sanitize query parameters
-    if (req.query.id_field) {
-        req.query.id_field = (0, inputValidation_1.sanitizeFieldName)(req.query.id_field);
-    }
-    if (req.query.sort_by) {
-        req.query.sort_by = (0, inputValidation_1.sanitizeFieldName)(req.query.sort_by);
-    }
-    // Sanitize request body
-    if (req.body.query) {
-        req.body.query = (0, inputValidation_1.sanitizeQuery)(req.body.query);
-    }
-    next();
-};
-// Request size limiting middleware
-const requestSizeLimit = (maxSize) => {
-    return (req, res, next) => {
-        const contentLength = parseInt(req.headers['content-length'] || '0');
-        if (contentLength > maxSize) {
-            return res.status(413).json({
-                error: {
-                    code: 'REQUEST_TOO_LARGE',
-                    message: `Request body too large. Maximum size is ${maxSize} bytes`
-                }
-            });
-        }
-        next();
-    };
-};
-// Error handling middleware
-const errorHandler = (err, req, res, next) => {
-    logger.error(`${err.name}: ${err.message}`, {
-        path: req.path,
-        method: req.method,
-        body: req.body,
-        stack: err.stack
-    });
-    res.status(500).json({
-        error: {
-            code: 'SERVER_ERROR',
-            message: 'An unexpected error occurred',
-            details: process.env.NODE_ENV === 'production' ? 'See server logs for details' : err.message
-        }
-    });
-};
-// Health check endpoint (no auth required)
-app.get('/health', (req, res) => {
-    res.status(200).json({ status: 'ok', timestamp: new Date().toISOString() });
-});
-// Feature configuration status endpoint
-app.get('/features', (req, res) => {
-    try {
-        const featureStatus = mcp.getFeatureStatus();
-        res.status(200).json(featureStatus);
-    }
-    catch (error) {
-        logger.error('Error getting feature status', { error });
-        res.status(500).json({
-            status: 'error',
-            error: 'Failed to retrieve feature configuration status'
-        });
-    }
-});
-// API routes - no authentication required for MCP server
-const apiRouter = express_1.default.Router();
-app.use('/api', sanitizeParams, apiRouter);
-// Database Tools Routes
-apiRouter.get('/databases', async (req, res, next) => {
-    try {
-        const result = await mcp.listDatabases();
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-apiRouter.get('/tables', async (req, res, next) => {
-    try {
-        const result = await mcp.listTables({ database: undefined });
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-apiRouter.get('/tables/:tableName/schema', async (req, res, next) => {
-    try {
-        const { tableName } = req.params;
-        const result = await mcp.readTableSchema({ table_name: tableName });
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-// CRUD Operations Routes
-apiRouter.post('/tables/:tableName/records', requestSizeLimit(inputValidation_1.INPUT_LIMITS.MAX_QUERY_LENGTH), validateInput((req) => (0, inputValidation_1.validateCreateRecord)({ table_name: req.params.tableName, data: req.body.data })), async (req, res, next) => {
-    try {
-        const { tableName } = req.params;
-        const { data } = req.body;
-        const result = await mcp.createRecord({
-            table_name: tableName,
-            data
-        });
-        res.status(201).json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-apiRouter.get('/tables/:tableName/records', async (req, res, next) => {
-    try {
-        const { tableName } = req.params;
-        const { filters, limit, offset, sort_by, sort_direction } = req.query;
-        // Validate and parse filters
-        let parsedFilters;
-        if (filters) {
-            try {
-                parsedFilters = JSON.parse(filters);
-            }
-            catch (e) {
-                return res.status(400).json({
-                    error: {
-                        code: 'INVALID_FILTERS',
-                        message: 'Invalid JSON in filters parameter'
-                    }
-                });
-            }
-        }
-        // Validate the complete request
-        const validation = (0, inputValidation_1.validateReadRecords)({
-            table_name: tableName,
-            filters: parsedFilters,
-            pagination: {
-                page: offset ? Math.floor(parseInt(offset) / (limit ? parseInt(limit) : 10)) + 1 : 1,
-                limit: limit ? parseInt(limit) : 10
-            },
-            sorting: sort_by ? {
-                field: sort_by,
-                direction: sort_direction?.toLowerCase() === 'desc' ? 'desc' : 'asc'
-            } : undefined
-        });
-        if (!validation.valid) {
-            return res.status(400).json({
-                error: {
-                    code: 'VALIDATION_ERROR',
-                    message: 'Input validation failed',
-                    details: validation.errors
-                }
-            });
-        }
-        const result = await mcp.readRecords({
-            table_name: tableName,
-            filters: parsedFilters,
-            pagination: {
-                page: offset ? Math.floor(parseInt(offset) / (limit ? parseInt(limit) : 10)) + 1 : 1,
-                limit: limit ? parseInt(limit) : 10
-            },
-            sorting: sort_by ? {
-                field: sort_by,
-                direction: sort_direction?.toLowerCase() === 'desc' ? 'desc' : 'asc'
-            } : undefined
-        });
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-apiRouter.put('/tables/:tableName/records/:id', requestSizeLimit(inputValidation_1.INPUT_LIMITS.MAX_QUERY_LENGTH), validateInput((req) => (0, inputValidation_1.validateUpdateRecord)({
-    table_name: req.params.tableName,
-    data: req.body.data,
-    conditions: [{ field: req.body.id_field || 'id', operator: '=', value: req.params.id }]
-})), async (req, res, next) => {
-    try {
-        const { tableName, id } = req.params;
-        const { data, id_field } = req.body;
-        const result = await mcp.updateRecord({
-            table_name: tableName,
-            data,
-            conditions: [{ field: id_field || 'id', operator: '=', value: id }]
-        });
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-apiRouter.delete('/tables/:tableName/records/:id', validateInput((req) => (0, inputValidation_1.validateDeleteRecord)({
-    table_name: req.params.tableName,
-    conditions: [{ field: req.query.id_field || 'id', operator: '=', value: req.params.id }]
-})), async (req, res, next) => {
-    try {
-        const { tableName, id } = req.params;
-        const { id_field } = req.query;
-        const result = await mcp.deleteRecord({
-            table_name: tableName,
-            conditions: [{ field: id_field || 'id', operator: '=', value: id }]
-        });
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-// Query Tools Routes
-apiRouter.post('/query', requestSizeLimit(inputValidation_1.INPUT_LIMITS.MAX_QUERY_LENGTH), validateInput(inputValidation_1.validateQuery), async (req, res, next) => {
-    try {
-        const { query, params } = req.body;
-        const result = await mcp.runSelectQuery({
-            query,
-            params: params || []
-        });
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-apiRouter.post('/execute', requestSizeLimit(inputValidation_1.INPUT_LIMITS.MAX_QUERY_LENGTH), validateInput(inputValidation_1.validateQuery), async (req, res, next) => {
-    try {
-        const { query, params } = req.body;
-        const result = await mcp.executeWriteQuery({
-            query,
-            params: params || []
-        });
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-// Utility Tools Routes
-apiRouter.get('/connection', async (req, res, next) => {
-    try {
-        const result = await mcp.describeConnection();
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-apiRouter.get('/connection/test', async (req, res, next) => {
-    try {
-        const result = await mcp.testConnection();
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-apiRouter.get('/tables/:tableName/relationships', async (req, res, next) => {
-    try {
-        const { tableName } = req.params;
-        const result = await mcp.getTableRelationships({ table_name: tableName });
-        res.json(result);
-    }
-    catch (error) {
-        next(error);
-    }
-});
-// Apply error handler
-app.use(errorHandler);
-// Start the server
-const server = app.listen(PORT, () => {
-    logger.info(`MCP MySQL Server running on port ${PORT}`);
-    console.log(`MCP MySQL Server running on port ${PORT}`);
-});
-// Graceful shutdown
-process.on('SIGTERM', () => {
-    logger.info('SIGTERM signal received: closing HTTP server');
-    server.close(async () => {
-        logger.info('HTTP server closed');
-        await mcp.close();
-        logger.info('Database connections closed');
-        process.exit(0);
-    });
-});
-exports.default = app;