@berthojoris/mcp-mysql-server 1.4.0 → 1.4.2

package/CHANGELOG.md

@@ -0,0 +1,81 @@
+# Changelog
+
+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.4.2] - 2025-01-04
+
+### Changed
+- Re-published package to ensure README.md displays correctly on npmjs.com
+- No functional changes from version 1.4.1
+
+## [1.4.1] - 2025-01-04
+
+### Fixed
+- **Critical Parameter Validation Fix**: Fixed "Invalid parameters: must be object" error that occurred when AI agents called MCP tools without parameters
+  - Applied defensive parameter handling to all 27 tools that accept parameters
+  - Tools now properly handle cases where MCP SDK passes `undefined` or `null` instead of empty object `{}`
+  - Pattern applied: `(args || {})` ensures parameters are always objects before validation
+  - No breaking changes - existing valid calls continue to work exactly as before
+
+### Changed
+- Enhanced parameter handling in `mcp-server.ts` for all tool handlers:
+  - Database Tools: `list_tables`, `read_table_schema`, `get_table_relationships`
+  - CRUD Tools: `create_record`, `read_records`, `update_record`, `delete_record`, `bulk_insert`, `bulk_update`, `bulk_delete`
+  - Query Tools: `run_query`, `execute_sql`, `execute_ddl`
+  - DDL Tools: `create_table`, `alter_table`, `drop_table`
+  - Transaction Tools: `begin_transaction`, `commit_transaction`, `rollback_transaction`, `execute_in_transaction`
+  - Stored Procedure Tools: `list_stored_procedures`, `get_stored_procedure_info`, `execute_stored_procedure`, `create_stored_procedure`, `drop_stored_procedure`, `show_create_procedure`
+  - Data Export Tools: `export_table_to_csv`, `export_query_to_csv`
+
+### Documentation
+- Added troubleshooting section in README.md for parameter validation errors
+- Created CHANGELOG.md to track version changes
+- Documented the fix and upgrade path for users experiencing this issue
+
+## [1.4.0] - 2024-12-XX
+
+### Added
+- Data Export Tools (`export_table_to_csv`, `export_query_to_csv`)
+- Bulk Operations (`bulk_insert`, `bulk_update`, `bulk_delete`)
+- Transaction Management (5 tools)
+- Stored Procedure Support (5 tools)
+- Enhanced permission error messages
+- Per-project permission configuration
+
+### Changed
+- Improved security with fine-grained permission system
+- Better error handling and user feedback
+- Performance optimizations for bulk operations
+
+## [1.3.0] - 2024-XX-XX
+
+### Added
+- DDL Operations (Create, Alter, Drop Table)
+- Schema Management Tools
+- Permission-based access control
+- MCP protocol support
+
+## [1.2.0] - 2024-XX-XX
+
+### Added
+- REST API mode
+- Connection testing utilities
+- Foreign key relationship discovery
+
+## [1.1.0] - 2024-XX-XX
+
+### Added
+- CRUD operations
+- Custom SQL query execution
+- Parameterized queries
+
+## [1.0.0] - 2024-XX-XX
+
+### Added
+- Initial release
+- Basic database listing
+- Table schema inspection
+- MySQL connection support

package/README.md

