@neverinfamous/mysql-mcp 2.1.0

package/dist/adapters/mysql/tools/security/encryption.js

@@ -0,0 +1,191 @@
+/**
+ * MySQL Security - Encryption and SSL Tools
+ *
+ * Tools for SSL/TLS monitoring, encryption status, and password validation.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Zod Schemas
+// =============================================================================
+const PasswordValidateSchema = z.object({
+    password: z.string().describe('Password to validate')
+});
+// =============================================================================
+// Tool Creation Functions
+// =============================================================================
+/**
+ * Get SSL/TLS connection status
+ */
+export function createSecuritySSLStatusTool(adapter) {
+    return {
+        name: 'mysql_security_ssl_status',
+        title: 'MySQL SSL Status',
+        description: 'Get SSL/TLS connection and certificate status.',
+        group: 'security',
+        inputSchema: z.object({}),
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (_params, _context) => {
+            // Get SSL status
+            const statusResult = await adapter.executeQuery("SHOW STATUS LIKE 'Ssl%'");
+            const status = Object.fromEntries((statusResult.rows ?? []).map(r => {
+                const record = r;
+                const varName = typeof record['Variable_name'] === 'string' ? record['Variable_name'] : '';
+                return [varName, record['Value']];
+            }));
+            // Get SSL variables
+            const varsResult = await adapter.executeQuery("SHOW VARIABLES LIKE '%ssl%'");
+            const variables = Object.fromEntries((varsResult.rows ?? []).map(r => {
+                const record = r;
+                const varName = typeof record['Variable_name'] === 'string' ? record['Variable_name'] : '';
+                return [varName, record['Value']];
+            }));
+            // Check current connection
+            // We use raw status/variables now, but @@ssl_cipher is still valid
+            // const connResult = await adapter.executeQuery("SELECT @@ssl_cipher as cipher"); // Removing unused query for now as we get cipher from status
+            // Actually, wait, status['Ssl_cipher'] gives the cipher.
+            // But let's check if we need @@ssl_cipher. 
+            // The original code used: sslEnabled: str(status['Ssl_cipher']) !== ''
+            // So we don't strictly need @@ssl_cipher if Ssl_cipher status is reliable.
+            // Let's just remove the unused query entirely.
+            // const connRow = connResult.rows?.[0]; // deleted
+            // Helper to safely extract string values
+            const str = (val, defaultVal = '') => typeof val === 'string' ? val : defaultVal;
+            return {
+                sslEnabled: str(status['Ssl_cipher']) !== '',
+                currentCipher: str(status['Ssl_cipher'], 'None'),
+                sslVersion: str(status['Ssl_version'], 'N/A'),
+                serverCertVerification: false, // Unknown in recent versions via variables
+                configuration: {
+                    sslCa: str(variables['ssl_ca']),
+                    sslCert: str(variables['ssl_cert']),
+                    sslKey: str(variables['ssl_key']),
+                    requireSecureTransport: str(variables['require_secure_transport'], 'OFF')
+                },
+                sessionStats: {
+                    acceptedConnects: str(status['Ssl_accepts'], '0'),
+                    finishedConnects: str(status['Ssl_finished_accepts'], '0')
+                }
+            };
+        }
+    };
+}
+/**
+ * Check encryption status
+ */
+export function createSecurityEncryptionStatusTool(adapter) {
+    return {
+        name: 'mysql_security_encryption_status',
+        title: 'MySQL Encryption Status',
+        description: 'Get Transparent Data Encryption (TDE) and keyring status.',
+        group: 'security',
+        inputSchema: z.object({}),
+        requiredScopes: ['admin'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (_params, _context) => {
+            // Check for keyring plugins
+            const keyringResult = await adapter.executeQuery(`
+                SELECT PLUGIN_NAME, PLUGIN_STATUS
+                FROM information_schema.PLUGINS
+                WHERE PLUGIN_NAME LIKE 'keyring%'
+            `);
+            // Check encrypted tablespaces
+            const tablespaceResult = await adapter.executeQuery(`
+                SELECT 
+                    NAME,
+                    ENCRYPTION
+                FROM information_schema.INNODB_TABLESPACES
+                WHERE ENCRYPTION = 'Y'
+            `);
+            // Check encryption variables
+            const varsResult = await adapter.executeQuery("SHOW VARIABLES LIKE '%encrypt%'");
+            const variables = Object.fromEntries((varsResult.rows ?? []).map(r => {
+                const record = r;
+                const varName = typeof record['Variable_name'] === 'string' ? record['Variable_name'] : '';
+                return [varName, record['Value']];
+            }));
+            // Check redo/undo log encryption
+            const innodbVarsResult = await adapter.executeQuery("SHOW VARIABLES LIKE 'innodb_%encrypt%'");
+            const innodbVars = Object.fromEntries((innodbVarsResult.rows ?? []).map(r => {
+                const record = r;
+                const varName = typeof record['Variable_name'] === 'string' ? record['Variable_name'] : '';
+                return [varName, record['Value']];
+            }));
+            return {
+                keyringPlugins: keyringResult.rows ?? [],
+                keyringInstalled: (keyringResult.rows?.length ?? 0) > 0,
+                encryptedTablespaces: tablespaceResult.rows ?? [],
+                encryptedTablespaceCount: tablespaceResult.rows?.length ?? 0,
+                encryptionSettings: {
+                    ...variables,
+                    ...innodbVars
+                },
+                tdeAvailable: (keyringResult.rows?.length ?? 0) > 0
+            };
+        }
+    };
+}
+/**
+ * Validate password strength
+ */
+export function createSecurityPasswordValidateTool(adapter) {
+    return {
+        name: 'mysql_security_password_validate',
+        title: 'MySQL Password Validation',
+        description: 'Validate password strength using MySQL validate_password component.',
+        group: 'security',
+        inputSchema: PasswordValidateSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { password } = PasswordValidateSchema.parse(params);
+            try {
+                // Try using validate_password function
+                const result = await adapter.executeQuery('SELECT VALIDATE_PASSWORD_STRENGTH(?) as strength', [password]);
+                const row = result.rows?.[0];
+                const strength = row?.['strength'] ?? 0;
+                // Get password policy
+                const policyResult = await adapter.executeQuery("SHOW VARIABLES LIKE 'validate_password%'");
+                const policy = Object.fromEntries((policyResult.rows ?? []).map(r => {
+                    const record = r;
+                    const varName = typeof record['Variable_name'] === 'string' ? record['Variable_name'] : '';
+                    return [varName, record['Value']];
+                }));
+                let interpretation;
+                if (strength >= 100)
+                    interpretation = 'Very Strong';
+                else if (strength >= 75)
+                    interpretation = 'Strong';
+                else if (strength >= 50)
+                    interpretation = 'Medium';
+                else if (strength >= 25)
+                    interpretation = 'Weak';
+                else
+                    interpretation = 'Very Weak';
+                return {
+                    strength,
+                    interpretation,
+                    meetsPolicy: strength >= 50, // General guideline
+                    policy
+                };
+            }
+            catch {
+                return {
+                    available: false,
+                    message: 'Password validation component not installed',
+                    suggestion: 'Install with: INSTALL COMPONENT "file://component_validate_password"'
+                };
+            }
+        }
+    };
+}
+//# sourceMappingURL=encryption.js.map

