@berthojoris/mcp-mysql-server 1.16.0 → 1.16.1

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.16.1] - 2025-12-09
+
+### Improved
+- **Enhanced Tool Descriptions** - Improved tool descriptions to help LLMs select the correct tool:
+  - `run_query`: Now explicitly states "⚡ USE THIS FOR SELECT QUERIES"
+  - `execute_sql`: Now explicitly states "⚡ USE THIS FOR INSERT/UPDATE/DELETE"
+  - `execute_ddl`: Now explicitly states "⚡ USE THIS FOR DDL ONLY" with clear guidance
+  - Added "NO SELECT queries!" warning to `execute_ddl` parameter description
+
+### Fixed
+- **Better Error Messages** - `execute_ddl` now suggests the correct tool when called with wrong query type:
+  - "For SELECT queries, use the 'run_query' tool instead"
+  - "For INSERT/UPDATE/DELETE, use the 'execute_sql' tool"
+
 ## [1.16.0] - 2025-12-09
 
 ### Added

package/dist/mcp-server.js

@@ -392,7 +392,7 @@ const TOOLS = [
     },
     {
         name: "run_query",
-        description: "Runs a read-only SQL SELECT query with optional parameters, optimizer hints, and caching support. Only SELECT statements are allowed.",
+        description: "⚡ USE THIS FOR SELECT QUERIES. Runs a read-only SQL SELECT query with optional parameters, optimizer hints, and caching support. ONLY SELECT statements are allowed - use execute_sql for INSERT/UPDATE/DELETE, use execute_ddl for CREATE/ALTER/DROP.",
         inputSchema: {
             type: "object",
             properties: {
@@ -459,7 +459,7 @@ const TOOLS = [
     },
     {
         name: "execute_sql",
-        description: 'Executes a write SQL operation (INSERT, UPDATE, DELETE) with optional parameters. DDL operations require "ddl" permission.',
+        description: '⚡ USE THIS FOR INSERT/UPDATE/DELETE. Executes a write SQL operation (INSERT, UPDATE, DELETE) with optional parameters. NOT for SELECT (use run_query), NOT for DDL (use execute_ddl for CREATE/ALTER/DROP/TRUNCATE/RENAME).',
         inputSchema: {
             type: "object",
             properties: {
@@ -639,13 +639,13 @@ const TOOLS = [
     },
     {
         name: "execute_ddl",
-        description: 'Executes raw DDL SQL (CREATE, ALTER, DROP, TRUNCATE, RENAME). Requires "ddl" permission.',
+        description: '⚡ USE THIS FOR DDL ONLY (CREATE, ALTER, DROP, TRUNCATE, RENAME). NOT for SELECT (use run_query), NOT for INSERT/UPDATE/DELETE (use execute_sql). Requires "ddl" permission.',
         inputSchema: {
             type: "object",
             properties: {
                 query: {
                     type: "string",
-                    description: "DDL SQL query to execute",
+                    description: "DDL SQL query to execute (must start with CREATE, ALTER, DROP, TRUNCATE, or RENAME - NO SELECT queries!)",
                 },
             },
             required: ["query"],
@@ -3119,6 +3119,40 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "read_table_schema":
                 result = await mysqlMCP.readTableSchema((args || {}));
                 break;
+            // CRUD Tools
+            case "create_record":
+                result = await mysqlMCP.createRecord((args || {}));
+                break;
+            case "read_records":
+                result = await mysqlMCP.readRecords((args || {}));
+                break;
+            case "update_record":
+                result = await mysqlMCP.updateRecord((args || {}));
+                break;
+            case "delete_record":
+                result = await mysqlMCP.deleteRecord((args || {}));
+                break;
+            // Bulk Operations
+            case "bulk_insert":
+                result = await mysqlMCP.bulkInsert((args || {}));
+                break;
+            case "bulk_update":
+                result = await mysqlMCP.bulkUpdate((args || {}));
+                break;
+            case "bulk_delete":
+                result = await mysqlMCP.bulkDelete((args || {}));
+                break;
+            // Query Tools
+            case "run_query":
+                result = await mysqlMCP.runQuery((args || {}));
+                break;
+            case "execute_sql":
+                result = await mysqlMCP.executeSql((args || {}));
+                break;
+            // DDL Tools
+            case "create_table":
+                result = await mysqlMCP.createTable(args || {});
+                break;
             case "alter_table":
                 result = await mysqlMCP.alterTable(args || {});
                 break;

package/dist/tools/ddlTools.js

@@ -201,7 +201,7 @@ class DdlTools {
             if (!isDdl) {
                 return {
                     status: "error",
-                    error: "Only DDL operations (CREATE, ALTER, DROP, TRUNCATE, RENAME) are allowed with executeDdl",
+                    error: "Only DDL operations (CREATE, ALTER, DROP, TRUNCATE, RENAME) are allowed with execute_ddl. For SELECT queries, use the 'run_query' tool instead. For INSERT/UPDATE/DELETE, use the 'execute_sql' tool.",
                 };
             }
             const result = await this.db.query(query);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.16.0",
+  "version": "1.16.1",
   "description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions, backup/restore, data import/export, and data migration capabilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",