@berthojoris/mcp-mysql-server 1.4.13 → 1.4.14
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.
- package/CHANGELOG.md +12 -0
- package/DOCUMENTATIONS.md +12 -12
- package/README.md +16 -16
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,18 @@ All notable changes to the MySQL MCP Server will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [1.4.14] - 2025-11-22
|
|
9
|
+
|
|
10
|
+
### Fixed
|
|
11
|
+
- **Emoji encoding issues** - Fixed emoji rendering issues in README.md and DOCUMENTATIONS.md
|
|
12
|
+
- Replaced escaped Unicode sequences with proper emoji characters
|
|
13
|
+
- Fixed broken emoji displays throughout documentation
|
|
14
|
+
- Improved visual consistency across all documentation sections
|
|
15
|
+
|
|
16
|
+
### Documentation
|
|
17
|
+
- All emojis in section headers and feature lists now display correctly
|
|
18
|
+
- Enhanced readability with proper emoji rendering
|
|
19
|
+
|
|
8
20
|
## [1.4.13] - 2025-11-22
|
|
9
21
|
|
|
10
22
|
### Changed
|
package/DOCUMENTATIONS.md
CHANGED
|
@@ -6,17 +6,17 @@ This file contains detailed documentation for all features of the MySQL MCP Serv
|
|
|
6
6
|
|
|
7
7
|
## Table of Contents
|
|
8
8
|
|
|
9
|
-
1. [DDL Operations](
|
|
10
|
-
2. [Data Export Tools](
|
|
11
|
-
3. [Transaction Management](
|
|
12
|
-
4. [Stored Procedures](
|
|
13
|
-
5. [Usage Examples](
|
|
14
|
-
6. [Query Logging & Automatic SQL Display](
|
|
15
|
-
7. [Security Features](
|
|
16
|
-
8. [Bulk Operations](
|
|
17
|
-
9. [Troubleshooting](
|
|
18
|
-
10. [License](
|
|
19
|
-
11. [Roadmap](
|
|
9
|
+
1. [DDL Operations](#🏗️-ddl-operations)
|
|
10
|
+
2. [Data Export Tools](#📤-data-export-tools)
|
|
11
|
+
3. [Transaction Management](#💰-transaction-management)
|
|
12
|
+
4. [Stored Procedures](#🔧-stored-procedures)
|
|
13
|
+
5. [Usage Examples](#📋-usage-examples)
|
|
14
|
+
6. [Query Logging & Automatic SQL Display](#📝-query-logging--automatic-sql-display)
|
|
15
|
+
7. [Security Features](#🔒-security-features)
|
|
16
|
+
8. [Bulk Operations](#🚀-bulk-operations)
|
|
17
|
+
9. [Troubleshooting](#🛠️-troubleshooting)
|
|
18
|
+
10. [License](#📄-license)
|
|
19
|
+
11. [Roadmap](#🗺️-roadmap)
|
|
20
20
|
|
|
21
21
|
---
|
|
22
22
|
|
|
@@ -1101,7 +1101,7 @@ Each bulk operation returns performance metrics:
|
|
|
1101
1101
|
|
|
1102
1102
|
---
|
|
1103
1103
|
|
|
1104
|
-
##
|
|
1104
|
+
## 🛠️ Troubleshooting
|
|
1105
1105
|
|
|
1106
1106
|
### MCP Server Not Connecting
|
|
1107
1107
|
|
package/README.md
CHANGED
|
@@ -10,18 +10,18 @@ A fully-featured **Model Context Protocol (MCP)** server for MySQL database inte
|
|
|
10
10
|
## 🌟 Features
|
|
11
11
|
|
|
12
12
|
- ✅ **Full MCP Protocol Support** - Works with Claude Desktop, Cline, Windsurf, and any MCP-compatible AI agent
|
|
13
|
-
-
|
|
13
|
+
- 📝’ **Secure by Default** - Parameterized queries, SQL injection protection, permission-based access control
|
|
14
14
|
- ðŸ› ï¸ **30 Powerful Tools** - Complete database operations (CRUD, DDL, queries, schema inspection, transactions, stored procedures, bulk operations)
|
|
15
15
|
- ðŸŽ›ï¸ **Dynamic Per-Project Permissions** - Each AI agent can have different access levels
|
|
16
16
|
- ðŸ—ï¸ **DDL Support** - Create, alter, and drop tables (when explicitly enabled)
|
|
17
|
-
-
|
|
17
|
+
- 💰 **Transaction Support** - Full ACID transaction management (BEGIN, COMMIT, ROLLBACK)
|
|
18
18
|
- 🌠**Dual Mode** - Run as MCP server OR as REST API
|
|
19
19
|
- 📊 **Rich Metadata** - Table schemas, relationships, connection info
|
|
20
|
-
-
|
|
20
|
+
- ⚡ **TypeScript** - Fully typed with TypeScript definitions
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
24
|
-
##
|
|
24
|
+
## 📦 Installation
|
|
25
25
|
|
|
26
26
|
### Option 1: Quick Start (npx)
|
|
27
27
|
|
|
@@ -40,7 +40,7 @@ mcp-mysql mysql://user:pass@localhost:3306/db "list,read,utility"
|
|
|
40
40
|
|
|
41
41
|
---
|
|
42
42
|
|
|
43
|
-
##
|
|
43
|
+
## 🚀 Quick Start
|
|
44
44
|
|
|
45
45
|
### 1. Set Up Environment
|
|
46
46
|
|
|
@@ -347,7 +347,7 @@ You can have different databases with different permissions in the same AI agent
|
|
|
347
347
|
|
|
348
348
|
---
|
|
349
349
|
|
|
350
|
-
##
|
|
350
|
+
## 🚫 Permission Error Handling
|
|
351
351
|
|
|
352
352
|
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.
|
|
353
353
|
|
|
@@ -422,11 +422,11 @@ Tool description: Update existing records based on conditions
|
|
|
422
422
|
|
|
423
423
|
### Permission Error Benefits
|
|
424
424
|
|
|
425
|
-
1.
|
|
426
|
-
2.
|
|
427
|
-
3.
|
|
428
|
-
4.
|
|
429
|
-
5.
|
|
425
|
+
1. **🎯 Clear Guidance** - Exact permission needed and how to add it
|
|
426
|
+
2. **📋 Current State** - Shows what permissions are currently active
|
|
427
|
+
3. **💡 Example Configuration** - Ready-to-use configuration example
|
|
428
|
+
4. **📖 Tool Context** - Explains what the tool does
|
|
429
|
+
5. **🔐 Security** - Prevents unauthorized operations while being helpful
|
|
430
430
|
|
|
431
431
|
### Troubleshooting Permission Errors
|
|
432
432
|
|
|
@@ -544,19 +544,19 @@ For comprehensive documentation on all features, please see **[DOCUMENTATIONS.md
|
|
|
544
544
|
|
|
545
545
|
- ðŸ—ï¸ **DDL Operations** - Create, alter, and drop tables
|
|
546
546
|
- 📤 **Data Export Tools** - Export data to CSV format
|
|
547
|
-
-
|
|
548
|
-
-
|
|
547
|
+
- 💰 **Transaction Management** - ACID transactions with BEGIN, COMMIT, ROLLBACK
|
|
548
|
+
- 🔧 **Stored Procedures** - Create and execute stored procedures with IN/OUT/INOUT parameters
|
|
549
549
|
- 📋 **Usage Examples** - Real-world examples for all tools
|
|
550
550
|
- 📠**Query Logging & Automatic SQL Display** - See all SQL queries executed automatically
|
|
551
|
-
-
|
|
552
|
-
-
|
|
551
|
+
- 📝’ **Security Features** - Built-in security and best practices
|
|
552
|
+
- 🚀 **Bulk Operations** - High-performance batch processing
|
|
553
553
|
- ðŸ› ï¸ **Troubleshooting** - Common issues and solutions
|
|
554
554
|
- 📄 **License** - MIT License details
|
|
555
555
|
- ðŸ—ºï¸ **Roadmap** - Upcoming features and improvements
|
|
556
556
|
|
|
557
557
|
---
|
|
558
558
|
|
|
559
|
-
##
|
|
559
|
+
## 📄 License
|
|
560
560
|
|
|
561
561
|
MIT License - see [LICENSE](LICENSE) file for details.
|
|
562
562
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@berthojoris/mcp-mysql-server",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.14",
|
|
4
4
|
"description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions and data export capabilities",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|