@berthojoris/mcp-mysql-server 1.25.0 → 1.26.4

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.26.2] - 2025-12-19
+
+### Fixed
+- Updated manifest.json version from 1.17.0 to 1.26.2 to match package.json
+- Verified `list_all_tools` tool is properly registered and available in MCP server
+- Updated documentation timestamps to reflect current changes
+
+## [1.26.3] - 2025-12-19
+
+### Documentation
+- Enhanced README documentation categories table with a "List Tools" column (per-category `list_all_tools` call)
+
+## [1.26.4] - 2025-12-19
+
+### Documentation
+- Fixed README "Documentation Categories (Recommended)" to list the actual tools per category in the "List Tools" column
+
+## [1.26.1] - 2025-12-19
+
+### Documentation
+- Fixed total tools count in README.md and DOCUMENTATIONS.md to match the actual registered tool count (145)
+
+## [1.26.0] - 2025-12-19
+
+### Fixed
+- Added missing `list_all_tools` tool registration in MCP server
+- The `list_all_tools` tool was implemented but not exposed through the MCP interface
+- Updated tool schema and handler registration in mcp-server.ts
+- Updated total tool count from 158 to 159 in documentation
+
 ## [1.22.0] - 2025-12-17
 
 ### Changed
@@ -27,29 +57,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Version increment for implemented features and improvements
 
-## [1.24.0] - 2025-12-19
-
-### Added
-- New tool `list_all_tools` for listing all available tools in the MySQL MCP server with their descriptions and schemas
-- Enhanced meta-tool capabilities for AI agents to discover available functionality
-
-### Changed
-- Updated tool count from 144 to 145 in README.md
-- Updated tool count from 157 to 158 in DOCUMENTATIONS.md  
-- Added `list_all_tools` to the Utilities section in documentation
-- Updated Last Updated timestamp in README.md
-- Version increment for new tool implementation
-
-## [1.25.0] - 2025-12-19
-
-### Fixed
-- Added `list_all_tools` tool to permission configuration with LIST category
-- Tool is now available for all permission sets that include "list" access
-- Updated both tool category mapping and documentation category mapping
-
-### Changed
-- Incremented version to 1.25.0 for permission configuration fix
-
+## [1.24.0] - 2025-12-19
+
+### Added
+- New tool `list_all_tools` for listing all available tools in the MySQL MCP server with their descriptions and schemas
+- Enhanced meta-tool capabilities for AI agents to discover available functionality
+
+### Changed
+- Updated tool count from 144 to 145 in README.md
+- Updated tool count from 157 to 158 in DOCUMENTATIONS.md  
+- Added `list_all_tools` to the Utilities section in documentation
+- Updated Last Updated timestamp in README.md
+- Version increment for new tool implementation
+
+## [1.25.0] - 2025-12-19
+
+### Fixed
+- Added `list_all_tools` tool to permission configuration with LIST category
+- Tool is now available for all permission sets that include "list" access
+- Updated both tool category mapping and documentation category mapping
+
+### Changed
+- Incremented version to 1.25.0 for permission configuration fix
+
 ## [Unreleased]
 
 ### Security

package/DOCUMENTATIONS.md

@@ -1,6 +1,6 @@
 # MySQL MCP Server - Detailed Documentation
 
-**Last Updated:** 2025-12-17 15:30:00
+**Last Updated:** 2025-12-19 18:45:00
 
 This file contains detailed documentation for all features of the MySQL MCP Server. For quick start and basic information, see [README.md](README.md).
 
