@berthojoris/mcp-mysql-server 1.20.0 → 1.22.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.22.0] - 2025-12-17
+
+### Changed
+- Updated tool count from 150 to 144 to reflect current actual number of available tools
+- Updated documentation timestamps and version references across all documentation files
+
+## [1.21.0] - 2025-12-17
+
+### Added
+- New tool `get_all_tables_relationships` for bulk foreign key relationship analysis across all tables in a single call
+- Enhanced relationship discovery with in-memory processing for improved performance
+- Added comprehensive validation schema for the new bulk relationships tool
+
+### Changed
+- Updated documentation to include the new `get_all_tables_relationships` tool
+- Extended query logging support to cover the new bulk relationships functionality
+
 ## [1.20.0] - 2025-12-17
 
 ### Changed

package/DOCUMENTATIONS.md

@@ -1,6 +1,6 @@
 # MySQL MCP Server - Detailed Documentation
 
-**Last Updated:** 2025-12-17 00:00:00
+**Last Updated:** 2025-12-17 15:30: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 150 tools organized by category
+2. [🔧 Complete Tools Reference](#🔧-complete-tools-reference) - All 144 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 150 available tools organized by category.
+This section provides a comprehensive reference of all 144 available tools organized by category.
 
 ### Database Discovery
 
@@ -211,6 +211,7 @@ This section provides a comprehensive reference of all 150 available tools organ
 | `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 foreign key relationships for ALL tables in a single call with in-memory processing |
 
 ### Data Operations - CRUD
 
@@ -3657,7 +3658,7 @@ Parameters:
 
 Query logs are now included in responses from **ALL 30 tools**:
 
-✅ **Database Discovery** - `list_databases`, `list_tables`, `read_table_schema`, `get_table_relationships`
+✅ **Database Discovery** - `list_databases`, `list_tables`, `read_table_schema`, `get_table_relationships`, `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`

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-17 00:00:00
+**Last Updated:** 2025-12-17 15:30: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)
@@ -300,7 +300,7 @@ Common configuration examples are documented in **[DOCUMENTATIONS.md → Categor
 
 ## Available Tools
 
-The server exposes **150 tools** organized into categories (CRUD, schema, backups, migrations, perf/monitoring, and AI enhancement).
+The server exposes **144 tools** organized into categories (CRUD, schema, backups, migrations, perf/monitoring, and AI enhancement).
 
 - Complete list of tools: **[DOCUMENTATIONS.md → Complete Tools Reference](DOCUMENTATIONS.md#🔧-complete-tools-reference)**
 - AI enhancement tools overview: **[DOCUMENTATIONS.md → AI Enhancement Tools](DOCUMENTATIONS.md#🤖-ai-enhancement-tools)**

package/dist/config/featureConfig.js

@@ -89,6 +89,7 @@ exports.toolCategoryMap = {
     describeConnection: ToolCategory.UTILITY,
     testConnection: ToolCategory.UTILITY,
     getTableRelationships: ToolCategory.UTILITY,
+    getAllTablesRelationships: ToolCategory.UTILITY,
     exportTableToCSV: ToolCategory.UTILITY,
     exportQueryToCSV: ToolCategory.UTILITY,
     safe_export_table: ToolCategory.UTILITY,
@@ -225,6 +226,7 @@ exports.toolDocCategoryMap = {
     listTables: DocCategory.DATABASE_DISCOVERY,
     readTableSchema: DocCategory.DATABASE_DISCOVERY,
     getTableRelationships: DocCategory.DATABASE_DISCOVERY,
+    getAllTablesRelationships: DocCategory.DATABASE_DISCOVERY,
     // CRUD Operations
     createRecord: DocCategory.CRUD_OPERATIONS,
     readRecords: DocCategory.CRUD_OPERATIONS,

package/dist/index.d.ts

@@ -200,6 +200,13 @@ export declare class MySQLMCP {
         data?: any;
         error?: string;
     }>;
+    getAllTablesRelationships(params?: {
+        database?: string;
+    }): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+    }>;
     readChangelog(params?: {
         version?: string;
         limit?: number;

package/dist/index.js

@@ -254,6 +254,13 @@ class MySQLMCP {
         }
         return await this.utilityTools.getTableRelationships(params);
     }
+    async getAllTablesRelationships(params) {
+        const check = this.checkToolEnabled("getAllTablesRelationships");
+        if (!check.enabled) {
+            return { status: "error", error: check.error };
+        }
+        return await this.utilityTools.getAllTablesRelationships(params);
+    }
     async readChangelog(params) {
         const check = this.checkToolEnabled("read_changelog");
         if (!check.enabled) {

package/dist/mcp-server.js

@@ -697,6 +697,19 @@ const TOOLS = [
             required: ["table_name"],
         },
     },
+    {
+        name: "get_all_tables_relationships",
+        description: "Gets foreign key relationships for ALL tables in a single call. Processes relationships in memory to avoid multiple queries.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                database: {
+                    type: "string",
+                    description: "Optional: specific database name",
+                },
+            },
+        },
+    },
     // Transaction Tools
     {
         name: "begin_transaction",
@@ -3417,6 +3430,9 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "get_table_relationships":
                 result = await mysqlMCP.getTableRelationships((args || {}));
                 break;
+            case "get_all_tables_relationships":
+                result = await mysqlMCP.getAllTablesRelationships((args || {}));
+                break;
             // Transaction Tools
             case "begin_transaction":
                 result = await mysqlMCP.beginTransaction((args || {}));

package/dist/tools/utilityTools.d.ts

@@ -27,6 +27,17 @@ export declare class UtilityTools {
         data?: any;
         error?: string;
     }>;
+    /**
+     * Gets foreign key relationships for ALL tables in a single call
+     * Processes relationships in memory to avoid multiple queries
+     */
+    getAllTablesRelationships(params?: {
+        database?: string;
+    }): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+    }>;
     /**
      * Reads the CHANGELOG.md file from the project root
      */

package/dist/tools/utilityTools.js

@@ -210,6 +210,88 @@ class UtilityTools {
             };
         }
     }
+    /**
+     * Gets foreign key relationships for ALL tables in a single call
+     * Processes relationships in memory to avoid multiple queries
+     */
+    async getAllTablesRelationships(params) {
+        try {
+            const databaseName = params?.database || this.db.pool.pool.config.connectionConfig.database;
+            // Get all tables in the database
+            const tablesQuery = `
+        SELECT TABLE_NAME as table_name
+        FROM INFORMATION_SCHEMA.TABLES
+        WHERE TABLE_SCHEMA = ?
+        AND TABLE_TYPE = 'BASE TABLE'
+        ORDER BY TABLE_NAME
+      `;
+            const tablesResult = await this.db.query(tablesQuery, [databaseName]);
+            const tableNames = tablesResult.map(row => row.table_name);
+            // Get ALL foreign key relationships in a single query
+            const relationshipsQuery = `
+        SELECT
+          TABLE_NAME as child_table,
+          COLUMN_NAME as child_column,
+          REFERENCED_TABLE_NAME as parent_table,
+          REFERENCED_COLUMN_NAME as parent_column,
+          CONSTRAINT_NAME as constraint_name
+        FROM
+          INFORMATION_SCHEMA.KEY_COLUMN_USAGE
+        WHERE
+          TABLE_SCHEMA = ?
+          AND REFERENCED_TABLE_NAME IS NOT NULL
+        ORDER BY
+          REFERENCED_TABLE_NAME, TABLE_NAME
+      `;
+            const allRelationships = await this.db.query(relationshipsQuery, [databaseName]);
+            // Initialize result object with all tables having empty relationships
+            const result = {};
+            tableNames.forEach(tableName => {
+                result[tableName] = {
+                    as_parent: [],
+                    as_child: []
+                };
+            });
+            // Process relationships in memory
+            allRelationships.forEach(relationship => {
+                const { child_table, parent_table } = relationship;
+                // Add to parent table's "as_parent" array
+                if (result[parent_table]) {
+                    result[parent_table].as_parent.push({
+                        child_table: relationship.child_table,
+                        child_column: relationship.child_column,
+                        parent_table: relationship.parent_table,
+                        parent_column: relationship.parent_column,
+                        constraint_name: relationship.constraint_name
+                    });
+                }
+                // Add to child table's "as_child" array
+                if (result[child_table]) {
+                    result[child_table].as_child.push({
+                        child_table: relationship.child_table,
+                        child_column: relationship.child_column,
+                        parent_table: relationship.parent_table,
+                        parent_column: relationship.parent_column,
+                        constraint_name: relationship.constraint_name
+                    });
+                }
+            });
+            return {
+                status: "success",
+                data: {
+                    total_tables: tableNames.length,
+                    total_relationships: allRelationships.length,
+                    relationships: result
+                }
+            };
+        }
+        catch (error) {
+            return {
+                status: "error",
+                error: error.message,
+            };
+        }
+    }
     /**
      * Reads the CHANGELOG.md file from the project root
      */

package/dist/validation/schemas.d.ts

@@ -343,6 +343,16 @@ export declare const getTableRelationshipsSchema: {
     };
     additionalProperties: boolean;
 };
+export declare const getAllTablesRelationshipsSchema: {
+    type: string;
+    required: never[];
+    properties: {
+        database: {
+            type: string;
+        };
+    };
+    additionalProperties: boolean;
+};
 export declare const beginTransactionSchema: {
     type: string;
     properties: {
@@ -677,6 +687,7 @@ export declare const validateStoredProcedureCreation: import("ajv").ValidateFunc
 export declare const validateGetTableRelationships: import("ajv").ValidateFunction<{
     [x: string]: {};
 }>;
+export declare const validateGetAllTablesRelationships: import("ajv").ValidateFunction<unknown>;
 export declare const validateExportTableToCsv: 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.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.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.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.validateGetTableRelationships = exports.validateStoredProcedureCreation = exports.validateStoredProcedureExecution = exports.validateShowCreateProcedure = void 0;
+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;
 const ajv_1 = __importDefault(require("ajv"));
 const ajv = new ajv_1.default();
 // Schema definitions
@@ -258,6 +258,14 @@ exports.getTableRelationshipsSchema = {
     },
     additionalProperties: false
 };
+exports.getAllTablesRelationshipsSchema = {
+    type: 'object',
+    required: [],
+    properties: {
+        database: { type: 'string' }
+    },
+    additionalProperties: false
+};
 // Transaction Schemas
 exports.beginTransactionSchema = {
     type: 'object',
@@ -529,5 +537,6 @@ exports.validateShowCreateProcedure = ajv.compile(exports.showCreateProcedureSch
 exports.validateStoredProcedureExecution = ajv.compile(exports.executeStoredProcedureSchema);
 exports.validateStoredProcedureCreation = ajv.compile(exports.createStoredProcedureSchema);
 exports.validateGetTableRelationships = ajv.compile(exports.getTableRelationshipsSchema);
+exports.validateGetAllTablesRelationships = ajv.compile(exports.getAllTablesRelationshipsSchema);
 exports.validateExportTableToCsv = ajv.compile(exports.exportTableToCsvSchema);
 exports.validateExportQueryToCsv = ajv.compile(exports.exportQueryToCsvSchema);

package/manifest.json

@@ -402,6 +402,66 @@
         }
       }
     },
+    {
+      "name": "get_all_tables_relationships",
+      "description": "Gets foreign key relationships for ALL tables in a single call. Processes relationships in memory to avoid multiple queries.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "database": {
+            "type": "string",
+            "description": "Optional: specific database name"
+          }
+        }
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "total_tables": {
+            "type": "number"
+          },
+          "total_relationships": {
+            "type": "number"
+          },
+          "relationships": {
+            "type": "object",
+            "patternProperties": {
+              ".*": {
+                "type": "object",
+                "properties": {
+                  "as_parent": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "child_table": { "type": "string" },
+                        "child_column": { "type": "string" },
+                        "parent_table": { "type": "string" },
+                        "parent_column": { "type": "string" },
+                        "constraint_name": { "type": "string" }
+                      }
+                    }
+                  },
+                  "as_child": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "child_table": { "type": "string" },
+                        "child_column": { "type": "string" },
+                        "parent_table": { "type": "string" },
+                        "parent_column": { "type": "string" },
+                        "constraint_name": { "type": "string" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     {
       "name": "get_schema_rag_context",
       "description": "Returns a condensed schema-aware context pack with tables, PK/FK details, and row estimates for RAG prompts.",

package/package.json

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