@berthojoris/mcp-mysql-server 1.4.13 → 1.4.15

package/CHANGELOG.md

@@ -5,6 +5,31 @@ 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.15] - 2025-11-22
+
+### Fixed
+- **README.md Unicode encoding** - Fixed broken Unicode characters in Features section
+  - Corrected emoji encodings: 🌟 (star), ✅ (checkmark), 🔐 (lock), 🛠️ (tools), 🎛️ (control knobs), 🗃️ (file cabinet), 💎 (gem), 🌐 (globe), 📊 (chart)
+  - Removed BOM (Byte Order Mark) from file
+  - All emojis now display correctly across all platforms
+  - Fixed table formatting in Bulk Operations section
+
+### Documentation
+- Enhanced visual consistency in Features section
+- Improved readability with proper emoji rendering
+
+## [1.4.14] - 2025-11-22
+
+### Fixed
+- **Emoji encoding issues** - Fixed emoji rendering issues in README.md and DOCUMENTATIONS.md
+  - Replaced escaped Unicode sequences with proper emoji characters
+  - Fixed broken emoji displays throughout documentation
+  - Improved visual consistency across all documentation sections
+
+### Documentation
+- All emojis in section headers and feature lists now display correctly
+- Enhanced readability with proper emoji rendering
+
 ## [1.4.13] - 2025-11-22
 
 ### Changed

package/DOCUMENTATIONS.md

@@ -6,17 +6,17 @@ This file contains detailed documentation for all features of the MySQL MCP Serv
 
 ## Table of Contents
 
