@berthojoris/mcp-mysql-server 1.4.4 → 1.4.5

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 (3) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/README.md +78 -78
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -5,6 +5,15 @@ 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.5] - 2025-01-08
9
+
10
+ ### Changed
11
+ - Reorganized README.md structure - moved "Permission System" section to appear before "Available Tools" section for better user understanding
12
+ - Updated documentation organization to improve readability and user experience
13
+
14
+ ### Fixed
15
+ - Minor documentation formatting improvements
16
+
8
17
  ## [1.4.4] - 2025-01-07
9
18
 
10
19
  ### Fixed
package/README.md CHANGED
@@ -144,84 +144,7 @@ Try asking your AI:
144
144
 
145
145
  ---
146
146
 
147
- ## 🛠️ Available Tools
148
-
149
- The MCP server provides **30 powerful tools**:
150
-
151
- ### Database Discovery (4 tools)
152
-
153
- | Tool | Description |
154
- |------|-------------|
155
- | `list_databases` | Lists all databases on the MySQL server |
156
- | `list_tables` | Lists all tables in the current/specified database |
157
- | `read_table_schema` | Gets detailed schema (columns, types, keys, indexes) |
158
- | `get_table_relationships` | Discovers foreign key relationships |
159
-
160
- ### Data Operations - CRUD (4 tools)
161
-
162
- | Tool | Description |
163
- |------|-------------|
164
- | `create_record` | Insert new records with automatic SQL generation |
165
- | `read_records` | Query records with filtering, pagination, and sorting |
166
- | `update_record` | Update records based on conditions |
167
- | `delete_record` | Delete records with safety checks |
168
-
169
- ### Bulk Operations (3 tools)
170
-
171
- | Tool | Description | Performance |
172
- |------|-------------|-------------|
173
- | `bulk_insert` | Insert multiple records in batches for optimal performance | Up to 10,000 records per batch |
174
- | `bulk_update` | Update multiple records with different conditions in batches | Up to 1,000 operations per batch |
175
- | `bulk_delete` | Delete multiple record sets based on different conditions | Up to 1,000 operations per batch |
176
-
177
- ### Custom Queries (2 tools)
178
-
179
- | Tool | Description |
180
- |------|-------------|
181
- | `run_query` | Execute read-only SELECT queries |
182
- | `execute_sql` | Execute write operations (INSERT, UPDATE, DELETE, or DDL with permission) |
183
-
184
- ### Schema Management - DDL (4 tools)
185
-
186
- | Tool | Description | Requires |
187
- |------|-------------|----------|
188
- | `create_table` | Create new tables with columns and indexes | `ddl` permission |
189
- | `alter_table` | Modify table structure (add/drop/modify columns, indexes) | `ddl` permission |
190
- | `drop_table` | Delete tables | `ddl` permission |
191
- | `execute_ddl` | Execute raw DDL SQL (CREATE, ALTER, DROP, TRUNCATE, RENAME) | `ddl` permission |
192
-
193
- ### Utilities (4 tools)
194
-
195
- | Tool | Description |
196
- |------|-------------|
197
- | `test_connection` | Test database connectivity and measure latency |
198
- | `describe_connection` | Get current connection information |
199
- | `export_table_to_csv` | Export table data to CSV format with optional filtering, pagination, and sorting |
200
- | `export_query_to_csv` | Export the results of a SELECT query to CSV format |
201
-
202
- ### Transaction Management (5 tools)
203
-
204
- | Tool | Description |
205
- |------|-------------|
206
- | `begin_transaction` | Start a new database transaction |
207
- | `commit_transaction` | Commit the current transaction |
208
- | `rollback_transaction` | Rollback the current transaction |
209
- | `get_transaction_status` | Check if a transaction is active |
210
- | `execute_in_transaction` | Execute SQL within a transaction context |
211
-
212
- ### Stored Procedures (5 tools)
213
-
214
- | Tool | Description | Requires |
215
- |------|-------------|----------|
216
- | `list_stored_procedures` | List all stored procedures in a database | `procedure` permission |
217
- | `create_stored_procedure` | Create new stored procedures with parameters | `procedure` permission |
218
- | `get_stored_procedure_info` | Get detailed information about a stored procedure | `procedure` permission |
219
- | `execute_stored_procedure` | Execute stored procedures with IN/OUT/INOUT parameters | `procedure` permission |
220
- | `drop_stored_procedure` | Delete stored procedures | `procedure` permission |
221
-
222
- ---
223
-
224
- ## 🔐 Permission System
147
+ ## Permission System
225
148
 
