@dexical30/mcp-server-mysql 2.1.0 → 2.1.1

package/dist/src/db/utils.js

@@ -1,222 +0,0 @@
-import { isMultiDbMode } from "./../config/index.js";
-import { log } from "./../utils/index.js";
-import SqlParser from "node-sql-parser";
-const { Parser } = SqlParser;
-const parser = new Parser();
-function extractSchemaFromQuery(sql) {
-    const defaultSchema = process.env.MYSQL_DB || null;
-    if (defaultSchema && !isMultiDbMode) {
-        return defaultSchema;
-    }
-    try {
-        const astOrArray = parser.astify(sql, { database: "mysql" });
-        const statements = Array.isArray(astOrArray) ? astOrArray : [astOrArray];
-        for (const stmt of statements) {
-            if (stmt.type === "use" && stmt.db) {
-                return stmt.db;
-            }
-            const tables = stmt.table || stmt.from;
-            if (Array.isArray(tables)) {
-                for (const t of tables) {
-                    if (t.db) {
-                        return t.db;
-                    }
-                }
-            }
-            else if (tables && typeof tables === "object" && tables.db) {
-                return tables.db;
-            }
-        }
-    }
-    catch (err) {
-        log("error", "Failed to parse SQL for schema extraction:", err.message);
-    }
-    return defaultSchema;
-}
-const EXPLAIN_MODIFIER_RE = /^(\s*EXPLAIN\s+)((?:ANALYZE\s+|EXTENDED\s+|PARTITIONS\s+|FORMAT\s*=\s*\w+\s+)+)/i;
-function stripExplainModifiers(sql) {
-    return sql.replace(EXPLAIN_MODIFIER_RE, "$1");
-}
-async function getQueryTypes(query) {
-    try {
-        log("info", "Parsing SQL query: ", query);
-        const normalised = stripExplainModifiers(query);
-        const astOrArray = parser.astify(normalised, { database: "mysql" });
-        const statements = Array.isArray(astOrArray) ? astOrArray : [astOrArray];
-        return statements.map((stmt) => stmt.type?.toLowerCase() ?? "unknown");
-    }
-    catch (err) {
-        log("error", "sqlParser error, query: ", query);
-        log("error", "Error parsing SQL query:", err);
-        throw new Error(`Parsing failed: ${err.message}`);
-    }
-}
-function containsSelectStar(sql) {
-    let astOrArray;
-    try {
-        astOrArray = parser.astify(sql, { database: "mysql" });
-    }
-    catch {
-        return false;
-    }
-    const statements = Array.isArray(astOrArray) ? astOrArray : [astOrArray];
-    return statements.some((stmt) => nodeHasColumnStar(stmt));
-}
-function nodeHasColumnStar(node) {
-    if (node == null || typeof node !== "object")
-        return false;
-    if (node instanceof Date)
-        return false;
-    const obj = node;
-    if (obj.type === "column_ref" && obj.column === "*")
-        return true;
-    for (const value of Object.values(obj)) {
-        if (Array.isArray(value)) {
-            if (value.some((item) => nodeHasColumnStar(item)))
-                return true;
-        }
-        else if (value && typeof value === "object") {
-            if (nodeHasColumnStar(value))
-                return true;
-        }
-    }
-    return false;
-}
-function findPIIColumnReferences(sql, isPII) {
-    let astOrArray;
-    try {
-        astOrArray = parser.astify(sql, { database: "mysql" });
-    }
-    catch {
-        return [];
-    }
-    const statements = Array.isArray(astOrArray) ? astOrArray : [astOrArray];
-    const seen = new Set();
-    const hits = [];
-    for (const stmt of statements) {
-        collectPIIColumnRefs(stmt, isPII, seen, hits);
-    }
-    return hits;
-}
-function collectPIIColumnRefs(node, isPII, seen, out) {
-    if (node == null || typeof node !== "object")
-        return;
-    if (node instanceof Date)
-        return;
-    const obj = node;
-    if (obj.type === "column_ref" &&
-        typeof obj.column === "string" &&
-        obj.column !== "*" &&
-        isPII(obj.column)) {
-        const table = typeof obj.table === "string" ? obj.table : null;
-        const key = `${table ?? ""}.${obj.column}`;
-        if (!seen.has(key)) {
-            seen.add(key);
-            out.push({ table, column: obj.column });
-        }
-    }
-    for (const value of Object.values(obj)) {
-        if (Array.isArray(value)) {
-            for (const item of value)
-                collectPIIColumnRefs(item, isPII, seen, out);
-        }
-        else if (value && typeof value === "object") {
-            collectPIIColumnRefs(value, isPII, seen, out);
-        }
-    }
-}
-const SHOW_INTROSPECTION_RE = /^\s*SHOW\s+(?:FULL\s+)?(COLUMNS|FIELDS|CREATE\s+TABLE|CREATE\s+VIEW|INDEX(?:ES)?|KEYS|TABLE\s+STATUS|TABLES|DATABASES|SCHEMAS|CHARACTER\s+SET|CHARSET|COLLATION)\b/i;
-const DESCRIBE_RE = /^\s*(?:DESCRIBE|DESC)\s+/i;
-const EXPLAIN_TABLE_RE = /^\s*EXPLAIN\s+(?!SELECT\b|INSERT\b|UPDATE\b|DELETE\b|REPLACE\b|ANALYZE\b|FORMAT\b|FOR\s|EXTENDED\b|PARTITIONS\b|\()[A-Za-z_`]/i;
-function isIntrospectionQuery(sql) {
-    const showMatch = sql.match(SHOW_INTROSPECTION_RE);
-    if (showMatch) {
-        const keyword = showMatch[1].toUpperCase().replace(/\s+/g, " ");
-        if (keyword.startsWith("COLUMNS") || keyword.startsWith("FIELDS")) {
-            return { kind: "show_columns" };
-        }
-        if (keyword.startsWith("CREATE")) {
-            return { kind: "show_create" };
-        }
-        if (keyword.startsWith("INDEX") ||
-            keyword.startsWith("KEYS")) {
-            return { kind: "show_index" };
-        }
-        if (keyword === "TABLES" ||
-            keyword.startsWith("TABLE STATUS") ||
-            keyword === "DATABASES" ||
-            keyword === "SCHEMAS" ||
-            keyword.startsWith("CHARACTER") ||
-            keyword === "CHARSET" ||
-            keyword === "COLLATION") {
-            return { kind: "show_passthrough" };
-        }
-        return { kind: "show_other" };
-    }
-    if (DESCRIBE_RE.test(sql) || EXPLAIN_TABLE_RE.test(sql)) {
-        return { kind: "describe" };
-    }
-    let astOrArray;
-    try {
-        astOrArray = parser.astify(sql, { database: "mysql" });
-    }
-    catch {
-        return { kind: null };
-    }
-    const statements = Array.isArray(astOrArray) ? astOrArray : [astOrArray];
-    for (const stmt of statements) {
-        const kind = findIntrospectionKind(stmt);
-        if (kind)
-            return { kind };
-    }
-    return { kind: null };
-}
-function findIntrospectionKind(node) {
-    if (node == null || typeof node !== "object")
-        return null;
-    if (node instanceof Date)
-        return null;
-    const obj = node;
-    if (obj.type === "show") {
-        const keyword = typeof obj.keyword === "string" ? obj.keyword.toLowerCase() : "";
-        if (keyword === "columns" || keyword === "fields")
-            return "show_columns";
-        if (keyword === "create")
-            return "show_create";
-        if (keyword === "index" || keyword === "keys")
-            return "show_index";
-        if (keyword === "tables" ||
-            keyword === "databases" ||
-            keyword === "character" ||
-            keyword === "collation") {
-            return "show_passthrough";
-        }
-        return "show_other";
-    }
-    if (obj.type === "desc" || obj.type === "describe") {
-        return "describe";
-    }
-    if (typeof obj.db === "string") {
-        const db = obj.db.toLowerCase();
-        if (db === "information_schema")
-            return "information_schema";
-        if (db === "mysql")
-            return "mysql_schema";
-    }
-    for (const value of Object.values(obj)) {
-        if (Array.isArray(value)) {
-            for (const item of value) {
-                const kind = findIntrospectionKind(item);
-                if (kind)
-                    return kind;
-            }
-        }
-        else if (value && typeof value === "object") {
-            const kind = findIntrospectionKind(value);
-            if (kind)
-                return kind;
-        }
-    }
-    return null;
-}
-export { extractSchemaFromQuery, getQueryTypes, containsSelectStar, findPIIColumnReferences, isIntrospectionQuery, };

package/dist/src/security/redact.js

@@ -1,230 +0,0 @@
-import { log } from "../utils/index.js";
-export const DEFAULT_PII_COLUMNS = [
-    "email",
-    "e_mail",
-    "ssn",
-    "social_security",
-    "phone",
-    "mobile",
-    "first_name",
-    "last_name",
-    "full_name",
-    "middle_name",
-    "given_name",
-    "family_name",
-    "surname",
-    "forename",
-    "maiden_name",
-    "preferred_name",
-    "legal_name",
-    "address",
-    "street",
-    "zip",
-    "postal_code",
-    "dob",
-    "date_of_birth",
-    "credit_card",
-    "card_number",
-    "cc_number",
-    "cvv",
-    "password",
-    "passwd",
-    "pwd",
-    "api_key",
-    "secret",
-    "token",
-    "ip_address",
-    "ipaddress",
-];
-const EMAIL_RE = /([A-Za-z0-9._%+-])[A-Za-z0-9._%+-]*@([A-Za-z0-9-])[A-Za-z0-9.-]*\.([A-Za-z]{2,})/g;
-const SSN_RE = /(?<!\d)\d{3}-\d{2}-(\d{4})(?!\d)/g;
-const US_PHONE_RE = /(?<!\d)(?:\+?1[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?(\d{4})(?!\d)/g;
-const IPV4_RE = /(?<!\d)(?:\d{1,3}\.){3}(\d{1,3})(?!\d)/g;
-const CARD_RE = /(?<!\d)(?:\d[ -]?){12,18}\d(?!\d)/g;
-export function maskEmail(value) {
-    return value.replace(EMAIL_RE, (_m, local, domain, tld) => `${local}***@${domain}***.${tld}`);
-}
-export function maskPhone(value) {
-    return value.replace(US_PHONE_RE, (_m, last4) => `***-***-${last4}`);
-}
-export function maskSSN(value) {
-    return value.replace(SSN_RE, (_m, last4) => `***-**-${last4}`);
-}
-export function maskIP(value) {
-    return value.replace(IPV4_RE, (_m, last) => `***.***.***.${last}`);
-}
-function isLuhnValid(digits) {
-    if (digits.length < 13 || digits.length > 19)
-        return false;
-    let sum = 0;
-    let alt = false;
-    for (let i = digits.length - 1; i >= 0; i--) {
-        const code = digits.charCodeAt(i);
-        if (code < 48 || code > 57)
-            return false;
-        let n = code - 48;
-        if (alt) {
-            n *= 2;
-            if (n > 9)
-                n -= 9;
-        }
-        sum += n;
-        alt = !alt;
-    }
-    return sum % 10 === 0;
-}
-export function maskCard(value) {
-    return value.replace(CARD_RE, (match) => {
-        const digits = match.replace(/[ -]/g, "");
-        if (!isLuhnValid(digits))
-            return match;
-        const last4 = digits.slice(-4);
-        return `****-****-****-${last4}`;
-    });
-}
-export function maskGeneric(value) {
-    if (value.length === 0)
-        return value;
-    if (value.length === 1)
-        return "*";
-    const keep = value.slice(0, 1);
-    const tailLen = Math.min(value.length - 1, 8);
-    return keep + "*".repeat(tailLen);
-}
-export function applyPatternMasks(value) {
-    let out = value;
-    out = maskEmail(out);
-    out = maskCard(out);
-    out = maskSSN(out);
-    out = maskPhone(out);
-    out = maskIP(out);
-    return out;
-}
-function matchPIIColumn(key, columns, patterns) {
-    const lower = key.toLowerCase();
-    for (const needle of columns) {
-        if (lower.includes(needle))
-            return `substring "${needle}"`;
-    }
-    for (const pattern of patterns) {
-        if (pattern.test(lower))
-            return `pattern ${pattern}`;
-    }
-    return null;
-}
-export function isPIIColumn(key, columns = DEFAULT_PII_COLUMNS, patterns = []) {
-    return matchPIIColumn(key, columns, patterns) !== null;
-}
-function maskByColumn(value) {
-    const patternMasked = applyPatternMasks(value);
-    if (patternMasked !== value)
-        return patternMasked;
-    return maskGeneric(value);
-}
-export function redactPII(value, options = {}) {
-    const cleanedExtras = options.extraColumns?.filter((s) => s.length > 0);
-    const columns = options.columns ??
-        (cleanedExtras && cleanedExtras.length > 0
-            ? [...DEFAULT_PII_COLUMNS, ...cleanedExtras]
-            : DEFAULT_PII_COLUMNS);
-    const patterns = options.columnPatterns ?? [];
-    const parseJsonStrings = options.parseJsonStrings !== false;
-    const stats = { fields: 0, columns: new Set() };
-    const result = walk(value, columns, patterns, null, stats, parseJsonStrings);
-    if (stats.fields > 0) {
-        log("info", `[redact] masked ${stats.fields} field(s) across column(s): ${[...stats.columns].join(", ")}`);
-    }
-    else {
-        log("info", "[redact] no PII fields detected");
-    }
-    return result;
-}
-const SHOW_COLUMNS_KEY = "field";
-const SHOW_INDEX_KEY = "column_name";
-function findKey(row, target) {
-    for (const key of Object.keys(row)) {
-        if (key.toLowerCase() === target)
-            return key;
-    }
-    return null;
-}
-export function filterIntrospectionRows(rows, kind, isPII) {
-    if (!Array.isArray(rows))
-        return null;
-    if (rows.length === 0)
-        return rows;
-    const keyName = kind === "show_index" ? SHOW_INDEX_KEY : SHOW_COLUMNS_KEY;
-    const sample = rows[0];
-    if (sample == null || typeof sample !== "object" || Array.isArray(sample)) {
-        return null;
-    }
-    const sampleKey = findKey(sample, keyName);
-    if (sampleKey === null)
-        return null;
-    let hidden = 0;
-    const out = rows.filter((row) => {
-        if (row == null || typeof row !== "object" || Array.isArray(row)) {
-            return true;
-        }
-        const obj = row;
-        const colKey = findKey(obj, keyName);
-        if (colKey === null)
-            return true;
-        const value = obj[colKey];
-        if (typeof value !== "string")
-            return true;
-        if (isPII(value)) {
-            hidden++;
-            return false;
-        }
-        return true;
-    });
-    if (hidden > 0) {
-        log("info", `[redact] filtered ${hidden} PII column(s) from ${kind} result`);
-    }
-    return out;
-}
-function walk(value, columns, patterns, parentMatch, stats, parseJsonStrings) {
-    if (value == null)
-        return value;
-    if (typeof value === "string") {
-        if (parentMatch !== null) {
-            stats.fields++;
-            return maskByColumn(value);
-        }
-        if (parseJsonStrings) {
-            const trimmed = value.trim();
-            if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
-                try {
-                    const parsed = JSON.parse(trimmed);
-                    if (typeof parsed === "object" && parsed !== null) {
-                        return JSON.stringify(walk(parsed, columns, patterns, null, stats, parseJsonStrings));
-                    }
-                }
-                catch {
-                }
-            }
-        }
-        return applyPatternMasks(value);
-    }
-    if (Array.isArray(value)) {
-        return value.map((item) => walk(item, columns, patterns, parentMatch, stats, parseJsonStrings));
-    }
-    if (typeof value === "object") {
-        if (value instanceof Date)
-            return value;
-        if (typeof Buffer !== "undefined" && Buffer.isBuffer(value))
-            return value;
-        const out = {};
-        for (const [key, child] of Object.entries(value)) {
-            const match = matchPIIColumn(key, columns, patterns);
-            if (match !== null) {
-                log("info", `[redact] column "${key}" matched PII rule: ${match}`);
-                stats.columns.add(key);
-            }
-            out[key] = walk(child, columns, patterns, match, stats, parseJsonStrings);
-        }
-        return out;
-    }
-    return value;
-}

package/dist/src/types/index.js

@@ -1 +0,0 @@
-export {};

package/dist/src/utils/index.js

@@ -1,123 +0,0 @@
-const ENABLE_LOGGING = process.env.ENABLE_LOGGING === "true" || process.env.ENABLE_LOGGING === "1";
-export function log(type = "info", ...args) {
-    if (!ENABLE_LOGGING)
-        return;
-    switch (type) {
-        case "info":
-            console.info(...args);
-            break;
-        case "error":
-            console.error(...args);
-            break;
-        default:
-            console.log(...args);
-    }
-}
-export function parseSchemaPermissions(permissionsString) {
-    const permissions = {};
-    if (!permissionsString) {
-        return permissions;
-    }
-    const permissionPairs = permissionsString.split(",");
-    for (const pair of permissionPairs) {
-        const [schema, value] = pair.split(":");
-        if (schema && value) {
-            permissions[schema.trim()] = value.trim() === "true";
-        }
-    }
-    return permissions;
-}
-export function parseMySQLConnectionString(connectionString) {
-    const config = {};
-    let cleanedString = connectionString.trim().replace(/^mysql\s+/, '');
-    const tokens = [];
-    let currentToken = '';
-    let inQuotes = false;
-    let quoteChar = null;
-    for (let i = 0; i < cleanedString.length; i++) {
-        const char = cleanedString[i];
-        if ((char === '"' || char === "'") && (!inQuotes || char === quoteChar)) {
-            inQuotes = !inQuotes;
-            quoteChar = inQuotes ? char : null;
-        }
-        else if (char === ' ' && !inQuotes) {
-            if (currentToken) {
-                tokens.push(currentToken);
-                currentToken = '';
-            }
-        }
-        else {
-            currentToken += char;
-        }
-    }
-    if (currentToken) {
-        tokens.push(currentToken);
-    }
-    for (let i = 0; i < tokens.length; i++) {
-        const token = tokens[i];
-        if (token.startsWith('-') && !token.startsWith('--')) {
-            const flag = token[1];
-            let value = token.substring(2);
-            if (!value && i + 1 < tokens.length && !tokens[i + 1].startsWith('-')) {
-                value = tokens[i + 1];
-                i++;
-            }
-            switch (flag) {
-                case 'h':
-                    config.host = value;
-                    break;
-                case 'P': {
-                    const port = parseInt(value, 10);
-                    if (Number.isNaN(port) || !Number.isFinite(port) || port < 1 || port > 65535) {
-                        throw new Error(`Invalid port: ${value}`);
-                    }
-                    config.port = port;
-                    break;
-                }
-                case 'u':
-                    config.user = value;
-                    break;
-                case 'p':
-                    config.password = value;
-                    break;
-                case 'S':
-                    config.socketPath = value;
-                    break;
-            }
-        }
-        else if (token.startsWith('--')) {
-            const [flag, ...valueParts] = token.substring(2).split('=');
-            let value = valueParts.join('=');
-            if (!value && i + 1 < tokens.length && !tokens[i + 1].startsWith('-')) {
-                value = tokens[i + 1];
-                i++;
-            }
-            switch (flag) {
-                case 'host':
-                    config.host = value;
-                    break;
-                case 'port': {
-                    const port = parseInt(value, 10);
-                    if (Number.isNaN(port) || !Number.isFinite(port) || port < 1 || port > 65535) {
-                        throw new Error(`Invalid port: ${value}`);
-                    }
-                    config.port = port;
-                    break;
-                }
-                case 'user':
-                    config.user = value;
-                    break;
-                case 'password':
-                    config.password = value;
-                    break;
-                case 'socket':
-                    config.socketPath = value;
-                    break;
-            }
-        }
-        else if (!token.startsWith('-')) {
-            config.database = token;
-        }
-    }
-    return config;
-}