-1. [DDL Operations](#-ddl-operations)
-2. [Data Export Tools](#-data-export-tools)
-3. [Transaction Management](#-transaction-management)
-4. [Stored Procedures](#-stored-procedures)
-5. [Usage Examples](#-usage-examples)
-6. [Query Logging & Automatic SQL Display](#-query-logging--automatic-sql-display)
-7. [Security Features](#-security-features)
-8. [Bulk Operations](#-bulk-operations)
-9. [Troubleshooting](#-troubleshooting)
-10. [License](#-license)
-11. [Roadmap](#️-roadmap)
+1. [DDL Operations](#🏗️-ddl-operations)
+2. [Data Export Tools](#📤-data-export-tools)
+3. [Transaction Management](#💰-transaction-management)
+4. [Stored Procedures](#🔧-stored-procedures)
+5. [Usage Examples](#📋-usage-examples)
+6. [Query Logging & Automatic SQL Display](#📝-query-logging--automatic-sql-display)
+7. [Security Features](#🔒-security-features)
+8. [Bulk Operations](#🚀-bulk-operations)
+9. [Troubleshooting](#🛠️-troubleshooting)
+10. [License](#📄-license)
+11. [Roadmap](#🗺️-roadmap)
 
 ---
 
@@ -1101,7 +1101,7 @@ Each bulk operation returns performance metrics:
 
 ---
 
-##  Troubleshooting
+## 🛠️ Troubleshooting
 
 ### MCP Server Not Connecting
 

package/README.md

@@ -7,21 +7,21 @@ A fully-featured **Model Context Protocol (MCP)** server for MySQL database inte
 
 ---
 
-## 🌟 Features
-
-- ✅ **Full MCP Protocol Support** - Works with Claude Desktop, Cline, Windsurf, and any MCP-compatible AI agent
-- 🔒 **Secure by Default** - Parameterized queries, SQL injection protection, permission-based access control
-- 🛠️ **30 Powerful Tools** - Complete database operations (CRUD, DDL, queries, schema inspection, transactions, stored procedures, bulk operations)
-- 🎛️ **Dynamic Per-Project Permissions** - Each AI agent can have different access levels
-- 🏗️ **DDL Support** - Create, alter, and drop tables (when explicitly enabled)
-- 💰 **Transaction Support** - Full ACID transaction management (BEGIN, COMMIT, ROLLBACK)
-- 🌐 **Dual Mode** - Run as MCP server OR as REST API
-- 📊 **Rich Metadata** - Table schemas, relationships, connection info
-- âš¡ **TypeScript** - Fully typed with TypeScript definitions
+## 🌟 Features
+
+- ✅ **Full MCP Protocol Support** - Works with Claude Desktop, Cline, Windsurf, and any MCP-compatible AI agent
+- 🔐 **Secure by Default** - Parameterized queries, SQL injection protection, permission-based access control
+- 🛠️ **30 Powerful Tools** - Complete database operations (CRUD, DDL, queries, schema inspection, transactions, stored procedures, bulk operations)
+- 🎛️ **Dynamic Per-Project Permissions** - Each AI agent can have different access levels
+- 🗃️ **DDL Support** - Create, alter, and drop tables (when explicitly enabled)
+- 💎 **Transaction Support** - Full ACID transaction management (BEGIN, COMMIT, ROLLBACK)
+- 🌐 **Dual Mode** - Run as MCP server OR as REST API
+- 📊 **Rich Metadata** - Table schemas, relationships, connection info
+- ⚡ **TypeScript** - Fully typed with TypeScript definitions
 
 ---
 
-## 📦 Installation
+## 📦 Installation
 
 ### Option 1: Quick Start (npx)
 
@@ -40,7 +40,7 @@ mcp-mysql mysql://user:pass@localhost:3306/db "list,read,utility"
 
 ---
 
-## 🚀 Quick Start
+## 🚀 Quick Start
 
 ### 1. Set Up Environment
 
@@ -254,7 +254,7 @@ Control access with these permission categories:
 {
   "args": [
     "mysql://user:pass@localhost:3306/db",
-    "list,read,utility"  // ← Permissions here
+    "list,read,utility"  // ← Permissions here
   ]
 }
 ```
@@ -347,7 +347,7 @@ You can have different databases with different permissions in the same AI agent
 
 ---
 
-## 🚫 Permission Error Handling
+## 🚫 Permission Error Handling
 
 The MySQL MCP Server provides clear, user-friendly error messages when operations are attempted without proper permissions. This helps users understand exactly what permissions are needed and how to enable them.
 
@@ -356,7 +356,7 @@ The MySQL MCP Server provides clear, user-friendly error messages when operation
 When a tool is called without the required permission, you'll receive a detailed error message like:
 
 ```
-❌ Permission denied: Cannot use tool 'create_table'. This tool requires 'ddl' permission.
+❌ Permission denied: Cannot use tool 'create_table'. This tool requires 'ddl' permission.
 
 Current permissions: list,read,utility
 To enable this tool, add 'ddl' to your permissions configuration.
@@ -375,7 +375,7 @@ Tool description: Create new tables with columns and indexes
 
 **Error response when DDL not enabled:**
 ```
-❌ Permission denied: Cannot use tool 'create_table'. This tool requires 'ddl' permission.
+❌ Permission denied: Cannot use tool 'create_table'. This tool requires 'ddl' permission.
 
 Current permissions: list,read,utility
 To enable this tool, add 'ddl' to your permissions configuration.
@@ -392,7 +392,7 @@ Tool description: Create new tables with columns and indexes
 
 **Error response when CREATE not enabled:**
 ```
-❌ Permission denied: Cannot use tool 'create_record'. This tool requires 'create' permission.
+❌ Permission denied: Cannot use tool 'create_record'. This tool requires 'create' permission.
 
 Current permissions: list,read,utility
 To enable this tool, add 'create' to your permissions configuration.
@@ -409,7 +409,7 @@ Tool description: Insert new records with automatic SQL generation
 
 **Error response when UPDATE not enabled:**
 ```
-❌ Permission denied: Cannot use tool 'update_record'. This tool requires 'update' permission.
+❌ Permission denied: Cannot use tool 'update_record'. This tool requires 'update' permission.
 
 Current permissions: list,read,utility
 To enable this tool, add 'update' to your permissions configuration.
@@ -422,11 +422,11 @@ Tool description: Update existing records based on conditions
 
 ### Permission Error Benefits
 
-1. **🎯 Clear Guidance** - Exact permission needed and how to add it
-2. **📋 Current State** - Shows what permissions are currently active
-3. **💡 Example Configuration** - Ready-to-use configuration example
-4. **📖 Tool Context** - Explains what the tool does
-5. **🔒 Security** - Prevents unauthorized operations while being helpful
+1. **🎯 Clear Guidance** - Exact permission needed and how to add it
+2. **📋 Current State** - Shows what permissions are currently active
+3. **💡 Example Configuration** - Ready-to-use configuration example
+4. **📖 Tool Context** - Explains what the tool does
+5. **🔐 Security** - Prevents unauthorized operations while being helpful
 
 ### Troubleshooting Permission Errors
 
@@ -461,7 +461,7 @@ After (DDL enabled):
 
 ---
 
-## 🛠️ Available Tools
+## 🛠️ Available Tools
 
 The MCP server provides **30 powerful tools**:
 
@@ -485,7 +485,9 @@ The MCP server provides **30 powerful tools**:
 
 ### Bulk Operations (3 tools)
 
-| Tool | Description | Performance |
+| Tool | Description | 
+
+| Performance |
 |------|-------------|-------------|
 | `bulk_insert` | Insert multiple records in batches for optimal performance | Up to 10,000 records per batch |
 | `bulk_update` | Update multiple records with different conditions in batches | Up to 1,000 operations per batch |
@@ -538,31 +540,30 @@ The MCP server provides **30 powerful tools**:
 
 ---
 
-## 📚 Detailed Documentation
+## 📚 Detailed Documentation
 
 For comprehensive documentation on all features, please see **[DOCUMENTATIONS.md](DOCUMENTATIONS.md)** which includes:
 
-- 🏗️ **DDL Operations** - Create, alter, and drop tables
-- 📤 **Data Export Tools** - Export data to CSV format
-- 💰 **Transaction Management** - ACID transactions with BEGIN, COMMIT, ROLLBACK
-- 🔧 **Stored Procedures** - Create and execute stored procedures with IN/OUT/INOUT parameters
-- 📋 **Usage Examples** - Real-world examples for all tools
-- 📝 **Query Logging & Automatic SQL Display** - See all SQL queries executed automatically
-- 🔒 **Security Features** - Built-in security and best practices
-- 🚀 **Bulk Operations** - High-performance batch processing
-- 🛠️ **Troubleshooting** - Common issues and solutions
-- 📄 **License** - MIT License details
-- 🗺️ **Roadmap** - Upcoming features and improvements
+- 🗃️ **DDL Operations** - Create, alter, and drop tables
+- 📤 **Data Export Tools** - Export data to CSV format
+- 💎 **Transaction Management** - ACID transactions with BEGIN, COMMIT, ROLLBACK
+- 🔧 **Stored Procedures** - Create and execute stored procedures with IN/OUT/INOUT parameters
+- 📋 **Usage Examples** - Real-world examples for all tools
+- 🔍 **Query Logging & Automatic SQL Display** - See all SQL queries executed automatically
+- 🔐 **Security Features** - Built-in security and best practices
+- 🚀 **Bulk Operations** - High-performance batch processing
+- 🛠️ **Troubleshooting** - Common issues and solutions
+- 📄 **License** - MIT License details
+- 🗺️ **Roadmap** - Upcoming features and improvements
 
 ---
 
-## 📄 License
+## 📄 License
 
 MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-**Made with ❤️ for the AI community**
+**Made with ❤️ for the AI community**
 
 *Help AI agents interact with MySQL databases safely and efficiently!*
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.4.13",
+  "version": "1.4.15",
   "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",