@berthojoris/mcp-mysql-server 1.26.4 → 1.28.0

package/CHANGELOG.md

@@ -5,6 +5,45 @@ 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.28.0] - 2025-12-21
+
+### Changed
+- **[BREAKING]** Removed `get_table_relationships` tool - use `get_all_tables_relationships` instead for better performance
+  - `get_all_tables_relationships` retrieves ALL table relationships in a single efficient query with in-memory processing
+  - Much faster than calling `get_table_relationships` repeatedly for each table
+- **Enhanced tool descriptions** for improved LLM understanding across 40+ critical tools:
+  - Added visual indicators (emojis) for tool categories: 🤖 AI-powered, ⚡ Performance, 🔒 Security, 📊 Analytics, etc.
+  - Clarified when to use each tool vs similar alternatives
+  - Added use-case context and examples in descriptions
+  - Highlighted AI-first tools for natural language operations
+  - Improved consistency in description length and detail level
+- Updated total tool count from 104 to 103 across all documentation
+
+### Fixed
+- Removed duplicate `get_all_tables_relationships` entry in DOCUMENTATIONS.md
+- Corrected references to deprecated `get_table_relationships` in documentation examples
+
+## [1.27.1] - 2025-12-21
+
+### Removed
+- **Deprecated Tools**: Removed legacy `runQuery` and `executeSql` tools completely
+  - These tools were replaced by `run_select_query` and `execute_write_query` in v1.27.0
+  - Removed from feature configuration mappings
+  - Removed validation schemas
+  - Updated all internal references to use new tool names
+
+### Changed
+- Updated transaction tools to use `executeWriteQuery` permission check instead of deprecated `executeSql`
+
+## [1.27.0] - 2025-12-21
+
+### Changed
+- **Renamed Tools for Clarity**:
+  - `run_query` -> `run_select_query`
+  - `execute_sql` -> `execute_write_query`
+- **Updated Error Messages**: Error messages now explicitly reference the new tool names to guide users/LLMs to the correct tool for the job.
+- **Updated Documentation**: Updated README.md and DOCUMENTATIONS.md to reflect the new tool names and configuration examples.
+
 ## [1.26.2] - 2025-12-19
 
 ### Fixed

package/DOCUMENTATIONS.md

@@ -1,6 +1,6 @@
 # MySQL MCP Server - Detailed Documentation
 
