@berthojoris/mcp-mysql-server 1.9.3 → 1.10.1
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 +47 -0
- package/DOCUMENTATIONS.md +3847 -3145
- package/README.md +151 -13
- package/bin/mcp-mysql.js +110 -53
- package/dist/config/featureConfig.d.ts +72 -9
- package/dist/config/featureConfig.js +415 -87
- package/dist/db/connection.d.ts +2 -0
- package/dist/db/connection.js +7 -1
- package/dist/index.d.ts +83 -1
- package/dist/index.js +75 -2
- package/dist/mcp-server.js +179 -7
- package/dist/security/securityLayer.d.ts +5 -1
- package/dist/security/securityLayer.js +18 -1
- package/dist/tools/performanceTools.d.ts +111 -0
- package/dist/tools/performanceTools.js +623 -0
- package/dist/tools/utilityTools.js +115 -24
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,53 @@ 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.10.0] - 2025-11-25
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- **Performance Monitoring** - Complete performance analysis toolkit with 10 new tools:
|
|
12
|
+
- `get_performance_metrics` - Comprehensive metrics (query performance, connections, buffer pool, InnoDB stats)
|
|
13
|
+
- `get_top_queries_by_time` - Identify slowest queries by execution time
|
|
14
|
+
- `get_top_queries_by_count` - Find most frequently executed queries
|
|
15
|
+
- `get_slow_queries` - Queries exceeding custom time thresholds
|
|
16
|
+
- `get_table_io_stats` - Monitor table I/O operations and identify hot tables
|
|
17
|
+
- `get_index_usage_stats` - Track index usage patterns
|
|
18
|
+
- `get_unused_indexes` - Identify unused indexes for optimization
|
|
19
|
+
- `get_connection_pool_stats` - Monitor connection pool health
|
|
20
|
+
- `get_database_health_check` - Comprehensive health assessment with status levels
|
|
21
|
+
- `reset_performance_stats` - Reset performance schema statistics
|
|
22
|
+
- Added comprehensive Performance Monitoring section to DOCUMENTATIONS.md
|
|
23
|
+
- Updated README.md tool count from 109 to 119 tools
|
|
24
|
+
- All performance tools require only `utility` permission (no special setup needed)
|
|
25
|
+
|
|
26
|
+
### Fixed
|
|
27
|
+
- **test_connection Enhanced Diagnostics** - Significantly improved error reporting:
|
|
28
|
+
- Added error-specific troubleshooting steps for common issues
|
|
29
|
+
- Platform-specific guidance (Windows/Linux/Mac) for MySQL server management
|
|
30
|
+
- Shows current configuration (host, port, user, database) for verification
|
|
31
|
+
- Detects and diagnoses: ECONNREFUSED, ER_ACCESS_DENIED_ERROR, ER_BAD_DB_ERROR, ETIMEDOUT, ENOTFOUND
|
|
32
|
+
- Clear success messages with connection latency
|
|
33
|
+
- **run_query SHOW Support** - Fixed rejection of read-only information queries:
|
|
34
|
+
- Now supports: SHOW TABLES, SHOW DATABASES, SHOW COLUMNS, SHOW CREATE TABLE, etc.
|
|
35
|
+
- Added support for: DESCRIBE, DESC, EXPLAIN, HELP commands
|
|
36
|
+
- These queries work with `read` permission (no `execute` permission needed)
|
|
37
|
+
- **Performance Tools Registration** - Added all 10 performance monitoring tools to `featureConfig.ts`
|
|
38
|
+
- Ensures AI agents can discover and use performance tools correctly
|
|
39
|
+
- All mapped to `ToolCategory.UTILITY` permission
|
|
40
|
+
|
|
41
|
+
### Changed
|
|
42
|
+
- Enhanced error handling in `test_connection` to return detailed diagnostic information
|
|
43
|
+
- Updated security layer to recognize SHOW, DESCRIBE, EXPLAIN as valid read-only queries
|
|
44
|
+
- Improved error messages throughout with clearer guidance
|
|
45
|
+
|
|
46
|
+
### Documentation
|
|
47
|
+
- Added "Performance Monitoring" section to DOCUMENTATIONS.md with:
|
|
48
|
+
- Complete tool reference with examples
|
|
49
|
+
- Best practices for regular monitoring
|
|
50
|
+
- Query optimization workflows
|
|
51
|
+
- Common performance patterns and troubleshooting
|
|
52
|
+
- Updated README.md with Performance Monitoring category
|
|
53
|
+
- Updated roadmap to mark Performance Monitoring as completed
|
|
54
|
+
|
|
8
55
|
## [1.9.1] - 2025-11-24
|
|
9
56
|
|
|
10
57
|
### Added
|