@berthojoris/mcp-mysql-server 1.7.0 → 1.8.0

package/dist/mcp-server.js

@@ -2181,6 +2181,193 @@ const TOOLS = [
             required: ["table_name", "json_data"],
         },
     },
+    // Data Migration Tools
+    {
+        name: "copy_table_data",
+        description: "Copy data from one table to another with optional column mapping and filtering. Requires 'create' permission.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                source_table: {
+                    type: "string",
+                    description: "Name of the source table to copy from",
+                },
+                target_table: {
+                    type: "string",
+                    description: "Name of the target table to copy to",
+                },
+                column_mapping: {
+                    type: "object",
+                    description: "Optional: map source columns to target columns {source_col: target_col}",
+                    additionalProperties: { type: "string" },
+                },
+                filters: {
+                    type: "array",
+                    description: "Optional: array of filter conditions for source data",
+                    items: {
+                        type: "object",
+                        properties: {
+                            field: { type: "string" },
+                            operator: {
+                                type: "string",
+                                enum: ["eq", "neq", "gt", "gte", "lt", "lte", "like", "in"],
+                            },
+                            value: {},
+                        },
+                        required: ["field", "operator", "value"],
+                    },
+                },
+                batch_size: {
+                    type: "number",
+                    description: "Number of rows per batch insert (default: 1000)",
+                },
+                database: {
+                    type: "string",
+                    description: "Optional: specific database name",
+                },
+            },
+            required: ["source_table", "target_table"],
+        },
+    },
+    {
+        name: "move_table_data",
+        description: "Move data from one table to another (copy then delete from source). Requires 'create' and 'delete' permissions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                source_table: {
+                    type: "string",
+                    description: "Name of the source table to move from",
+                },
+                target_table: {
+                    type: "string",
+                    description: "Name of the target table to move to",
+                },
+                column_mapping: {
+                    type: "object",
+                    description: "Optional: map source columns to target columns {source_col: target_col}",
+                    additionalProperties: { type: "string" },
+                },
+                filters: {
+                    type: "array",
+                    description: "Optional: array of filter conditions for source data",
+                    items: {
+                        type: "object",
+                        properties: {
+                            field: { type: "string" },
+                            operator: {
+                                type: "string",
+                                enum: ["eq", "neq", "gt", "gte", "lt", "lte", "like", "in"],
+                            },
+                            value: {},
+                        },
+                        required: ["field", "operator", "value"],
+                    },
+                },
+                batch_size: {
+                    type: "number",
+                    description: "Number of rows per batch (default: 1000)",
+                },
+                database: {
+                    type: "string",
+                    description: "Optional: specific database name",
+                },
+            },
+            required: ["source_table", "target_table"],
+        },
+    },
+    {
+        name: "clone_table",
+        description: "Clone a table structure with optional data. Requires 'ddl' permission.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                source_table: {
+                    type: "string",
+                    description: "Name of the source table to clone",
+                },
+                new_table_name: {
+                    type: "string",
+                    description: "Name of the new table to create",
+                },
+                include_data: {
+                    type: "boolean",
+                    description: "Include table data in the clone (default: false)",
+                },
+                include_indexes: {
+                    type: "boolean",
+                    description: "Include indexes in the clone (default: true)",
+                },
+                database: {
+                    type: "string",
+                    description: "Optional: specific database name",
+                },
+            },
+            required: ["source_table", "new_table_name"],
+        },
+    },
+    {
+        name: "compare_table_structure",
+        description: "Compare the structure of two tables and identify differences in columns, types, and indexes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                table1: {
+                    type: "string",
+                    description: "Name of the first table",
+                },
+                table2: {
+                    type: "string",
+                    description: "Name of the second table",
+                },
+                database: {
+                    type: "string",
+                    description: "Optional: specific database name",
+                },
+            },
+            required: ["table1", "table2"],
+        },
+    },
+    {
+        name: "sync_table_data",
+        description: "Synchronize data between two tables based on a key column. Supports insert-only, update-only, or upsert modes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                source_table: {
+                    type: "string",
+                    description: "Name of the source table",
+                },
+                target_table: {
+                    type: "string",
+                    description: "Name of the target table",
+                },
+                key_column: {
+                    type: "string",
+                    description: "Primary key or unique column to match records",
+                },
+                columns_to_sync: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional: specific columns to sync (default: all columns)",
+                },
+                sync_mode: {
+                    type: "string",
+                    enum: ["insert_only", "update_only", "upsert"],
+                    description: "Sync mode: insert_only (new records), update_only (existing), upsert (both). Default: upsert",
+                },
+                batch_size: {
+                    type: "number",
+                    description: "Number of rows per batch (default: 1000)",
+                },
+                database: {
+                    type: "string",
+                    description: "Optional: specific database name",
+                },
+            },
+            required: ["source_table", "target_table", "key_column"],
+        },
+    },
 ];
 // Create the MCP server
 const server = new index_js_1.Server({
@@ -2503,6 +2690,22 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "import_from_json":
                 result = await mysqlMCP.importFromJSON((args || {}));
                 break;
+            // Data Migration Tools
+            case "copy_table_data":
+                result = await mysqlMCP.copyTableData((args || {}));
+                break;
+            case "move_table_data":
+                result = await mysqlMCP.moveTableData((args || {}));
+                break;
+            case "clone_table":
+                result = await mysqlMCP.cloneTable((args || {}));
+                break;
+            case "compare_table_structure":
+                result = await mysqlMCP.compareTableStructure((args || {}));
+                break;
+            case "sync_table_data":
+                result = await mysqlMCP.syncTableData((args || {}));
+                break;
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/dist/tools/migrationTools.d.ts

@@ -0,0 +1,96 @@
+import SecurityLayer from "../security/securityLayer";
+/**
+ * Data Migration Tools for MySQL MCP Server
+ * Provides utilities for copying, moving, and transforming data between tables
+ */
+export declare class MigrationTools {
+    private db;
+    private security;
+    constructor(security: SecurityLayer);
+    /**
+     * Validate database access
+     */
+    private validateDatabaseAccess;
+    /**
+     * Escape string value for SQL
+     */
+    private escapeValue;
+    /**
+     * Copy data from one table to another within the same database
+     */
+    copyTableData(params: {
+        source_table: string;
+        target_table: string;
+        column_mapping?: Record<string, string>;
+        where_clause?: string;
+        truncate_target?: boolean;
+        batch_size?: number;
+        database?: string;
+    }): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+        queryLog?: string;
+    }>;
+    /**
+     * Move data from one table to another (copy + delete from source)
+     */
+    moveTableData(params: {
+        source_table: string;
+        target_table: string;
+        column_mapping?: Record<string, string>;
+        where_clause?: string;
+        batch_size?: number;
+        database?: string;
+    }): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+        queryLog?: string;
+    }>;
+    /**
+     * Clone a table structure (with or without data)
+     */
+    cloneTable(params: {
+        source_table: string;
+        new_table_name: string;
+        include_data?: boolean;
+        include_indexes?: boolean;
+        database?: string;
+    }): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+        queryLog?: string;
+    }>;
+    /**
+     * Compare structure of two tables
+     */
+    compareTableStructure(params: {
+        table1: string;
+        table2: string;
+        database?: string;
+    }): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+        queryLog?: string;
+    }>;
+    /**
+     * Sync data between two tables based on a key column
+     */
+    syncTableData(params: {
+        source_table: string;
+        target_table: string;
+        key_column: string;
+        columns_to_sync?: string[];
+        sync_mode?: "insert_only" | "update_only" | "upsert";
+        batch_size?: number;
+        database?: string;
+    }): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+        queryLog?: string;
+    }>;
+}