npm - @berthojoris/mcp-mysql-server - Versions diffs - 1.16.0 → 1.16.2 - Mend

@berthojoris/mcp-mysql-server 1.16.0 → 1.16.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -5,6 +5,27 @@ 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.2] - 2025-12-11
+### Fixed
+- **Documentation Update** - Added missing `ai_enhancement` category to the Documentation Categories table in README.md
+  - The table now correctly shows all 24 documentation categories
+  - Added entry for `ai_enhancement` category with 8 tools and description
+## [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/README.md CHANGED Viewed

@@ -152,7 +152,7 @@ Most AI agents use a similar JSON configuration format. Use the appropriate conf
         "-y",
         "@berthojoris/mysql-mcp",
         "mysql://user:password@localhost:3306/database",
-        "list,read,utility"
+        "list,read,utility,create,update,ddl",
       ]
     }
   }
@@ -168,9 +168,9 @@ Most AI agents use a similar JSON configuration format. Use the appropriate conf
       "args": [
         "-y",
         "@berthojoris/mysql-mcp",
-        "mysql://user:password@localhost:3306/database",
-        "list,read,utility",
-        "database_discovery,crud_operations,custom_queries"
+        "mysql://user:password@localhost:3306/database_name_here",
+        "list,read,utility,create,update,ddl",
+        "database_discovery,crud_operations,custom_queries,schema_management,index_management,constraint_management,table_maintenance,query_optimization,analysis"
       ]
     }
   }
@@ -496,6 +496,7 @@ Use these categories for fine-grained control that matches the tool organization
 | `data_migration` | 5 | Copy, move, clone, sync table data |
 | `schema_migrations` | 9 | Version control for database schema |
 | `analysis` | 4 | AI context optimization and data analysis |
+| `ai_enhancement` | 8 | AI-powered query building, smart search, and documentation generation |
 ### Legacy Categories (Backward Compatible)

package/dist/mcp-server.js CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -1,89 +1,89 @@
-{
-  "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.16.0",
-  "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",
-  "bin": {
-    "mcp-mysql": "bin/mcp-mysql.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/server.js",
-    "start:mcp": "node dist/mcp-server.js",
-    "start:api": "node dist/server.js",
-    "dev": "ts-node src/index.ts",
-    "dev:mcp": "ts-node src/mcp-server.ts",
-    "dev:api": "ts-node src/server.ts",
-    "test": "jest",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "mysql",
-    "database",
-    "llm",
-    "ai",
-    "model-context-protocol",
-    "claude",
-    "cline",
-    "windsurf",
-    "codex",
-    "openai-codex",
-    "agent",
-    "database-tools",
-    "sql",
-    "mysql-client",
-    "ai-tools"
-  ],
-  "author": "Bertho Joris <berthojoris@gmail.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/berthojoris/mysql-mcp.git"
-  },
-  "bugs": {
-    "url": "https://github.com/berthojoris/mysql-mcp/issues"
-  },
-  "homepage": "https://github.com/berthojoris/mysql-mcp#readme",
-  "files": [
-    "dist",
-    "bin",
-    "README.md",
-    "DOCUMENTATIONS.md",
-    "CHANGELOG.md",
-    "LICENSE",
-    "manifest.json"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.20.0",
-    "ajv": "^8.12.0",
-    "cors": "^2.8.5",
-    "dotenv": "^16.3.1",
-    "express": "^4.18.2",
-    "express-rate-limit": "^7.1.5",
-    "helmet": "^7.1.0",
-    "jsonwebtoken": "^9.0.2",
-    "morgan": "^1.10.0",
-    "mysql2": "^3.6.1",
-    "winston": "^3.11.0"
-  },
-  "devDependencies": {
-    "@types/cors": "^2.8.17",
-    "@types/express": "^4.17.21",
-    "@types/helmet": "^0.0.48",
-    "@types/jest": "^29.5.4",
-    "@types/jsonwebtoken": "^9.0.5",
-    "@types/morgan": "^1.9.9",
-    "@types/node": "^20.6.0",
-    "@types/winston": "^2.4.4",
-    "jest": "^29.6.4",
-    "ts-jest": "^29.1.1",
-    "ts-node": "^10.9.1",
-    "typescript": "^5.2.2"
-  }
-}
+{
+  "name": "@berthojoris/mcp-mysql-server",
+  "version": "1.16.2",
+  "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",
+  "bin": {
+    "mcp-mysql": "bin/mcp-mysql.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "start:mcp": "node dist/mcp-server.js",
+    "start:api": "node dist/server.js",
+    "dev": "ts-node src/index.ts",
+    "dev:mcp": "ts-node src/mcp-server.ts",
+    "dev:api": "ts-node src/server.ts",
+    "test": "jest",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "mysql",
+    "database",
+    "llm",
+    "ai",
+    "model-context-protocol",
+    "claude",
+    "cline",
+    "windsurf",
+    "codex",
+    "openai-codex",
+    "agent",
+    "database-tools",
+    "sql",
+    "mysql-client",
+    "ai-tools"
+  ],
+  "author": "Bertho Joris <berthojoris@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/berthojoris/mysql-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/berthojoris/mysql-mcp/issues"
+  },
+  "homepage": "https://github.com/berthojoris/mysql-mcp#readme",
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "DOCUMENTATIONS.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "manifest.json"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "ajv": "^8.12.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-rate-limit": "^7.1.5",
+    "helmet": "^7.1.0",
+    "jsonwebtoken": "^9.0.2",
+    "morgan": "^1.10.0",
+    "mysql2": "^3.6.1",
+    "winston": "^3.11.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/helmet": "^0.0.48",
+    "@types/jest": "^29.5.4",
+    "@types/jsonwebtoken": "^9.0.5",
+    "@types/morgan": "^1.9.9",
+    "@types/node": "^20.6.0",
+    "@types/winston": "^2.4.4",
+    "jest": "^29.6.4",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.2.2"
+  }
+}