226
149
  ### Permission Categories
227
150
 
@@ -527,6 +450,83 @@ After (DDL enabled):
527
450
 
528
451
  ---
529
452
 
453
+ ## 🛠️ Available Tools
454
+
455
+ The MCP server provides **30 powerful tools**:
456
+
457
+ ### Database Discovery (4 tools)
458
+
459
+ | Tool | Description |
460
+ |------|-------------|
461
+ | `list_databases` | Lists all databases on the MySQL server |
462
+ | `list_tables` | Lists all tables in the current/specified database |
463
+ | `read_table_schema` | Gets detailed schema (columns, types, keys, indexes) |
464
+ | `get_table_relationships` | Discovers foreign key relationships |
465
+
466
+ ### Data Operations - CRUD (4 tools)
467
+
468
+ | Tool | Description |
469
+ |------|-------------|
470
+ | `create_record` | Insert new records with automatic SQL generation |
471
+ | `read_records` | Query records with filtering, pagination, and sorting |
472
+ | `update_record` | Update records based on conditions |
473
+ | `delete_record` | Delete records with safety checks |
474
+
475
+ ### Bulk Operations (3 tools)
476
+
477
+ | Tool | Description | Performance |
478
+ |------|-------------|-------------|
479
+ | `bulk_insert` | Insert multiple records in batches for optimal performance | Up to 10,000 records per batch |
480
+ | `bulk_update` | Update multiple records with different conditions in batches | Up to 1,000 operations per batch |
481
+ | `bulk_delete` | Delete multiple record sets based on different conditions | Up to 1,000 operations per batch |
482
+
483
+ ### Custom Queries (2 tools)
484
+
485
+ | Tool | Description |
486
+ |------|-------------|
487
+ | `run_query` | Execute read-only SELECT queries |
488
+ | `execute_sql` | Execute write operations (INSERT, UPDATE, DELETE, or DDL with permission) |
489
+
490
+ ### Schema Management - DDL (4 tools)
491
+
492
+ | Tool | Description | Requires |
493
+ |------|-------------|----------|
494
+ | `create_table` | Create new tables with columns and indexes | `ddl` permission |
495
+ | `alter_table` | Modify table structure (add/drop/modify columns, indexes) | `ddl` permission |
496
+ | `drop_table` | Delete tables | `ddl` permission |
497
+ | `execute_ddl` | Execute raw DDL SQL (CREATE, ALTER, DROP, TRUNCATE, RENAME) | `ddl` permission |
498
+
499
+ ### Utilities (4 tools)
500
+
501
+ | Tool | Description |
502
+ |------|-------------|
503
+ | `test_connection` | Test database connectivity and measure latency |
504
+ | `describe_connection` | Get current connection information |
505
+ | `export_table_to_csv` | Export table data to CSV format with optional filtering, pagination, and sorting |
506
+ | `export_query_to_csv` | Export the results of a SELECT query to CSV format |
507
+
508
+ ### Transaction Management (5 tools)
509
+
510
+ | Tool | Description |
511
+ |------|-------------|
512
+ | `begin_transaction` | Start a new database transaction |
513
+ | `commit_transaction` | Commit the current transaction |
514
+ | `rollback_transaction` | Rollback the current transaction |
515
+ | `get_transaction_status` | Check if a transaction is active |
516
+ | `execute_in_transaction` | Execute SQL within a transaction context |
517
+
518
+ ### Stored Procedures (5 tools)
519
+
520
+ | Tool | Description | Requires |
521
+ |------|-------------|----------|
522
+ | `list_stored_procedures` | List all stored procedures in a database | `procedure` permission |
523
+ | `create_stored_procedure` | Create new stored procedures with parameters | `procedure` permission |
524
+ | `get_stored_procedure_info` | Get detailed information about a stored procedure | `procedure` permission |
525
+ | `execute_stored_procedure` | Execute stored procedures with IN/OUT/INOUT parameters | `procedure` permission |
526
+ | `drop_stored_procedure` | Delete stored procedures | `procedure` permission |
527
+
528
+ ---
529
+
530
530
  ## 🏗️ DDL Operations
531
531
 
532
532
  DDL (Data Definition Language) operations allow AI to create, modify, and delete tables.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@berthojoris/mcp-mysql-server",
3
- "version": "1.4.4",
3
+ "version": "1.4.5",
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",