package/dist/adapters/mysql/tools/security/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/security/encryption.ts"],"names":[],"mappings":"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"}

package/dist/adapters/mysql/tools/security/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MySQL Security Tools
+ *
+ * Tools for security auditing and monitoring.
+ * 9 tools total.
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Get all security tools
+ */
+export declare function getSecurityTools(adapter: MySQLAdapter): ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/mysql/tools/security/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/security/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAqBjE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,EAAE,CAYxE"}

package/dist/adapters/mysql/tools/security/index.js

@@ -0,0 +1,27 @@
+/**
+ * MySQL Security Tools
+ *
+ * Tools for security auditing and monitoring.
+ * 9 tools total.
+ */
+// Import from submodules
+import { createSecurityAuditTool, createSecurityFirewallStatusTool, createSecurityFirewallRulesTool } from './audit.js';
+import { createSecuritySSLStatusTool, createSecurityEncryptionStatusTool, createSecurityPasswordValidateTool } from './encryption.js';
+import { createSecurityMaskDataTool, createSecurityUserPrivilegesTool, createSecuritySensitiveTablesTool } from './data-protection.js';
+/**
+ * Get all security tools
+ */
+export function getSecurityTools(adapter) {
+    return [
+        createSecurityAuditTool(adapter),
+        createSecurityFirewallStatusTool(adapter),
+        createSecurityFirewallRulesTool(adapter),
+        createSecurityMaskDataTool(adapter),
+        createSecurityPasswordValidateTool(adapter),
+        createSecuritySSLStatusTool(adapter),
+        createSecurityUserPrivilegesTool(adapter),
+        createSecuritySensitiveTablesTool(adapter),
+        createSecurityEncryptionStatusTool(adapter)
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/mysql/tools/security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/security/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,yBAAyB;AACzB,OAAO,EACH,uBAAuB,EACvB,gCAAgC,EAChC,+BAA+B,EAClC,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,2BAA2B,EAC3B,kCAAkC,EAClC,kCAAkC,EACrC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACH,0BAA0B,EAC1B,gCAAgC,EAChC,iCAAiC,EACpC,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IAClD,OAAO;QACH,uBAAuB,CAAC,OAAO,CAAC;QAChC,gCAAgC,CAAC,OAAO,CAAC;QACzC,+BAA+B,CAAC,OAAO,CAAC;QACxC,0BAA0B,CAAC,OAAO,CAAC;QACnC,kCAAkC,CAAC,OAAO,CAAC;QAC3C,2BAA2B,CAAC,OAAO,CAAC;QACpC,gCAAgC,CAAC,OAAO,CAAC;QACzC,iCAAiC,CAAC,OAAO,CAAC;QAC1C,kCAAkC,CAAC,OAAO,CAAC;KAC9C,CAAC;AACN,CAAC"}

package/dist/adapters/mysql/tools/shell/backup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MySQL Shell - Backup Tools
+ *
+ * Tools for creating database dumps using MySQL Shell.
+ */
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Dump entire MySQL instance
+ */
+export declare function createShellDumpInstanceTool(): ToolDefinition;
+/**
+ * Dump selected schemas
+ */
+export declare function createShellDumpSchemasTool(): ToolDefinition;
+/**
+ * Dump specific tables
+ */
+export declare function createShellDumpTablesTool(): ToolDefinition;
+//# sourceMappingURL=backup.d.ts.map

package/dist/adapters/mysql/tools/shell/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/shell/backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,4BAA4B,CAAC;AAQjF;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CAsD5D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,cAAc,CAkE3D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,cAAc,CAmE1D"}

package/dist/adapters/mysql/tools/shell/backup.js

@@ -0,0 +1,187 @@
+/**
+ * MySQL Shell - Backup Tools
+ *
+ * Tools for creating database dumps using MySQL Shell.
+ */
+import { ShellDumpInstanceInputSchema, ShellDumpSchemasInputSchema, ShellDumpTablesInputSchema } from '../../types/shell-types.js';
+import { escapeForJS, execShellJS } from './common.js';
+/**
+ * Dump entire MySQL instance
+ */
+export function createShellDumpInstanceTool() {
+    return {
+        name: 'mysqlsh_dump_instance',
+        title: 'MySQL Shell Dump Instance',
+        description: 'Dump entire MySQL instance using util.dumpInstance(). Creates a compressed, parallel dump of all schemas (excluding system schemas). Ideal for full backups and migrations.',
+        group: 'shell',
+        inputSchema: ShellDumpInstanceInputSchema,
+        requiredScopes: ['admin'],
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true
+        },
+        handler: async (params, _context) => {
+            const { outputDir, threads, compression, dryRun, includeSchemas, excludeSchemas, consistent, users } = ShellDumpInstanceInputSchema.parse(params);
+            const escapedPath = outputDir.replace(/\\/g, '\\\\');
+            const options = [];
+            if (threads) {
+                options.push(`threads: ${threads}`);
+            }
+            if (compression && compression !== 'zstd') {
+                options.push(`compression: "${compression}"`);
+            }
+            if (dryRun) {
+                options.push('dryRun: true');
+            }
+            if (includeSchemas && includeSchemas.length > 0) {
+                options.push(`includeSchemas: ${JSON.stringify(includeSchemas)}`);
+            }
+            if (excludeSchemas && excludeSchemas.length > 0) {
+                options.push(`excludeSchemas: ${JSON.stringify(excludeSchemas)}`);
+            }
+            if (consistent !== undefined && !consistent) {
+                options.push('consistent: false');
+            }
+            if (users !== undefined && !users) {
+                options.push('users: false');
+            }
+            const optionsStr = options.length > 0 ? `, { ${options.join(', ')} }` : '';
+            const jsCode = `return util.dumpInstance("${escapedPath}"${optionsStr});`;
+            const result = await execShellJS(jsCode, { timeout: 3600000 }); // 1 hour timeout
+            return {
+                success: true,
+                outputDir,
+                dryRun: dryRun ?? false,
+                result
+            };
+        }
+    };
+}
+/**
+ * Dump selected schemas
+ */
+export function createShellDumpSchemasTool() {
+    return {
+        name: 'mysqlsh_dump_schemas',
+        title: 'MySQL Shell Dump Schemas',
+        description: 'Dump selected schemas using util.dumpSchemas(). Creates a compressed, parallel dump of specified schemas. Use for partial backups.',
+        group: 'shell',
+        inputSchema: ShellDumpSchemasInputSchema,
+        requiredScopes: ['admin'],
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true
+        },
+        handler: async (params, _context) => {
+            const { schemas, outputDir, threads, compression, dryRun, includeTables, excludeTables, ddlOnly } = ShellDumpSchemasInputSchema.parse(params);
+            const escapedPath = outputDir.replace(/\\/g, '\\\\');
+            const options = [];
+            if (threads) {
+                options.push(`threads: ${threads}`);
+            }
+            if (compression && compression !== 'zstd') {
+                options.push(`compression: "${compression}"`);
+            }
+            if (dryRun) {
+                options.push('dryRun: true');
+            }
+            if (includeTables && includeTables.length > 0) {
+                options.push(`includeTables: ${JSON.stringify(includeTables)}`);
+            }
+            if (excludeTables && excludeTables.length > 0) {
+                options.push(`excludeTables: ${JSON.stringify(excludeTables)}`);
+            }
+            // ddlOnly mode disables all metadata that requires extra privileges
+            if (ddlOnly) {
+                options.push('events: false');
+                options.push('triggers: false');
+                options.push('routines: false');
+            }
+            const optionsStr = options.length > 0 ? `, { ${options.join(', ')} }` : '';
+            const jsCode = `return util.dumpSchemas(${JSON.stringify(schemas)}, "${escapedPath}"${optionsStr});`;
+            try {
+                const result = await execShellJS(jsCode, { timeout: 3600000 });
+                return {
+                    success: true,
+                    schemas,
+                    outputDir,
+                    dryRun: dryRun ?? false,
+                    ddlOnly: ddlOnly ?? false,
+                    result
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                if (errorMessage.includes('EVENT') || errorMessage.includes('TRIGGER') || errorMessage.includes('privilege')) {
+                    throw new Error(`Dump failed due to missing privileges: ${errorMessage}. ` +
+                        `Try setting ddlOnly: true to skip events, triggers, and routines.`);
+                }
+                throw error;
+            }
+        }
+    };
+}
+/**
+ * Dump specific tables
+ */
+export function createShellDumpTablesTool() {
+    return {
+        name: 'mysqlsh_dump_tables',
+        title: 'MySQL Shell Dump Tables',
+        description: 'Dump specific tables using util.dumpTables(). Creates a compressed, parallel dump of specified tables from a schema.',
+        group: 'shell',
+        inputSchema: ShellDumpTablesInputSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true
+        },
+        handler: async (params, _context) => {
+            const { schema, tables, outputDir, threads, compression, where, all } = ShellDumpTablesInputSchema.parse(params);
+            const escapedPath = outputDir.replace(/\\/g, '\\\\');
+            const options = [];
+            if (threads) {
+                options.push(`threads: ${threads}`);
+            }
+            if (compression && compression !== 'zstd') {
+                options.push(`compression: "${compression}"`);
+            }
+            if (where && Object.keys(where).length > 0) {
+                const whereEntries = Object.entries(where)
+                    .map(([tbl, cond]) => `"${escapeForJS(tbl)}": "${escapeForJS(cond)}"`)
+                    .join(', ');
+                options.push(`where: { ${whereEntries} }`);
+            }
+            // When all is explicitly false, disable triggers/routines dumping
+            if (!all) {
+                options.push('triggers: false');
+            }
+            const optionsStr = options.length > 0 ? `, { ${options.join(', ')} }` : '';
+            const jsCode = `return util.dumpTables("${schema}", ${JSON.stringify(tables)}, "${escapedPath}"${optionsStr});`;
+            try {
+                const result = await execShellJS(jsCode, { timeout: 3600000 });
+                return {
+                    success: true,
+                    schema,
+                    tables,
+                    outputDir,
+                    triggersExcluded: !all,
+                    result
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                if (errorMessage.includes('privilege') || errorMessage.includes('Access denied') || errorMessage.includes('TRIGGER')) {
+                    throw new Error(`Dump failed due to missing privileges: ${errorMessage}. ` +
+                        `Try setting all: false to skip triggers if you lack TRIGGER privilege.`);
+                }
+                if (errorMessage.includes('Fatal error during dump')) {
+                    throw new Error(`Dump failed: ${errorMessage}. ` +
+                        `This may be due to missing privileges on the schema. Try setting all: false to skip metadata that requires extra privileges.`);
+                }
+                throw error;
+            }
+        }
+    };
+}
+//# sourceMappingURL=backup.js.map

package/dist/adapters/mysql/tools/shell/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/shell/backup.ts"],"names":[],"mappings":"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"}

package/dist/adapters/mysql/tools/shell/common.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MySQL Shell - Shared Configuration and Utilities
+ *
+ * Configuration helpers and subprocess execution utilities shared by all shell tools.
+ */
+export interface ShellConfig {
+    binPath: string;
+    connectionUri: string;
+    xConnectionUri: string;
+    timeout: number;
+    workDir: string;
+}
+/**
+ * Get MySQL Shell configuration from environment variables
+ */
+export declare function getShellConfig(): ShellConfig;
+/**
+ * Escape a string for safe embedding in JavaScript string literals.
+ * Escapes backslashes first, then double quotes, to prevent injection attacks.
+ */
+export declare function escapeForJS(str: string): string;
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Execute MySQL Shell command as subprocess
+ */
+export declare function execMySQLShell(args: string[], options?: {
+    timeout?: number;
+    cwd?: string;
+    input?: string;
+}): Promise<ExecResult>;
+/**
+ * Execute a JavaScript expression in MySQL Shell and return JSON result
+ */
+export declare function execShellJS(jsCode: string, options?: {
+    timeout?: number;
+}): Promise<unknown>;
+//# sourceMappingURL=common.d.ts.map

package/dist/adapters/mysql/tools/shell/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/shell/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAyB5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IACN,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,GACF,OAAO,CAAC,UAAU,CAAC,CA2DrB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,OAAO,CAAC,CAiFlB"}