@berthojoris/mcp-mysql-server 1.16.1 → 1.16.3

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.3] - 2025-12-11
+
+### Documentation
+- **README.md Enhancement** - Added comprehensive AI Enhancement tools documentation
+  - Updated total tool count from 134 to 142 tools
+  - Added detailed "🤖 AI Enhancement Tools (Phase 1 - Implemented)" section
+  - Listed all 8 AI tools in Available Tools table with full names
+  - Included practical use cases for each AI tool category
+  - Tools documented: `build_query_from_intent`, `suggest_query_improvements`, `smart_search`, 
+    `find_similar_columns`, `discover_data_patterns`, `generate_documentation`, 
+    `generate_data_dictionary`, `generate_business_glossary`
+
+## [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

package/README.md

@@ -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)
 
@@ -646,11 +647,11 @@ Use both 2nd argument (permissions) and 3rd argument (categories):
 
 ## Available Tools
 
-The MCP server provides **134 powerful tools** organized into 23 categories:
+The MCP server provides **142 powerful tools** organized into 23 categories:
 
 ### Quick Reference
 
-**134 Tools Available** - Organized into 23 categories
+**142 Tools Available** - Organized into 23 categories
 
 | Category | Count | Key Tools |
 |----------|-------|-----------|
@@ -677,7 +678,28 @@ The MCP server provides **134 powerful tools** organized into 23 categories:
 | Schema Migrations | 9 | `create_migration`, `apply_migrations` |
 | Utilities | 4 | `test_connection`, `export_table_to_csv` |
 | Analysis | 4 | `get_column_statistics`, `get_database_summary`, `get_schema_erd` |
-| **AI Enhancement** | 8 | `build_query_from_intent`, `smart_search`, `generate_documentation` |
+| **AI Enhancement** | 8 | `build_query_from_intent`, `suggest_query_improvements`, `smart_search`, `find_similar_columns`, `discover_data_patterns`, `generate_documentation`, `generate_data_dictionary`, `generate_business_glossary` |
+
+### 🤖 AI Enhancement Tools (Phase 1 - Implemented)
+
+The MySQL MCP server includes advanced AI-powered productivity tools:
+
+#### **Intelligent Query Assistant** 
+- **`build_query_from_intent`** - Converts natural language to optimized SQL queries
+- **`suggest_query_improvements`** - AI-powered query optimization suggestions
+- *Use case: "Show me active users from last month" → Automatically generates SQL*
+
+#### **Smart Data Discovery Agent**
+- **`smart_search`** - Semantic search for tables, columns, and data patterns  
+- **`find_similar_columns`** - Discover columns with similar names or data patterns
+- **`discover_data_patterns`** - Automatic identification of data patterns and relationships
+- *Use case: Find all customer-related columns across hundreds of tables*
+
+#### **AI-Powered Documentation Generator**
+- **`generate_documentation`** - Automatic database documentation with business glossary
+- **`generate_data_dictionary`** - Interactive data dictionaries with examples
+- **`generate_business_glossary`** - Business terminology mapping to technical fields
+- *Use case: Generate complete documentation for a new database in seconds*
 
 > **📖 For detailed tool descriptions, parameters, and examples, see [DOCUMENTATIONS.md](DOCUMENTATIONS.md#🔧-complete-tools-reference)**
 
@@ -695,7 +717,7 @@ For comprehensive documentation, see **[DOCUMENTATIONS.md](DOCUMENTATIONS.md)**:
 - **Schema Versioning** - Version control for database schema changes
 - **Transaction Management** - ACID transactions
 - **Stored Procedures** - Create and execute with IN/OUT/INOUT parameters
-- **AI Enhancement** - Natural language to SQL, smart discovery, and auto-documentation
+- **🤖 AI Enhancement** - Natural language to SQL, smart data discovery, and auto-documentation (Phase 1 Complete)
 - **Query Logging** - See all SQL queries executed automatically
 - **Security Features** - Built-in security and best practices
 - **Bulk Operations** - High-performance batch processing

package/package.json

@@ -1,89 +1,89 @@
-{
-  "name": "@berthojoris/mcp-mysql-server",
-  "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",
-  "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.3",
+  "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"
+  }
+}