-**Last Updated:** 2025-12-19 18:45:00
+**Last Updated:** 2025-12-21 17:00: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 145 tools organized by category
+2. [🔧 Complete Tools Reference](#🔧-complete-tools-reference) - All 103 tools organized by category
 3. [DDL Operations](#🏗️-ddl-operations)
 4. [Data Export Tools](#📤-data-export-tools)
 5. [Data Import Tools](#📥-data-import-tools)
@@ -131,7 +131,7 @@ Use both 2nd argument (permissions) and 3rd argument (categories):
 **Layer 1 (Permissions)**: Allows `list`, `read`, `utility` operations
 **Layer 2 (Categories)**: Further restricts to `database_discovery` and `performance_monitoring` tools
 
-**Enabled tools**: `list_databases`, `list_tables`, `read_table_schema`, `get_table_relationships`, `get_performance_metrics`, `get_slow_queries`, etc.
+**Enabled tools**: `list_databases`, `list_tables`, `read_table_schema`, `get_all_tables_relationships`, `get_performance_metrics`, `get_slow_queries`, etc.
 
 **Disabled tools**:
 - `read_records` - Has `read` permission but category is `crud_operations` (not allowed)
@@ -144,11 +144,11 @@ Use both 2nd argument (permissions) and 3rd argument (categories):
 | Permission | Operations Allowed | Example Tools |
 |------------|-------------------|---------------|
 | `list` | List/discover database objects | `list_databases`, `list_tables`, `list_views` |
-| `read` | Read data from tables | `read_records`, `run_query` |
+| `read` | Read data from tables | `read_records`, `run_select_query` |
 | `create` | Insert new records | `create_record`, `bulk_insert` |
 | `update` | Update existing records | `update_record`, `bulk_update` |
 | `delete` | Delete records | `delete_record`, `bulk_delete` |
-| `execute` | Execute custom SQL | `execute_sql`, `run_query` |
+| `execute` | Execute custom SQL | `execute_write_query` |
 | `ddl` | Schema changes | `create_table`, `alter_table`, `drop_table` |
 | `utility` | Utility operations | `test_connection`, `analyze_table` |
 | `transaction` | Transaction management | `begin_transaction`, `commit_transaction` |
@@ -210,7 +210,7 @@ This section provides a comprehensive reference of all 145 available tools organ
 | `list_databases` | Lists all databases on the MySQL server |
 | `list_tables` | Lists all tables in the current/specified database |
 | `read_table_schema` | Gets detailed schema (columns, types, keys, indexes) |
-| `get_table_relationships` | Discovers foreign key relationships |
+| `get_all_tables_relationships` | Gets all table relationships efficiently in one query |
 | `get_all_tables_relationships` | Gets foreign key relationships for ALL tables in a single call with in-memory processing |
 
 ### Data Operations - CRUD
@@ -234,8 +234,8 @@ This section provides a comprehensive reference of all 145 available tools organ
 
 | Tool | Description |
 |------|-------------|
-| `run_query` | Execute read-only SELECT queries |
-| `execute_sql` | Execute write operations (INSERT, UPDATE, DELETE, or DDL) |
+| `run_select_query` | Execute read-only SELECT queries |
+| `execute_write_query` | Execute write operations (INSERT, UPDATE, DELETE, or DDL) |
 
 ### Schema Management - DDL
 
@@ -3604,7 +3604,7 @@ Create a business glossary from database column names with auto-generated descri
 
 **User:** *"Show me the total number of orders per user for the last 30 days"*
 
-**AI uses `run_query`:**
+**AI uses `run_select_query`:**
 - Constructs JOIN query
 - Applies date filter
 - Groups by user
@@ -3891,12 +3891,12 @@ Parameters:
 
 Query logs are now included in responses from **ALL 30 tools**:
 
-✅ **Database Discovery** - `list_databases`, `list_tables`, `read_table_schema`, `get_table_relationships`, `get_all_tables_relationships`
+✅ **Database Discovery** - `list_databases`, `list_tables`, `read_table_schema`, `get_all_tables_relationships`
 ✅ **Data Operations** - `create_record`, `read_records`, `update_record`, `delete_record`
 ✅ **Bulk Operations** - `bulk_insert`, `bulk_update`, `bulk_delete`
-✅ **Custom Queries** - `run_query`, `execute_sql`
+✅ **Custom Queries** - `run_select_query`, `execute_write_query`
 ✅ **Schema Management** - `create_table`, `alter_table`, `drop_table`, `execute_ddl`
-✅ **Utilities** - `get_table_relationships`
+✅ **Utilities** - `get_all_tables_relationships`
 ✅ **Transactions** - `execute_in_transaction`
 ✅ **Stored Procedures** - `list_stored_procedures`, `get_stored_procedure_info`, `execute_stored_procedure`, etc.
 ✅ **Data Export** - `export_table_to_csv`, `export_query_to_csv`
@@ -3920,8 +3920,8 @@ Query logs are valuable for:
 ### Tools with Query Logging
 
 All tools that execute queries include logs:
-- `run_query` - SELECT query execution
-- `executeSql` - Write operations (INSERT, UPDATE, DELETE)
+- `run_select_query` - SELECT query execution
+- `execute_write_query` - Write operations (INSERT, UPDATE, DELETE)
 - `create_record` - Single record insertion
 - `read_records` - Record querying with filters
 - `update_record` - Record updates
@@ -4025,7 +4025,7 @@ console.log(`Query log memory usage: ~${estimatedMemory} KB`);
 
 - ✅ **Parameterized Queries** - All queries use prepared statements (SQL injection protection)
 - ✅ **Permission-Based Access** - Fine-grained control over operations
-- ✅ **Read-Only Validation** - `run_query` enforces SELECT-only operations
+- ✅ **Read-Only Validation** - `run_select_query` enforces SELECT-only operations
 - ✅ **DDL Gating** - Schema changes require explicit `ddl` permission
 - ✅ **Condition Requirements** - DELETE operations must include WHERE conditions
 - ✅ **Input Validation** - All inputs validated with JSON schemas
@@ -4145,7 +4145,7 @@ Returns:
 
 - **SELECT queries only**: Only SELECT queries are cached
 - **Automatic invalidation**: INSERT, UPDATE, DELETE operations automatically invalidate related cache entries
-- **Per-query control**: Use `useCache: false` in `run_query` to bypass cache for specific queries
+- **Per-query control**: Use `useCache: false` in `run_select_query` to bypass cache for specific queries
 
 ---
 
@@ -4161,11 +4161,11 @@ The MySQL MCP server provides advanced query optimization tools that help you im
 
 ### Using Optimizer Hints
 
-When running queries with `run_query`, you can include optimizer hints:
+When running queries with `run_select_query`, you can include optimizer hints:
 
 ```json
 {
-  "tool": "run_query",
+  "tool": "run_select_query",
   "arguments": {
     "query": "SELECT * FROM orders WHERE customer_id = ?",
     "params": [123],

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 19:09:00
+**Last Updated:** 2025-12-21 17:00: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)
@@ -173,7 +173,7 @@ Alternative approach using environment variables instead of connection string:
         "DB_USER": "root",
         "DB_PASSWORD": "your_password",
         "DB_NAME": "your_database",
-        "MCP_PERMISSIONS": "list,read,utility"
+        "MCP_PERMISSIONS": "list,read,utility,create,update,delete"
       }
     }
   }
@@ -194,8 +194,8 @@ Alternative approach using environment variables instead of connection string:
         "DB_USER": "root",
         "DB_PASSWORD": "your_password",
         "DB_NAME": "your_database",
-        "MCP_PERMISSIONS": "list,read,utility",
-        "MCP_CATEGORIES": "database_discovery,performance_monitoring"
+        "MCP_PERMISSIONS": "list,read,utility,create,update,delete",
+        "MCP_CATEGORIES": "database_discovery,performance_monitoring,custom_queries"
       }
     }
   }
@@ -243,7 +243,7 @@ Use documentation categories to fine-tune which tools are exposed (Layer 2):
 | `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` |
+| `custom_queries` | Execute custom SQL queries and advanced operations | `execute_write_query, run_select_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` |

package/dist/config/featureConfig.js

@@ -79,8 +79,8 @@ exports.toolCategoryMap = {
     bulkUpdate: ToolCategory.UPDATE,
     bulkDelete: ToolCategory.DELETE,
     // Query tools
-    runQuery: ToolCategory.READ,
-    executeSql: ToolCategory.EXECUTE,
+    runSelectQuery: ToolCategory.READ,
+    executeWriteQuery: ToolCategory.EXECUTE,
     // DDL tools
     createTable: ToolCategory.DDL,
     alterTable: ToolCategory.DDL,
@@ -238,8 +238,8 @@ exports.toolDocCategoryMap = {
     bulkUpdate: DocCategory.BULK_OPERATIONS,
     bulkDelete: DocCategory.BULK_OPERATIONS,
     // Custom Queries
-    runQuery: DocCategory.CUSTOM_QUERIES,
-    executeSql: DocCategory.CUSTOM_QUERIES,
+    runSelectQuery: DocCategory.CUSTOM_QUERIES,
+    executeWriteQuery: DocCategory.CUSTOM_QUERIES,
     // Schema Management (DDL)
     createTable: DocCategory.SCHEMA_MANAGEMENT,
     alterTable: DocCategory.SCHEMA_MANAGEMENT,

package/dist/index.d.ts

@@ -119,7 +119,7 @@ export declare class MySQLMCP {
         };
         error?: string;
     }>;
-    runQuery(params: {
+    runSelectQuery(params: {
         query: string;
         params?: any[];
         hints?: any;
@@ -135,7 +135,7 @@ export declare class MySQLMCP {
         estimated_cost?: string;
         message?: string;
     }>;
-    executeSql(params: {
+    executeWriteQuery(params: {
         query: string;
         params?: any[];
     }): Promise<{

package/dist/index.js

@@ -159,8 +159,8 @@ class MySQLMCP {
         return await this.crudTools.deleteRecord(params);
     }
     // Query Tools
-    async runQuery(params) {
-        const check = this.checkToolEnabled("runQuery");
+    async runSelectQuery(params) {
+        const check = this.checkToolEnabled("runSelectQuery");
         if (!check.enabled) {
             return { status: "error", error: check.error };
         }
@@ -168,13 +168,13 @@ class MySQLMCP {
         if (!this.security.isReadOnlyQuery(params.query)) {
             return {
                 status: "error",
-                error: "Only SELECT queries are allowed with runQuery. Use executeSql for other operations.",
+                error: "Only SELECT queries are allowed with run_select_query. Use execute_write_query for other operations.",
             };
         }
-        return await this.queryTools.runQuery(params);
+        return await this.queryTools.runSelectQuery(params);
     }
-    async executeSql(params) {
-        const check = this.checkToolEnabled("executeSql");
+    async executeWriteQuery(params) {
+        const check = this.checkToolEnabled("executeWriteQuery");
         if (!check.enabled) {
             return { status: "error", error: check.error };
         }
@@ -184,11 +184,11 @@ class MySQLMCP {
             if (!this.featureConfig.isCategoryEnabled("ddl")) {
                 return {
                     status: "error",
-                    error: 'DDL operations (DROP, TRUNCATE, ALTER, CREATE) require the "ddl" permission. Use executeDdl tool or add "ddl" to permissions.',
+                    error: 'DDL operations (DROP, TRUNCATE, ALTER, CREATE) require the "ddl" permission. Use execute_ddl tool or add "ddl" to permissions.',
                 };
             }
         }
-        return await this.queryTools.executeSql(params);
+        return await this.queryTools.executeWriteQuery(params);
     }
     // Analysis Tools
     async getColumnStatistics(params) {
@@ -307,7 +307,7 @@ class MySQLMCP {
         return await this.transactionTools.getTransactionStatus();
     }
     async executeInTransaction(params) {
-        const check = this.checkToolEnabled("executeSql"); // Use executeSql permission for transaction queries
+        const check = this.checkToolEnabled("executeWriteQuery"); // Use executeWriteQuery permission for transaction queries
         if (!check.enabled) {
             return { status: "error", error: check.error };
         }

package/dist/mcp-server.js

@@ -16,7 +16,7 @@ let mysqlMCP;
 const TOOLS = [
     {
         name: "list_databases",
-        description: "Lists all databases available on the MySQL server.",
+        description: "Lists all databases available on the MySQL server. Use this to discover what databases exist before querying them.",
         inputSchema: {
             type: "object",
             properties: {},
@@ -24,7 +24,7 @@ const TOOLS = [
     },
     {
         name: "list_tables",
-        description: "Lists all tables in the connected MySQL database.",
+        description: "Lists all tables in the connected database. Use this as the first step when exploring an unfamiliar database to see available tables.",
         inputSchema: {
             type: "object",
             properties: {
@@ -37,7 +37,7 @@ const TOOLS = [
     },
     {
         name: "get_database_summary",
-        description: "Get a high-level summary of the database (tables, columns, row counts) optimized for AI context.",
+        description: "📊 Returns a high-level overview of the database including all tables, their columns, data types, and row counts. RECOMMENDED: Use this first when exploring a new database to understand its structure quickly. Optimized for AI context with concise formatting.",
         inputSchema: {
             type: "object",
             properties: {
@@ -50,7 +50,7 @@ const TOOLS = [
     },
     {
         name: "get_schema_erd",
-        description: "Get a Mermaid.js ER diagram string representing the database schema and relationships.",
+        description: "📈 Generates a visual Mermaid.js ER diagram showing tables and their relationships. Perfect for visualizing database structure and foreign key connections. Use when users ask to 'visualize' or 'diagram' the database.",
         inputSchema: {
             type: "object",
             properties: {
@@ -63,7 +63,7 @@ const TOOLS = [
     },
     {
         name: "get_schema_rag_context",
-        description: "Return a compact schema-aware context pack (tables, PK/FK, columns, row estimates) optimized for RAG prompts.",
+        description: "🎯 AI-OPTIMIZED: Returns ultra-compact schema information (tables, columns, keys, relationships, row estimates) designed specifically for LLM context windows. Use this when you need schema awareness but want to minimize token usage. Configurable limits for tables/columns.",
         inputSchema: {
             type: "object",
             properties: {
@@ -88,7 +88,7 @@ const TOOLS = [
     },
     {
         name: "get_column_statistics",
-        description: "Get detailed statistics for a specific column (min, max, avg, distinct counts, nulls).",
+        description: "Returns detailed statistics for a specific column: min/max values, average, distinct count, null percentage, and value distribution. Use to understand data quality and ranges in a column before writing queries.",
         inputSchema: {
             type: "object",
             properties: {
@@ -110,7 +110,7 @@ const TOOLS = [
     },
     {
         name: "read_table_schema",
-        description: "Reads the schema of a specified table, including columns, types, keys, and indexes.",
+        description: "Returns complete schema definition for a table: columns, data types, constraints, keys, indexes, and defaults. Use when you need detailed structural information about a specific table.",
         inputSchema: {
             type: "object",
             properties: {
@@ -124,7 +124,7 @@ const TOOLS = [
     },
     {
         name: "create_record",
-        description: "Creates a new record in the specified table.",
+        description: "Inserts a single new record into a table. For inserting multiple records at once, use bulk_insert for better performance.",
         inputSchema: {
             type: "object",
             properties: {
@@ -142,7 +142,7 @@ const TOOLS = [
     },
     {
         name: "read_records",
-        description: "Reads records from the specified table with optional filtering, pagination, and sorting.",
+        description: "Reads records from a table with built-in filtering, pagination, and sorting. Use this for simple data retrieval. For complex queries with JOINs or aggregations, use run_select_query instead.",
         inputSchema: {
             type: "object",
             properties: {
@@ -194,7 +194,7 @@ const TOOLS = [
     },
     {
         name: "update_record",
-        description: "Updates existing records in the specified table based on conditions.",
+        description: "Updates records in a table based on specified conditions. For updating many records with different values, use bulk_update for better performance.",
         inputSchema: {
             type: "object",
             properties: {
@@ -228,7 +228,7 @@ const TOOLS = [
     },
     {
         name: "delete_record",
-        description: "Deletes records from the specified table based on conditions.",
+        description: "Deletes records from a table based on specified conditions. Always requires conditions for safety (no WHERE-less deletes). For deleting multiple record sets, use bulk_delete.",
         inputSchema: {
             type: "object",
             properties: {
@@ -258,7 +258,7 @@ const TOOLS = [
     },
     {
         name: "bulk_insert",
-        description: "Bulk insert multiple records into the specified table with batch processing for optimal performance.",
+        description: "⚡ PERFORMANCE: Inserts multiple records efficiently using batch processing. Handles 1000s of rows with automatic batching. Use this instead of create_record when inserting many records at once (10+ rows).",
         inputSchema: {
             type: "object",
             properties: {
@@ -287,7 +287,7 @@ const TOOLS = [
     },
     {
         name: "bulk_update",
-        description: "Bulk update multiple records with different conditions and data using batch processing.",
+        description: "⚡ PERFORMANCE: Updates multiple records with different values in batches. Each update can have unique conditions and data. Much faster than calling update_record repeatedly for multiple rows.",
         inputSchema: {
             type: "object",
             properties: {
@@ -349,7 +349,7 @@ const TOOLS = [
     },
     {
         name: "bulk_delete",
-        description: "Bulk delete records based on multiple condition sets using batch processing.",
+        description: "⚡ PERFORMANCE: Deletes multiple sets of records efficiently in batches. Each condition set defines a separate delete operation. More efficient than calling delete_record multiple times.",
         inputSchema: {
             type: "object",
             properties: {
@@ -390,8 +390,8 @@ const TOOLS = [
         },
     },
     {
-        name: "run_query",
-        description: "⚡ USE THIS FOR SELECT QUERIES. Runs a read-only SQL SELECT query with optional parameters, optimizer hints, and caching support. ONLY SELECT statements are allowed - use execute_sql for INSERT/UPDATE/DELETE, use execute_ddl for CREATE/ALTER/DROP.",
+        name: "run_select_query",
+        description: "⚡ PRIMARY TOOL FOR SELECT QUERIES. Executes read-only SELECT statements with parameterization, optimizer hints, query caching, and dry-run mode. Supports complex queries with JOINs, subqueries, and aggregations. ⚠️ ONLY for SELECT - use execute_write_query for INSERT/UPDATE/DELETE, use execute_ddl for CREATE/ALTER/DROP.",
         inputSchema: {
             type: "object",
             properties: {
@@ -457,8 +457,8 @@ const TOOLS = [
         },
     },
     {
-        name: "execute_sql",
-        description: '⚡ USE THIS FOR INSERT/UPDATE/DELETE. Executes a write SQL operation (INSERT, UPDATE, DELETE) with optional parameters. NOT for SELECT (use run_query), NOT for DDL (use execute_ddl for CREATE/ALTER/DROP/TRUNCATE/RENAME).',
+        name: "execute_write_query",
+        description: '⚡ PRIMARY TOOL FOR INSERT/UPDATE/DELETE QUERIES. Executes data modification statements with parameterization support. Returns affected row count and execution details. ⚠️ NOT for SELECT (use run_select_query), NOT for DDL (use execute_ddl for CREATE/ALTER/DROP/TRUNCATE/RENAME).',
         inputSchema: {
             type: "object",
             properties: {
@@ -477,7 +477,7 @@ const TOOLS = [
     },
     {
         name: "safe_export_table",
-        description: "Exports table data to CSV with enforced data masking rules to protect sensitive information.",
+        description: "🔒 SECURITY: Exports table data to CSV with automatic PII/sensitive data masking. Redacts emails, credit cards, passwords, etc. Use this instead of export_table_to_csv when handling sensitive data or sharing exports externally.",
         inputSchema: {
             type: "object",
             properties: {
@@ -504,7 +504,7 @@ const TOOLS = [
     },
     {
         name: "repair_query",
-        description: "Analyzes a SQL query (and optional error) to suggest repairs or optimizations using EXPLAIN and heuristics.",
+        description: "🔧 Diagnoses SQL query errors and suggests fixes. Analyzes syntax errors, missing columns/tables, and logic issues. Provide the query and optional error message to get repair recommendations. Use when a query fails or needs debugging.",
         inputSchema: {
             type: "object",
             properties: {
@@ -522,7 +522,7 @@ const TOOLS = [
     },
     {
         name: "create_table",
-        description: 'Creates a new table with the specified columns and indexes. Requires "ddl" permission.',
+        description: '🏗️ Creates a new table with columns, data types, constraints, and indexes. Simplified interface compared to raw DDL. Requires "ddl" permission.',
         inputSchema: {
             type: "object",
             properties: {
@@ -576,7 +576,7 @@ const TOOLS = [
     },
     {
         name: "alter_table",
-        description: 'Alters an existing table structure (add/drop/modify columns, add/drop indexes). Requires "ddl" permission.',
+        description: '🔧 Modifies existing table structure: add/drop/modify/rename columns, add/drop indexes. Supports multiple operations in one call. Requires "ddl" permission.',
         inputSchema: {
             type: "object",
             properties: {
@@ -620,7 +620,7 @@ const TOOLS = [
     },
     {
         name: "drop_table",
-        description: 'Drops (deletes) a table and all its data. Requires "ddl" permission. WARNING: This is irreversible!',
+        description: '🗑️ DESTRUCTIVE: Permanently deletes a table and ALL its data. Cannot be undone! Consider backup_table first. Requires "ddl" permission. ⚠️ WARNING: IRREVERSIBLE!',
         inputSchema: {
             type: "object",
             properties: {
@@ -638,7 +638,7 @@ const TOOLS = [
     },
     {
         name: "execute_ddl",
-        description: '⚡ USE THIS FOR DDL ONLY (CREATE, ALTER, DROP, TRUNCATE, RENAME). NOT for SELECT (use run_query), NOT for INSERT/UPDATE/DELETE (use execute_sql). Requires "ddl" permission.',
+        description: '⚡ PRIMARY TOOL FOR DDL STATEMENTS. Executes schema modification queries: CREATE, ALTER, DROP, TRUNCATE, RENAME. Use for complex DDL that structured tools don\'t cover. ⚠️ NOT for SELECT (use run_select_query), NOT for INSERT/UPDATE/DELETE (use execute_write_query). Requires "ddl" permission.',
         inputSchema: {
             type: "object",
             properties: {
@@ -652,7 +652,7 @@ const TOOLS = [
     },
     {
         name: "describe_connection",
-        description: "Returns information about the current database connection.",
+        description: "Returns current database connection details: host, database name, user, port, and connection status. Use to verify which database you're connected to.",
         inputSchema: {
             type: "object",
             properties: {},
@@ -660,7 +660,7 @@ const TOOLS = [
     },
     {
         name: "read_changelog",
-        description: "Reads the changelog to see what features are new or changed.",
+        description: "Reads the MySQL MCP Server changelog to see version history, new features, bug fixes, and breaking changes. Useful for understanding tool capabilities and recent updates.",
         inputSchema: {
             type: "object",
             properties: {
@@ -677,7 +677,7 @@ const TOOLS = [
     },
     {
         name: "test_connection",
-        description: "Tests the database connection and returns latency information.",
+        description: "Tests database connectivity and measures latency. Returns connection status and response time. Use to troubleshoot connection issues or check database availability.",
         inputSchema: {
             type: "object",
             properties: {},
@@ -685,29 +685,15 @@ const TOOLS = [
     },
     {
         name: "list_all_tools",
-        description: "Lists all available MCP tools with their definitions and server metadata.",
+        description: "📋 Returns complete catalog of all available tools with names, descriptions, parameters, and current permissions. Use to discover tool capabilities or when users ask 'what can you do?'.",
         inputSchema: {
             type: "object",
             properties: {},
         },
     },
-    {
-        name: "get_table_relationships",
-        description: "Returns foreign key relationships for a specified table.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                table_name: {
-                    type: "string",
-                    description: "Name of the table to get relationships for",
-                },
-            },
-            required: ["table_name"],
-        },
-    },
     {
         name: "get_all_tables_relationships",
-        description: "Gets all table foreign key relationships in one call with memory-efficient relationship mapping.",
+        description: "Gets ALL table foreign key relationships in the entire database in a single efficient query. Returns a comprehensive relationship map showing parent-child connections between all tables. Much faster than querying table-by-table.",
         inputSchema: {
             type: "object",
             properties: {
@@ -721,7 +707,7 @@ const TOOLS = [
     // Transaction Tools
     {
         name: "begin_transaction",
-        description: "Begins a new database transaction. Returns a transaction ID for subsequent operations.",
+        description: "🔄 Starts a new database transaction and returns a transaction ID. Use with commit_transaction or rollback_transaction to group multiple operations atomically. Essential for data consistency when multiple changes must succeed or fail together.",
         inputSchema: {
             type: "object",
             properties: {
@@ -734,7 +720,7 @@ const TOOLS = [
     },
     {
         name: "commit_transaction",
-        description: "Commits a transaction and makes all changes permanent.",
+        description: "✅ Commits an active transaction, making all changes permanent. Use after successful completion of all operations within a transaction started by begin_transaction.",
         inputSchema: {
             type: "object",
             properties: {
@@ -748,7 +734,7 @@ const TOOLS = [
     },
     {
         name: "rollback_transaction",
-        description: "Rolls back a transaction and undoes all changes made within it.",
+        description: "↩️ Rolls back an active transaction, undoing ALL changes made within it. Use when an error occurs during transaction or when changes need to be cancelled.",
         inputSchema: {
             type: "object",
             properties: {
@@ -762,7 +748,7 @@ const TOOLS = [
     },
     {
         name: "get_transaction_status",
-        description: "Returns the status of all active transactions.",
+        description: "Shows all active transactions with their IDs, start times, and operation counts. Use to monitor transaction state or debug transaction issues.",
         inputSchema: {
             type: "object",
             properties: {},
@@ -770,7 +756,7 @@ const TOOLS = [
     },
     {
         name: "execute_in_transaction",
-        description: "Executes a SQL query within an active transaction.",
+        description: "Executes a SQL query within an existing transaction context. The query becomes part of the transaction and will be committed or rolled back with it. Use after begin_transaction.",
         inputSchema: {
             type: "object",
             properties: {
@@ -935,7 +921,7 @@ const TOOLS = [
     // Data Export Tools
     {
         name: "export_table_to_csv",
-        description: "Export table data to CSV format with optional filtering, pagination, and sorting.",
+        description: "📄 Exports table data to CSV format with filtering, pagination, and sorting. For sensitive data, use safe_export_table instead which includes automatic data masking.",
         inputSchema: {
             type: "object",
             properties: {
@@ -991,7 +977,7 @@ const TOOLS = [
     },
     {
         name: "export_query_to_csv",
-        description: "Export the results of a SELECT query to CSV format.",
+        description: "📄 Executes a SELECT query and exports results to CSV format. Supports complex queries with JOINs and aggregations. For sensitive data, consider using safe_export_table or adding manual data masking.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1015,7 +1001,7 @@ const TOOLS = [
     // Cache Management Tools
     {
         name: "get_cache_stats",
-        description: "Get query cache statistics including hit rate, size, and configuration.",
+        description: "📊 Returns query cache performance metrics: hit rate, miss rate, size, memory usage, and entry count. Use to monitor cache effectiveness and tune cache settings.",
         inputSchema: {
             type: "object",
             properties: {},
@@ -1079,7 +1065,7 @@ const TOOLS = [
     // Query Optimization Tools
     {
         name: "analyze_query",
-        description: "Analyze a SQL query and get optimization suggestions including recommended indexes and hints.",
+        description: "🔍 Analyzes a SQL query using EXPLAIN and provides optimization suggestions: missing indexes, inefficient operations, cost estimates. Returns actionable recommendations. Use before running expensive queries.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1833,7 +1819,7 @@ const TOOLS = [
     },
     {
         name: "truncate_table",
-        description: "Truncates a table (removes all rows quickly). Requires 'ddl' permission. WARNING: This is irreversible!",
+        description: "🗑️ DESTRUCTIVE: Removes ALL rows from a table instantly (faster than DELETE). Resets auto-increment counters. Cannot be undone! Consider backup_table first. Requires 'ddl' permission. ⚠️ WARNING: IRREVERSIBLE!",
         inputSchema: {
             type: "object",
             properties: {
@@ -2057,7 +2043,7 @@ const TOOLS = [
     },
     {
         name: "backup_database",
-        description: "Backup entire database or selected tables to SQL dump format.",
+        description: "💾 Creates SQL dump backup of entire database or specific tables. Includes structure and optionally data. Returns backup as SQL text. Use before major schema changes or migrations.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2723,7 +2709,7 @@ const TOOLS = [
     // Performance Monitoring Tools
     {
         name: "get_performance_metrics",
-        description: "Get comprehensive MySQL performance metrics including query performance, connection stats, buffer pool metrics, and InnoDB statistics.",
+        description: "📊 COMPREHENSIVE MONITORING: Returns complete MySQL performance dashboard including query stats, connection pool, buffer pool efficiency, InnoDB metrics, and disk I/O. Use for performance troubleshooting or health checks.",
         inputSchema: {
             type: "object",
             properties: {},
@@ -2849,7 +2835,7 @@ const TOOLS = [
     // Intelligent Query Assistant
     {
         name: "build_query_from_intent",
-        description: "Converts natural language to optimized SQL with context-aware query generation. Analyzes your intent and generates safe, optimized SQL queries with explanations.",
+        description: "🤖 AI-POWERED: Converts natural language descriptions into optimized SQL queries. Example: 'show me all users who registered last month' → SELECT query. Includes query explanation and safety checks. RECOMMENDED for when users describe what they want instead of writing SQL.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2882,7 +2868,7 @@ const TOOLS = [
     },
     {
         name: "suggest_query_improvements",
-        description: "Analyzes a SQL query and suggests improvements for speed, memory, or readability. Identifies inefficient patterns and provides optimized alternatives.",
+        description: "🎯 AI-POWERED: Analyzes a SQL query and suggests optimizations for speed, memory usage, or readability. Identifies missing indexes, inefficient JOINs, subquery opportunities, and anti-patterns. Use when a query is slow or complex.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2908,7 +2894,7 @@ const TOOLS = [
     // ==========================================
     {
         name: "design_schema_from_requirements",
-        description: "Designs a database schema from natural language requirements. Returns a proposed schema spec and CREATE TABLE / CREATE INDEX statements (does not execute DDL).",
+        description: "🤖 AI-POWERED SCHEMA DESIGN: Converts business requirements into complete database schema. Input: 'I need a blog with users, posts, and comments' → Output: normalized table structures with relationships, indexes, and CREATE statements. Does NOT execute DDL automatically.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2960,7 +2946,7 @@ const TOOLS = [
     },
     {
         name: "audit_database_security",
-        description: "Audits MySQL security configuration and (optionally) accounts/privileges using read-only inspection queries. Returns prioritized findings and recommendations.",
+        description: "🔒 AI-POWERED SECURITY AUDIT: Analyzes database security configuration, user privileges, password policies, and access patterns. Returns prioritized security risks with remediation steps. Read-only, safe to run anytime.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2981,7 +2967,7 @@ const TOOLS = [
     },
     {
         name: "recommend_indexes",
-        description: "Analyzes real query patterns from performance_schema digests and suggests concrete CREATE INDEX statements. Uses heuristics to avoid duplicate/redundant indexes.",
+        description: "🎯 AI-POWERED INDEX RECOMMENDATIONS: Analyzes actual query patterns from performance_schema and suggests specific indexes to create. Identifies slow queries and missing indexes. Returns ready-to-execute CREATE INDEX statements. Avoids redundant indexes.",
         inputSchema: {
             type: "object",
             properties: {
@@ -3017,7 +3003,7 @@ const TOOLS = [
     // ==========================================
     {
         name: "generate_test_data",
-        description: "Generates synthetic test data as SQL INSERT statements for a given table (does not execute). Attempts FK-aware value selection for referential integrity.",
+        description: "🤖 AI-POWERED DATA GENERATION: Creates realistic synthetic test data based on column names and types. Respects foreign key relationships. Returns INSERT statements (does not execute). Perfect for testing, demos, or development environments.",
         inputSchema: {
             type: "object",
             properties: {
@@ -3069,7 +3055,7 @@ const TOOLS = [
     },
     {
         name: "visualize_query",
-        description: "Creates a visual representation of a read-only SQL query as a Mermaid flowchart, based on EXPLAIN FORMAT=JSON and lightweight SQL parsing.",
+        description: "📊 AI-POWERED VISUALIZATION: Converts a SQL query into a visual Mermaid flowchart showing execution flow, table scans, joins, and filters. Based on EXPLAIN analysis. Helps understand complex query execution. Use when users ask to 'visualize' or 'explain' a query.",
         inputSchema: {
             type: "object",
             properties: {
@@ -3150,7 +3136,7 @@ const TOOLS = [
     // Smart Data Discovery
     {
         name: "smart_search",
-        description: "Finds relevant tables, columns, data patterns, and relationships using semantic search. Essential for exploring large databases with hundreds of tables.",
+        description: "🔍 AI-POWERED SEARCH: Finds tables, columns, and data using semantic search. Example: search 'customer email' finds email columns, user tables, contact info, etc. Essential for exploring unfamiliar or large databases (100+ tables). Much smarter than simple name matching.",
         inputSchema: {
             type: "object",
             properties: {
@@ -3245,7 +3231,7 @@ const TOOLS = [
     // Documentation Generator
     {
         name: "generate_documentation",
-        description: "Generates comprehensive database documentation with business glossary in Markdown, HTML, or JSON format. Includes schema, relationships, and example queries.",
+        description: "📝 AI-POWERED DOCUMENTATION: Generates comprehensive database documentation in Markdown, HTML, or JSON. Includes schema diagrams, table descriptions, relationships, and example queries. Perfect for onboarding or creating data catalogs.",
         inputSchema: {
             type: "object",
             properties: {
@@ -3334,7 +3320,7 @@ const TOOLS = [
 // Create the MCP server
 const server = new index_js_1.Server({
     name: "mysql-mcp-server",
-    version: "1.17.0",
+    version: "1.28.0",
 }, {
     capabilities: {
         tools: {},
@@ -3410,11 +3396,11 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 result = await mysqlMCP.bulkDelete((args || {}));
                 break;
             // Query Tools
-            case "run_query":
-                result = await mysqlMCP.runQuery((args || {}));
+            case "run_select_query":
+                result = await mysqlMCP.runSelectQuery((args || {}));
                 break;
-            case "execute_sql":
-                result = await mysqlMCP.executeSql((args || {}));
+            case "execute_write_query":
+                result = await mysqlMCP.executeWriteQuery((args || {}));
                 break;
             // DDL Tools
             case "create_table":
@@ -3441,9 +3427,6 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "read_changelog":
                 result = await mysqlMCP.readChangelog((args || {}));
                 break;
-            case "get_table_relationships":
-                result = await mysqlMCP.getTableRelationships((args || {}));
-                break;
             case "get_all_tables_relationships":
                 result = await mysqlMCP.getAllTablesRelationships((args || {}));
                 break;

package/dist/server.js

@@ -273,7 +273,7 @@ apiRouter.delete('/tables/:tableName/records/:id', validateInput((req) => (0, in
 apiRouter.post('/query', requestSizeLimit(inputValidation_1.INPUT_LIMITS.MAX_QUERY_LENGTH), validateInput(inputValidation_1.validateQuery), async (req, res, next) => {
     try {
         const { query, params } = req.body;
-        const result = await mcp.runQuery({
+        const result = await mcp.runSelectQuery({
             query,
             params: params || []
         });
@@ -286,7 +286,7 @@ apiRouter.post('/query', requestSizeLimit(inputValidation_1.INPUT_LIMITS.MAX_QUE
 apiRouter.post('/execute', requestSizeLimit(inputValidation_1.INPUT_LIMITS.MAX_QUERY_LENGTH), validateInput(inputValidation_1.validateQuery), async (req, res, next) => {
     try {
         const { query, params } = req.body;
-        const result = await mcp.executeSql({
+        const result = await mcp.executeWriteQuery({
             query,
             params: params || []
         });

package/dist/tools/aiTools.js

@@ -50,7 +50,7 @@ class AiTools {
         // 3. Run EXPLAIN
         try {
             const explainQuery = `EXPLAIN FORMAT=JSON ${query}`;
-            // Note: We use the raw connection or executeSql equivalent.
+            // Note: We use the raw connection or executeWriteQuery equivalent.
             // But EXPLAIN is safe-ish if the inner query is safe.
             // validation passed, so we try EXPLAIN.
             const explainResult = await this.db.query(explainQuery);

package/dist/tools/databaseTools.js

@@ -109,20 +109,20 @@ class DatabaseTools {
             };
         }
         try {
-            const query = `
-        SELECT
-          COLUMN_NAME as column_name,
-          DATA_TYPE as data_type,
-          IS_NULLABLE as is_nullable,
-          COLUMN_KEY as column_key,
-          COLUMN_DEFAULT as column_default,
-          EXTRA as extra
-        FROM
-          INFORMATION_SCHEMA.COLUMNS
-        WHERE
-          TABLE_NAME = ?
-        ORDER BY
-          ORDINAL_POSITION
+            const query = `
+        SELECT
+          COLUMN_NAME as column_name,
+          DATA_TYPE as data_type,
+          IS_NULLABLE as is_nullable,
+          COLUMN_KEY as column_key,
+          COLUMN_DEFAULT as column_default,
+          EXTRA as extra
+        FROM
+          INFORMATION_SCHEMA.COLUMNS
+        WHERE
+          TABLE_NAME = ?
+        ORDER BY
+          ORDINAL_POSITION
       `;
             const results = await this.db.query(query, [
                 params.table_name,
@@ -160,18 +160,18 @@ class DatabaseTools {
                 };
             }
             // Get tables and row counts
-            const tablesQuery = `
-        SELECT TABLE_NAME, TABLE_ROWS
-        FROM INFORMATION_SCHEMA.TABLES 
-        WHERE TABLE_SCHEMA = ?
+            const tablesQuery = `
+        SELECT TABLE_NAME, TABLE_ROWS
+        FROM INFORMATION_SCHEMA.TABLES 
+        WHERE TABLE_SCHEMA = ?
       `;
             const tables = await this.db.query(tablesQuery, [database]);
             // Get columns for all tables
-            const columnsQuery = `
-        SELECT TABLE_NAME, COLUMN_NAME, DATA_TYPE, COLUMN_KEY
-        FROM INFORMATION_SCHEMA.COLUMNS 
-        WHERE TABLE_SCHEMA = ?
-        ORDER BY TABLE_NAME, ORDINAL_POSITION
+            const columnsQuery = `
+        SELECT TABLE_NAME, COLUMN_NAME, DATA_TYPE, COLUMN_KEY
+        FROM INFORMATION_SCHEMA.COLUMNS 
+        WHERE TABLE_SCHEMA = ?
+        ORDER BY TABLE_NAME, ORDINAL_POSITION
       `;
             const columns = await this.db.query(columnsQuery, [database]);
             // Build text summary
@@ -223,22 +223,22 @@ class DatabaseTools {
                 };
             }
             // Get tables and columns
-            const columnsQuery = `
-        SELECT TABLE_NAME, COLUMN_NAME, DATA_TYPE, COLUMN_KEY
-        FROM INFORMATION_SCHEMA.COLUMNS 
-        WHERE TABLE_SCHEMA = ?
-        ORDER BY TABLE_NAME, ORDINAL_POSITION
+            const columnsQuery = `
+        SELECT TABLE_NAME, COLUMN_NAME, DATA_TYPE, COLUMN_KEY
+        FROM INFORMATION_SCHEMA.COLUMNS 
+        WHERE TABLE_SCHEMA = ?
+        ORDER BY TABLE_NAME, ORDINAL_POSITION
       `;
             const columns = await this.db.query(columnsQuery, [database]);
             // Get foreign keys
-            const fkQuery = `
-        SELECT 
-          TABLE_NAME, COLUMN_NAME, 
-          REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
-        FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
-        WHERE TABLE_SCHEMA = ? 
-          AND REFERENCED_TABLE_SCHEMA = ? 
-          AND REFERENCED_TABLE_NAME IS NOT NULL
+            const fkQuery = `
+        SELECT 
+          TABLE_NAME, COLUMN_NAME, 
+          REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
+        FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
+        WHERE TABLE_SCHEMA = ? 
+          AND REFERENCED_TABLE_SCHEMA = ? 
+          AND REFERENCED_TABLE_NAME IS NOT NULL
       `;
             const fks = await this.db.query(fkQuery, [database, database]);
             // Build Mermaid ER diagram

package/dist/tools/ddlTools.js

@@ -252,7 +252,7 @@ class DdlTools {
             if (!isDdl) {
                 return {
                     status: "error",
-                    error: "Only DDL operations (CREATE, ALTER, DROP, TRUNCATE, RENAME) are allowed with execute_ddl. For SELECT queries, use the 'run_query' tool instead. For INSERT/UPDATE/DELETE, use the 'execute_sql' tool.",
+                    error: "Only DDL operations (CREATE, ALTER, DROP, TRUNCATE, RENAME) are allowed with execute_ddl. For SELECT queries, use the 'run_select_query' tool instead. For INSERT/UPDATE/DELETE, use the 'execute_write_query' tool.",
                 };
             }
             const result = await this.db.query(query);

package/dist/tools/queryTools.d.ts

@@ -8,7 +8,7 @@ export declare class QueryTools {
     /**
      * Execute a safe read-only SELECT query with optional optimizer hints
      */
-    runQuery(queryParams: {
+    runSelectQuery(queryParams: {
         query: string;
         params?: any[];
         hints?: QueryHints;
@@ -36,7 +36,7 @@ export declare class QueryTools {
      * Execute write operations (INSERT, UPDATE, DELETE) with validation
      * Note: DDL operations are blocked by the security layer for safety
      */
-    executeSql(queryParams: {
+    executeWriteQuery(queryParams: {
         query: string;
         params?: any[];
     }): Promise<{

package/dist/tools/queryTools.js

@@ -5,7 +5,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QueryTools = void 0;
 const connection_1 = __importDefault(require("../db/connection"));
-const schemas_1 = require("../validation/schemas");
 const queryOptimizer_1 = require("../optimization/queryOptimizer");
 class QueryTools {
     constructor(security) {
@@ -16,14 +15,7 @@ class QueryTools {
     /**
      * Execute a safe read-only SELECT query with optional optimizer hints
      */
-    async runQuery(queryParams) {
-        // Validate input schema
-        if (!(0, schemas_1.validateRunQuery)(queryParams)) {
-            return {
-                status: "error",
-                error: "Invalid parameters: " + JSON.stringify(schemas_1.validateRunQuery.errors),
-            };
-        }
+    async runSelectQuery(queryParams) {
         try {
             const { query, params = [], hints, useCache = true } = queryParams;
             // Check if user has execute permission to bypass dangerous keyword checks
@@ -41,7 +33,7 @@ class QueryTools {
             if (queryValidation.queryType !== "SELECT") {
                 return {
                     status: "error",
-                    error: "Only SELECT queries are allowed with runQuery. Use executeSql for other operations.",
+                    error: "Only SELECT queries are allowed with run_select_query. Use execute_write_query for other operations.",
                 };
             }
             // Validate parameters
@@ -120,18 +112,11 @@ class QueryTools {
      * Execute write operations (INSERT, UPDATE, DELETE) with validation
      * Note: DDL operations are blocked by the security layer for safety
      */
-    async executeSql(queryParams) {
-        // Validate input schema
-        if (!(0, schemas_1.validateRunQuery)(queryParams)) {
-            return {
-                status: "error",
-                error: "Invalid parameters: " + JSON.stringify(schemas_1.validateRunQuery.errors),
-            };
-        }
+    async executeWriteQuery(queryParams) {
         try {
             const { query, params = [] } = queryParams;
             // Validate query using security layer
-            // Pass true for bypassDangerousCheck since this is executeSql (requires 'execute' permission)
+            // Pass true for bypassDangerousCheck since this is executeWriteQuery (requires 'execute' permission)
             const queryValidation = this.security.validateQuery(query, true);
             if (!queryValidation.valid) {
                 return {
@@ -139,11 +124,11 @@ class QueryTools {
                     error: `Query validation failed: ${queryValidation.error}`,
                 };
             }
-            // Ensure it's not a SELECT query (use runQuery for that)
+            // Ensure it's not a SELECT query (use runSelectQuery for that)
             if (queryValidation.queryType === "SELECT") {
                 return {
                     status: "error",
-                    error: "SELECT queries should use runQuery method instead of executeSql.",
+                    error: "SELECT queries should use run_select_query method instead of execute_write_query.",
                 };
             }
             // Validate parameters

package/dist/tools/transactionTools.js

@@ -116,7 +116,7 @@ class TransactionTools {
                 };
             }
             // SECURITY VALIDATION: Check if user has execute permission
-            const hasExecutePermission = this.security.isToolEnabled("executeSql");
+            const hasExecutePermission = this.security.isToolEnabled("executeWriteQuery");
             // SECURITY VALIDATION: Validate the query before execution
             const queryValidation = this.security.validateQuery(params.query, hasExecutePermission);
             if (!queryValidation.valid) {

package/dist/validation/schemas.d.ts

@@ -172,36 +172,6 @@ export declare const deleteRecordSchema: {
     };
     additionalProperties: boolean;
 };
-export declare const runQuerySchema: {
-    type: string;
-    required: string[];
-    properties: {
-        query: {
-            type: string;
-        };
-        params: {
-            type: string;
-            items: {};
-            nullable: boolean;
-        };
-    };
-    additionalProperties: boolean;
-};
-export declare const executeSqlSchema: {
-    type: string;
-    required: string[];
-    properties: {
-        query: {
-            type: string;
-        };
-        params: {
-            type: string;
-            items: {};
-            nullable: boolean;
-        };
-    };
-    additionalProperties: boolean;
-};
 export declare const createTableSchema: {
     type: string;
     required: string[];
@@ -630,12 +600,6 @@ export declare const validateBulkUpdate: import("ajv").ValidateFunction<{
 export declare const validateBulkDelete: import("ajv").ValidateFunction<{
     [x: string]: {};
 }>;
-export declare const validateRunQuery: import("ajv").ValidateFunction<{
-    [x: string]: {};
-}>;
-export declare const validateExecuteSql: import("ajv").ValidateFunction<{
-    [x: string]: {};
-}>;
 export declare const validateCreateTable: import("ajv").ValidateFunction<{
     [x: string]: {};
 }>;

package/dist/validation/schemas.js

@@ -3,8 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateCreateStoredProcedure = exports.validateExecuteStoredProcedure = exports.validateGetStoredProcedureInfo = exports.validateListStoredProcedures = exports.validateExecuteInTransaction = exports.validateRollbackTransaction = exports.validateCommitTransaction = exports.validateBeginTransaction = exports.validateExecuteDdl = exports.validateDropTable = exports.validateAlterTable = exports.validateCreateTable = exports.validateExecuteSql = exports.validateRunQuery = exports.validateBulkDelete = exports.validateBulkUpdate = exports.validateBulkInsert = exports.validateDeleteRecord = exports.validateUpdateRecord = exports.validateReadRecords = exports.validateCreateRecord = exports.validateReadTableSchema = exports.validateListTables = exports.exportQueryToCsvSchema = exports.exportTableToCsvSchema = exports.showCreateProcedureSchema = exports.dropStoredProcedureSchema = exports.createStoredProcedureSchema = exports.executeStoredProcedureSchema = exports.getStoredProcedureInfoSchema = exports.listStoredProceduresSchema = exports.executeInTransactionSchema = exports.getTransactionStatusSchema = exports.rollbackTransactionSchema = exports.commitTransactionSchema = exports.beginTransactionSchema = exports.getAllTablesRelationshipsSchema = exports.getTableRelationshipsSchema = exports.executeDdlSchema = exports.dropTableSchema = exports.alterTableSchema = exports.createTableSchema = exports.executeSqlSchema = exports.runQuerySchema = exports.deleteRecordSchema = exports.updateRecordSchema = exports.readRecordsSchema = exports.createRecordSchema = exports.readTableSchemaSchema = exports.listTablesSchema = void 0;
-exports.validateExportQueryToCsv = exports.validateExportTableToCsv = exports.validateGetAllTablesRelationships = exports.validateGetTableRelationships = exports.validateStoredProcedureCreation = exports.validateStoredProcedureExecution = exports.validateShowCreateProcedure = exports.validateDropStoredProcedure = void 0;
+exports.validateStoredProcedureCreation = exports.validateStoredProcedureExecution = exports.validateShowCreateProcedure = exports.validateDropStoredProcedure = exports.validateCreateStoredProcedure = exports.validateExecuteStoredProcedure = exports.validateGetStoredProcedureInfo = exports.validateListStoredProcedures = exports.validateExecuteInTransaction = exports.validateRollbackTransaction = exports.validateCommitTransaction = exports.validateBeginTransaction = exports.validateExecuteDdl = exports.validateDropTable = exports.validateAlterTable = exports.validateCreateTable = exports.validateBulkDelete = exports.validateBulkUpdate = exports.validateBulkInsert = exports.validateDeleteRecord = exports.validateUpdateRecord = exports.validateReadRecords = exports.validateCreateRecord = exports.validateReadTableSchema = exports.validateListTables = exports.exportQueryToCsvSchema = exports.exportTableToCsvSchema = exports.showCreateProcedureSchema = exports.dropStoredProcedureSchema = exports.createStoredProcedureSchema = exports.executeStoredProcedureSchema = exports.getStoredProcedureInfoSchema = exports.listStoredProceduresSchema = exports.executeInTransactionSchema = exports.getTransactionStatusSchema = exports.rollbackTransactionSchema = exports.commitTransactionSchema = exports.beginTransactionSchema = exports.getAllTablesRelationshipsSchema = exports.getTableRelationshipsSchema = exports.executeDdlSchema = exports.dropTableSchema = exports.alterTableSchema = exports.createTableSchema = exports.deleteRecordSchema = exports.updateRecordSchema = exports.readRecordsSchema = exports.createRecordSchema = exports.readTableSchemaSchema = exports.listTablesSchema = void 0;
+exports.validateExportQueryToCsv = exports.validateExportTableToCsv = exports.validateGetAllTablesRelationships = exports.validateGetTableRelationships = void 0;
 const ajv_1 = __importDefault(require("ajv"));
 const ajv = new ajv_1.default();
 // Schema definitions
@@ -141,33 +141,8 @@ const filterConditionSchema = {
     },
     additionalProperties: false
 };
-exports.runQuerySchema = {
-    type: 'object',
-    required: ['query'],
-    properties: {
-        query: { type: 'string' },
-        params: {
-            type: 'array',
-            items: {},
-            nullable: true
-        }
-    },
-    additionalProperties: false
-};
-// SQL execution schema
-exports.executeSqlSchema = {
-    type: 'object',
-    required: ['query'],
-    properties: {
-        query: { type: 'string' },
-        params: {
-            type: 'array',
-            items: {},
-            nullable: true
-        }
-    },
-    additionalProperties: false
-};
+// Note: runQuerySchema and executeSqlSchema have been removed
+// Use runSelectQuerySchema and executeWriteQuerySchema instead
 // DDL schemas
 exports.createTableSchema = {
     type: 'object',
@@ -518,8 +493,6 @@ exports.validateDeleteRecord = ajv.compile(exports.deleteRecordSchema);
 exports.validateBulkInsert = ajv.compile(bulkInsertSchema);
 exports.validateBulkUpdate = ajv.compile(bulkUpdateSchema);
 exports.validateBulkDelete = ajv.compile(bulkDeleteSchema);
-exports.validateRunQuery = ajv.compile(exports.runQuerySchema);
-exports.validateExecuteSql = ajv.compile(exports.executeSqlSchema);
 exports.validateCreateTable = ajv.compile(exports.createTableSchema);
 exports.validateAlterTable = ajv.compile(exports.alterTableSchema);
 exports.validateDropTable = ajv.compile(exports.dropTableSchema);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.26.4",
+  "version": "1.28.0",
   "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",
@@ -87,4 +87,4 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.2.2"
   }
-}
+}