@@ -9,7 +9,7 @@ This file contains detailed documentation for all features of the MySQL MCP Serv
 ## Table of Contents
 
 1. [Setup & Configuration (Extended)](#setup--configuration-extended) - Permissions + Categories
-2. [🔧 Complete Tools Reference](#🔧-complete-tools-reference) - All 158 tools organized by category
+2. [🔧 Complete Tools Reference](#🔧-complete-tools-reference) - All 145 tools organized by category
 3. [DDL Operations](#🏗️-ddl-operations)
 4. [Data Export Tools](#📤-data-export-tools)
 5. [Data Import Tools](#📥-data-import-tools)
@@ -201,7 +201,7 @@ Add 'bulk_operations' to the categories argument.
 
 ## 🔧 Complete Tools Reference
 
-This section provides a comprehensive reference of all 158 available tools organized by category.
+This section provides a comprehensive reference of all 145 available tools organized by category.
 
 ### Database Discovery
 

package/README.md

@@ -4,7 +4,7 @@
 
 **A production-ready Model Context Protocol (MCP) server for MySQL database integration with AI agents**
 
-**Last Updated:** 2025-12-19 10:03:00
+**Last Updated:** 2025-12-19 19:09:00
 
 [![npm version](https://img.shields.io/npm/v/@berthojoris/mcp-mysql-server)](https://www.npmjs.com/package/@berthojoris/mysql-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/@berthojoris/mysql-mcp)](https://www.npmjs.com/package/@berthojoris/mysql-mcp)
@@ -215,71 +215,7 @@ Control database access with a **dual-layer filtering system** that provides bot
 
 **Filtering Logic**: `Tool enabled = (Has Permission) AND (Has Category OR No categories specified)`
 
-### Documentation Categories (Recommended)
-
-Use documentation categories to fine-tune which tools are exposed (Layer 2):
-
-<table>
-  <thead>
-    <tr>
-      <th align="left">Category A</th>
-      <th align="left">Category B</th>
-      <th align="left">Category C</th>
-      <th align="left">Category D</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>database_discovery</code></td>
-      <td><code>crud_operations</code></td>
-      <td><code>bulk_operations</code></td>
-      <td><code>custom_queries</code></td>
-    </tr>
-    <tr>
-      <td><code>schema_management</code></td>
-      <td><code>utilities</code></td>
-      <td><code>transaction_management</code></td>
-      <td><code>stored_procedures</code></td>
-    </tr>
-    <tr>
-      <td><code>views_management</code></td>
-      <td><code>triggers_management</code></td>
-      <td><code>functions_management</code></td>
-      <td><code>index_management</code></td>
-    </tr>
-    <tr>
-      <td><code>constraint_management</code></td>
-      <td><code>table_maintenance</code></td>
-      <td><code>server_management</code></td>
-      <td><code>performance_monitoring</code></td>
-    </tr>
-    <tr>
-      <td><code>cache_management</code></td>
-      <td><code>query_optimization</code></td>
-      <td><code>backup_restore</code></td>
-      <td><code>import_export</code></td>
-    </tr>
-    <tr>
-      <td><code>data_migration</code></td>
-      <td><code>schema_migrations</code></td>
-      <td><code>analysis</code></td>
-      <td><code>ai_enhancement</code></td>
-    </tr>
-  </tbody>
-</table>
-
-<details>
-  <summary>Copy/paste list (comma-separated, no spaces)</summary>
-
-```text
-database_discovery,crud_operations,bulk_operations,custom_queries,schema_management,utilities,transaction_management,stored_procedures,views_management,triggers_management,functions_management,index_management,constraint_management,table_maintenance,server_management,performance_monitoring,cache_management,query_optimization,backup_restore,import_export,data_migration,schema_migrations,analysis,ai_enhancement
-```
-
-</details>
-
-Full category → tool mapping (and examples) lives in **[DOCUMENTATIONS.md → Category Filtering System](DOCUMENTATIONS.md#🆕-category-filtering-system)**.
-
-### Legacy Categories (Backward Compatible)
+### Permissions
 
 | Permission | Operations | Use Case |
 |------------|------------|----------|
@@ -298,6 +234,50 @@ Common configuration examples are documented in **[DOCUMENTATIONS.md → Categor
 
 ---
 
+### Documentation Categories (Recommended)
+
+Use documentation categories to fine-tune which tools are exposed (Layer 2):
+
+| Category List | Use Case | List Tools |
+|---------------|----------|-----------|
+| `database_discovery` | Explore databases, tables, and schema structure | `get_all_tables_relationships, get_table_relationships, list_databases, list_tables, read_table_schema` |
+| `crud_operations` | Create, read, update, delete operations on data | `create_record, delete_record, read_records, update_record` |
+| `bulk_operations` | High-performance batch processing operations | `bulk_delete, bulk_insert, bulk_update` |
+| `custom_queries` | Execute custom SQL queries and advanced operations | `execute_sql, run_query` |
+| `schema_management` | Manage database schema, tables, and structure | `alter_table, create_table, drop_table, execute_ddl` |
+| `utilities` | Database utilities, diagnostics, and helper functions | `describe_connection, export_query_to_csv, export_table_to_csv, list_all_tools, read_changelog, test_connection` |
+| `transaction_management` | Handle ACID transactions and rollback operations | `begin_transaction, commit_transaction, execute_in_transaction, get_transaction_status, rollback_transaction` |
+| `stored_procedures` | Create, execute, and manage stored procedures | `create_stored_procedure, drop_stored_procedure, execute_stored_procedure, get_stored_procedure_info, list_stored_procedures, show_create_procedure` |
+| `views_management` | Create and manage database views | `alter_view, create_view, drop_view, get_view_info, list_views, show_create_view` |
+| `triggers_management` | Create and manage database triggers | `create_trigger, drop_trigger, get_trigger_info, list_triggers, show_create_trigger` |
+| `functions_management` | Create and manage database functions | `create_function, drop_function, execute_function, get_function_info, list_functions, show_create_function` |
+| `index_management` | Optimize performance with index management | `analyze_index, create_index, drop_index, get_index_info, list_indexes` |
+| `constraint_management` | Manage data integrity constraints | `add_check_constraint, add_foreign_key, add_unique_constraint, drop_constraint, drop_foreign_key, list_constraints, list_foreign_keys` |
+| `table_maintenance` | Table optimization, repair, and maintenance | `analyze_table, check_table, flush_table, get_table_size, get_table_status, optimize_table, repair_table, truncate_table` |
+| `server_management` | MySQL server configuration and administration | `explain_query, get_server_info, kill_process, show_binary_logs, show_engine_status, show_process_list, show_replication_status, show_status, show_variables` |
+| `performance_monitoring` | Monitor and analyze database performance | `get_connection_pool_stats, get_database_health_check, get_index_usage_stats, get_performance_metrics, get_slow_queries, get_table_io_stats, get_top_queries_by_count, get_top_queries_by_time, get_unused_indexes, reset_performance_stats` |
+| `cache_management` | Manage query cache and optimization | `clear_cache, configure_cache_settings, get_cache_config, get_cache_stats, invalidate_cache_for_table` |
+| `query_optimization` | Analyze and optimize SQL queries | `analyze_query, get_optimization_hints` |
+| `backup_restore` | Create backups and restore databases | `backup_database, backup_table, get_create_table_statement, get_database_schema, restore_from_sql` |
+| `import_export` | Import and export data in various formats | `export_query_to_json, export_table_to_json, export_table_to_sql, import_from_csv, import_from_json, safe_export_table` |
+| `data_migration` | Migrate data between databases or systems | `clone_table, compare_table_structure, copy_table_data, move_table_data, sync_table_data` |
+| `schema_migrations` | Version control for database schema changes | `apply_migrations, create_migration, generate_migration_from_diff, get_migration_status, get_schema_version, init_migrations_table, reset_failed_migration, rollback_migration, validate_migrations` |
+| `analysis` | Data analysis and reporting tools | `get_column_statistics, get_database_summary, get_schema_erd, get_schema_rag_context` |
+| `ai_enhancement` | AI-powered features and smart automation | `analyze_schema_patterns, audit_database_security, build_query_from_intent, design_schema_from_requirements, discover_data_patterns, find_similar_columns, forecast_database_growth, generate_business_glossary, generate_data_dictionary, generate_documentation, generate_test_data, predict_query_performance, recommend_indexes, smart_search, suggest_query_improvements, visualize_query` |
+
+<details>
+  <summary>Copy/paste list (comma-separated, no spaces)</summary>
+
+```text
+database_discovery,crud_operations,bulk_operations,custom_queries,schema_management,utilities,transaction_management,stored_procedures,views_management,triggers_management,functions_management,index_management,constraint_management,table_maintenance,server_management,performance_monitoring,cache_management,query_optimization,backup_restore,import_export,data_migration,schema_migrations,analysis,ai_enhancement
+```
+
+</details>
+
+Full category → tool mapping (and examples) lives in **[DOCUMENTATIONS.md → Category Filtering System](DOCUMENTATIONS.md#🆕-category-filtering-system)**.
+
+---
+
 ## Available Tools
 
 The server exposes **145 tools** organized into categories (CRUD, schema, backups, migrations, perf/monitoring, and AI enhancement).

package/dist/config/featureConfig.js

@@ -409,6 +409,7 @@ const legacyToDocCategoryMap = {
         DocCategory.SERVER_MANAGEMENT,
         DocCategory.SCHEMA_MIGRATIONS,
         DocCategory.ANALYSIS,
+        DocCategory.UTILITIES,
     ],
     read: [DocCategory.CRUD_OPERATIONS, DocCategory.CUSTOM_QUERIES, DocCategory.ANALYSIS],
     create: [

package/dist/index.js

@@ -271,7 +271,7 @@ class MySQLMCP {
         return await this.utilityTools.readChangelog(params);
     }
     async listAllTools() {
-        const check = this.checkToolEnabled("listAllTools");
+        const check = this.checkToolEnabled("list_all_tools");
         if (!check.enabled) {
             return { status: "error", error: check.error };
         }

package/dist/mcp-server.js

@@ -683,6 +683,14 @@ const TOOLS = [
             properties: {},
         },
     },
+    {
+        name: "list_all_tools",
+        description: "Lists all available MCP tools with their definitions and server metadata.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
     {
         name: "get_table_relationships",
         description: "Returns foreign key relationships for a specified table.",
@@ -3340,7 +3348,10 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
         // e.g., "list_databases" -> "listDatabases"
         const toolNameCamelCase = tool.name.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
         // Check if tool is enabled based on permissions and categories
-        return mysqlMCP.isToolEnabled(toolNameCamelCase);
+        // Most tools are keyed in featureConfig using camelCase, but a few legacy/meta tools
+        // are keyed using their snake_case MCP names (e.g., read_changelog, list_all_tools).
+        return (mysqlMCP.isToolEnabled(toolNameCamelCase) ||
+            mysqlMCP.isToolEnabled(tool.name));
     });
     // Log the filtering results
     console.error(`Tools available: ${enabledTools.length} of ${TOOLS.length} total tools`);
@@ -3424,6 +3435,9 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "test_connection":
                 result = await mysqlMCP.testConnection();
                 break;
+            case "list_all_tools":
+                result = await mysqlMCP.listAllTools();
+                break;
             case "read_changelog":
                 result = await mysqlMCP.readChangelog((args || {}));
                 break;

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "mysql-mcp",
   "description": "A Model Context Protocol for MySQL database interaction",
-  "version": "1.17.0",
+  "version": "1.26.1",
   "tools": [
     {
       "name": "list_databases",
@@ -348,6 +348,59 @@
         }
       }
     },
+    {
+      "name": "list_all_tools",
+      "description": "Lists all available MCP tools with their definitions and server metadata.",
+      "input_schema": {},
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "string"
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "total_tools": {
+                "type": "number"
+              },
+              "server_name": {
+                "type": "string"
+              },
+              "server_version": {
+                "type": "string"
+              },
+              "server_description": {
+                "type": "string"
+              },
+              "tools": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "type": "string"
+                    },
+                    "description": {
+                      "type": "string"
+                    },
+                    "input_schema": {
+                      "type": "object"
+                    },
+                    "output_schema": {
+                      "type": "object"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "error": {
+            "type": "string"
+          }
+        }
+      }
+    },
     {
       "name": "get_table_relationships",
       "description": "Returns foreign key relationships for a specified table.",

package/package.json

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