@@ -1364,6 +1364,40 @@ FLUSH PRIVILEGES;
 }
 ```
 
+### Parameter Validation Errors
+
+**Problem:** "Invalid parameters: must be object" error
+
+**Symptoms:**
+- Tools fail when called without parameters
+- Error message: `Error: Invalid parameters: [{"instancePath":"","schemaPath":"#/type","keyword":"type","params":{"type":"object"},"message":"must be object"}]`
+- Occurs especially with tools that have optional parameters like `list_tables`, `begin_transaction`, `list_stored_procedures`
+
+**Cause:**
+This error occurred in earlier versions (< 1.4.1) when AI agents called MCP tools without providing parameters. The MCP SDK sometimes passes `undefined` or `null` instead of an empty object `{}`, causing JSON schema validation to fail.
+
+**Solution:**
+✅ **Fixed in version 1.4.1+** - All 33 tools now include defensive parameter handling that automatically converts `undefined`/`null` to empty objects.
+
+**If you're still experiencing this issue:**
+1. Update to the latest version:
+   ```bash
+   npx -y @berthojoris/mcp-mysql-server@latest mysql://user:pass@localhost:3306/db "permissions"
+   ```
+
+2. If using global installation:
+   ```bash
+   npm update -g @berthojoris/mcp-mysql-server
+   ```
+
+3. Restart your AI agent after updating
+
+**Technical Details:**
+- All tool handlers now use defensive pattern: `(args || {})` to ensure parameters are always objects
+- This fix applies to all 27 tools that accept parameters
+- Tools with no parameters (like `list_databases`, `test_connection`) were not affected
+- No breaking changes - existing valid calls continue to work exactly as before
+
 ---
 
 ## 📄 License

package/dist/mcp-server.js

@@ -770,7 +770,7 @@ const TOOLS = [
 // Create the MCP server
 const server = new index_js_1.Server({
     name: 'mysql-mcp-server',
-    version: '1.3.0',
+    version: '1.4.2',
 }, {
     capabilities: {
         tools: {},
@@ -792,49 +792,49 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 result = await mysqlMCP.listDatabases();
                 break;
             case 'list_tables':
-                result = await mysqlMCP.listTables(args);
+                result = await mysqlMCP.listTables((args || {}));
                 break;
             case 'read_table_schema':
-                result = await mysqlMCP.readTableSchema(args);
+                result = await mysqlMCP.readTableSchema((args || {}));
                 break;
             case 'create_record':
-                result = await mysqlMCP.createRecord(args);
+                result = await mysqlMCP.createRecord((args || {}));
                 break;
             case 'read_records':
-                result = await mysqlMCP.readRecords(args);
+                result = await mysqlMCP.readRecords((args || {}));
                 break;
             case 'update_record':
-                result = await mysqlMCP.updateRecord(args);
+                result = await mysqlMCP.updateRecord((args || {}));
                 break;
             case 'delete_record':
-                result = await mysqlMCP.deleteRecord(args);
+                result = await mysqlMCP.deleteRecord((args || {}));
                 break;
             case 'bulk_insert':
-                result = await mysqlMCP.bulkInsert(args);
+                result = await mysqlMCP.bulkInsert((args || {}));
                 break;
             case 'bulk_update':
-                result = await mysqlMCP.bulkUpdate(args);
+                result = await mysqlMCP.bulkUpdate((args || {}));
                 break;
             case 'bulk_delete':
-                result = await mysqlMCP.bulkDelete(args);
+                result = await mysqlMCP.bulkDelete((args || {}));
                 break;
             case 'run_query':
-                result = await mysqlMCP.runQuery(args);
+                result = await mysqlMCP.runQuery((args || {}));
                 break;
             case 'execute_sql':
-                result = await mysqlMCP.executeSql(args);
+                result = await mysqlMCP.executeSql((args || {}));
                 break;
             case 'create_table':
-                result = await mysqlMCP.createTable(args);
+                result = await mysqlMCP.createTable(args || {});
                 break;
             case 'alter_table':
-                result = await mysqlMCP.alterTable(args);
+                result = await mysqlMCP.alterTable(args || {});
                 break;
             case 'drop_table':
-                result = await mysqlMCP.dropTable(args);
+                result = await mysqlMCP.dropTable(args || {});
                 break;
             case 'execute_ddl':
-                result = await mysqlMCP.executeDdl(args);
+                result = await mysqlMCP.executeDdl((args || {}));
                 break;
             case 'describe_connection':
                 result = await mysqlMCP.describeConnection();
@@ -843,49 +843,49 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 result = await mysqlMCP.testConnection();
                 break;
             case 'get_table_relationships':
-                result = await mysqlMCP.getTableRelationships(args);
+                result = await mysqlMCP.getTableRelationships((args || {}));
                 break;
             // Transaction Tools
             case 'begin_transaction':
-                result = await mysqlMCP.beginTransaction(args);
+                result = await mysqlMCP.beginTransaction((args || {}));
                 break;
             case 'commit_transaction':
-                result = await mysqlMCP.commitTransaction(args);
+                result = await mysqlMCP.commitTransaction((args || {}));
                 break;
             case 'rollback_transaction':
-                result = await mysqlMCP.rollbackTransaction(args);
+                result = await mysqlMCP.rollbackTransaction((args || {}));
                 break;
             case 'get_transaction_status':
                 result = await mysqlMCP.getTransactionStatus();
                 break;
             case 'execute_in_transaction':
-                result = await mysqlMCP.executeInTransaction(args);
+                result = await mysqlMCP.executeInTransaction((args || {}));
                 break;
             // Stored Procedure Tools
             case 'list_stored_procedures':
-                result = await mysqlMCP.listStoredProcedures(args);
+                result = await mysqlMCP.listStoredProcedures((args || {}));
                 break;
             case 'get_stored_procedure_info':
-                result = await mysqlMCP.getStoredProcedureInfo(args);
+                result = await mysqlMCP.getStoredProcedureInfo((args || {}));
                 break;
             case 'execute_stored_procedure':
-                result = await mysqlMCP.executeStoredProcedure(args);
+                result = await mysqlMCP.executeStoredProcedure((args || {}));
                 break;
             case 'create_stored_procedure':
-                result = await mysqlMCP.createStoredProcedure(args);
+                result = await mysqlMCP.createStoredProcedure((args || {}));
                 break;
             case 'drop_stored_procedure':
-                result = await mysqlMCP.dropStoredProcedure(args);
+                result = await mysqlMCP.dropStoredProcedure((args || {}));
                 break;
             case 'show_create_procedure':
-                result = await mysqlMCP.showCreateProcedure(args);
+                result = await mysqlMCP.showCreateProcedure((args || {}));
                 break;
             // Data Export Tools
             case 'export_table_to_csv':
-                result = await mysqlMCP.exportTableToCSV(args);
+                result = await mysqlMCP.exportTableToCSV((args || {}));
                 break;
             case 'export_query_to_csv':
-                result = await mysqlMCP.exportQueryToCSV(args);
+                result = await mysqlMCP.exportQueryToCSV((args || {}));
                 break;
             default:
                 throw new Error(`Unknown tool: ${name}`);

package/manifest.json

@@ -1,248 +1,248 @@
-{
-  "name": "mysql-mcp",
-  "description": "A Model Context Protocol for MySQL database interaction",
-  "version": "1.2.6",
-  "tools": [
-    {
-      "name": "list_databases",
-      "description": "Lists all databases available on the MySQL server.",
-      "input_schema": {},
-      "output_schema": {
-        "type": "array",
-        "items": { "type": "string" }
-      }
-    },
-    {
-      "name": "list_tables",
-      "description": "Lists all tables in the connected MySQL database.",
-      "input_schema": {},
-      "output_schema": {
-        "type": "array",
-        "items": { "type": "string" }
-      }
-    },
-    {
-      "name": "read_table_schema",
-      "description": "Reads the schema of a specified table.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "table_name": { "type": "string" }
-        },
-        "required": ["table_name"]
-      },
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "columns": { 
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "name": { "type": "string" },
-                "type": { "type": "string" },
-                "nullable": { "type": "boolean" },
-                "default": { "type": ["string", "null"] },
-                "primary_key": { "type": "boolean" }
-              }
-            }
-          },
-          "primary_key": { "type": ["string", "null"] },
-          "indexes": { 
-            "type": "array",
-            "items": { "type": "string" }
-          }
-        }
-      }
-    },
-    {
-      "name": "create_record",
-      "description": "Creates a new record in the specified table.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "table_name": { "type": "string" },
-          "data": { "type": "object" }
-        },
-        "required": ["table_name", "data"]
-      },
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "success": { "type": "boolean" },
-          "id": { "type": ["string", "number"] },
-          "affected_rows": { "type": "number" }
-        }
-      }
-    },
-    {
-      "name": "read_records",
-      "description": "Reads records from the specified table with optional filtering, pagination, and sorting.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "table_name": { "type": "string" },
-          "filters": { "type": "object" },
-          "limit": { "type": "number" },
-          "offset": { "type": "number" },
-          "sort_by": { "type": "string" },
-          "sort_direction": { "type": "string", "enum": ["ASC", "DESC"] }
-        },
-        "required": ["table_name"]
-      },
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "records": { "type": "array" },
-          "total": { "type": "number" }
-        }
-      }
-    },
-    {
-      "name": "update_record",
-      "description": "Updates an existing record in the specified table.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "table_name": { "type": "string" },
-          "id_field": { "type": "string" },
-          "id": { "type": ["string", "number"] },
-          "data": { "type": "object" }
-        },
-        "required": ["table_name", "id", "data"]
-      },
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "success": { "type": "boolean" },
-          "affected_rows": { "type": "number" }
-        }
-      }
-    },
-    {
-      "name": "delete_record",
-      "description": "Deletes a record from the specified table.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "table_name": { "type": "string" },
-          "id_field": { "type": "string" },
-          "id": { "type": ["string", "number"] }
-        },
-        "required": ["table_name", "id"]
-      },
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "success": { "type": "boolean" },
-          "affected_rows": { "type": "number" }
-        }
-      }
-    },
-    {
-      "name": "run_query",
-      "description": "Runs a read-only SQL query with optional parameters.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "query": { "type": "string" },
-          "params": { "type": "array" }
-        },
-        "required": ["query"]
-      },
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "results": { "type": "array" },
-          "fields": { "type": "array" }
-        }
-      }
-    },
-    {
-      "name": "execute_sql",
-      "description": "Executes a write SQL operation (INSERT, UPDATE, DELETE) with optional parameters.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "query": { "type": "string" },
-          "params": { "type": "array" }
-        },
-        "required": ["query"]
-      },
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "success": { "type": "boolean" },
-          "affected_rows": { "type": "number" },
-          "insert_id": { "type": ["number", "null"] }
-        }
-      }
-    },
-    {
-      "name": "describe_connection",
-      "description": "Returns information about the current database connection.",
-      "input_schema": {},
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "host": { "type": "string" },
-          "port": { "type": "number" },
-          "database": { "type": "string" },
-          "user": { "type": "string" },
-          "connected": { "type": "boolean" }
-        }
-      }
-    },
-    {
-      "name": "test_connection",
-      "description": "Tests the database connection and returns latency information.",
-      "input_schema": {},
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "success": { "type": "boolean" },
-          "latency_ms": { "type": "number" },
-          "message": { "type": "string" }
-        }
-      }
-    },
-    {
-      "name": "get_table_relationships",
-      "description": "Returns foreign key relationships for a specified table.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "table_name": { "type": "string" }
-        },
-        "required": ["table_name"]
-      },
-      "output_schema": {
-        "type": "object",
-        "properties": {
-          "as_parent": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "table": { "type": "string" },
-                "column": { "type": "string" },
-                "referenced_column": { "type": "string" }
-              }
-            }
-          },
-          "as_child": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "table": { "type": "string" },
-                "column": { "type": "string" },
-                "referenced_column": { "type": "string" }
-              }
-            }
-          }
-        }
-      }
-    }
-  ]
+{
+  "name": "mysql-mcp",
+  "description": "A Model Context Protocol for MySQL database interaction",
+  "version": "1.2.6",
+  "tools": [
+    {
+      "name": "list_databases",
+      "description": "Lists all databases available on the MySQL server.",
+      "input_schema": {},
+      "output_schema": {
+        "type": "array",
+        "items": { "type": "string" }
+      }
+    },
+    {
+      "name": "list_tables",
+      "description": "Lists all tables in the connected MySQL database.",
+      "input_schema": {},
+      "output_schema": {
+        "type": "array",
+        "items": { "type": "string" }
+      }
+    },
+    {
+      "name": "read_table_schema",
+      "description": "Reads the schema of a specified table.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "table_name": { "type": "string" }
+        },
+        "required": ["table_name"]
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "columns": { 
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": { "type": "string" },
+                "type": { "type": "string" },
+                "nullable": { "type": "boolean" },
+                "default": { "type": ["string", "null"] },
+                "primary_key": { "type": "boolean" }
+              }
+            }
+          },
+          "primary_key": { "type": ["string", "null"] },
+          "indexes": { 
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        }
+      }
+    },
+    {
+      "name": "create_record",
+      "description": "Creates a new record in the specified table.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "table_name": { "type": "string" },
+          "data": { "type": "object" }
+        },
+        "required": ["table_name", "data"]
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "success": { "type": "boolean" },
+          "id": { "type": ["string", "number"] },
+          "affected_rows": { "type": "number" }
+        }
+      }
+    },
+    {
+      "name": "read_records",
+      "description": "Reads records from the specified table with optional filtering, pagination, and sorting.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "table_name": { "type": "string" },
+          "filters": { "type": "object" },
+          "limit": { "type": "number" },
+          "offset": { "type": "number" },
+          "sort_by": { "type": "string" },
+          "sort_direction": { "type": "string", "enum": ["ASC", "DESC"] }
+        },
+        "required": ["table_name"]
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "records": { "type": "array" },
+          "total": { "type": "number" }
+        }
+      }
+    },
+    {
+      "name": "update_record",
+      "description": "Updates an existing record in the specified table.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "table_name": { "type": "string" },
+          "id_field": { "type": "string" },
+          "id": { "type": ["string", "number"] },
+          "data": { "type": "object" }
+        },
+        "required": ["table_name", "id", "data"]
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "success": { "type": "boolean" },
+          "affected_rows": { "type": "number" }
+        }
+      }
+    },
+    {
+      "name": "delete_record",
+      "description": "Deletes a record from the specified table.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "table_name": { "type": "string" },
+          "id_field": { "type": "string" },
+          "id": { "type": ["string", "number"] }
+        },
+        "required": ["table_name", "id"]
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "success": { "type": "boolean" },
+          "affected_rows": { "type": "number" }
+        }
+      }
+    },
+    {
+      "name": "run_query",
+      "description": "Runs a read-only SQL query with optional parameters.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": { "type": "string" },
+          "params": { "type": "array" }
+        },
+        "required": ["query"]
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "results": { "type": "array" },
+          "fields": { "type": "array" }
+        }
+      }
+    },
+    {
+      "name": "execute_sql",
+      "description": "Executes a write SQL operation (INSERT, UPDATE, DELETE) with optional parameters.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": { "type": "string" },
+          "params": { "type": "array" }
+        },
+        "required": ["query"]
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "success": { "type": "boolean" },
+          "affected_rows": { "type": "number" },
+          "insert_id": { "type": ["number", "null"] }
+        }
+      }
+    },
+    {
+      "name": "describe_connection",
+      "description": "Returns information about the current database connection.",
+      "input_schema": {},
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "host": { "type": "string" },
+          "port": { "type": "number" },
+          "database": { "type": "string" },
+          "user": { "type": "string" },
+          "connected": { "type": "boolean" }
+        }
+      }
+    },
+    {
+      "name": "test_connection",
+      "description": "Tests the database connection and returns latency information.",
+      "input_schema": {},
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "success": { "type": "boolean" },
+          "latency_ms": { "type": "number" },
+          "message": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "get_table_relationships",
+      "description": "Returns foreign key relationships for a specified table.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "table_name": { "type": "string" }
+        },
+        "required": ["table_name"]
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "as_parent": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "table": { "type": "string" },
+                "column": { "type": "string" },
+                "referenced_column": { "type": "string" }
+              }
+            }
+          },
+          "as_child": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "table": { "type": "string" },
+                "column": { "type": "string" },
+                "referenced_column": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions and data export capabilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -49,6 +49,7 @@
     "dist",
     "bin",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     "manifest.json"
   ],