mysql-db-mcp 0.1.0

package/dist/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { closePool } from "./db/MySqlPool.js";
+import { MySqlClient } from "./db/MySqlClient.js";
+import { logger } from "./logger.js";
+import { registerAlterTableAddColumnTool } from "./tools/alterTableAddColumn.js";
+import { registerAlterTableAddIndexTool } from "./tools/alterTableAddIndex.js";
+import { registerAlterTableDropColumnTool } from "./tools/alterTableDropColumn.js";
+import { registerAlterTableDropIndexTool } from "./tools/alterTableDropIndex.js";
+import { registerAlterTableModifyColumnTool } from "./tools/alterTableModifyColumn.js";
+import { registerAlterTableRenameColumnTool } from "./tools/alterTableRenameColumn.js";
+import { registerDescribeTableTool } from "./tools/describeTable.js";
+import { registerExplainSelectTool } from "./tools/explainSelect.js";
+import { registerInsertRowTool } from "./tools/insertRow.js";
+import { registerInsertRowsTool } from "./tools/insertRows.js";
+import { registerListSchemasTool } from "./tools/listSchemas.js";
+import { registerListTablesTool } from "./tools/listTables.js";
+import { registerQuerySelectTool } from "./tools/querySelect.js";
+const server = new McpServer({
+    name: "mysql-db-mcp",
+    version: "0.1.0"
+});
+const client = new MySqlClient();
+registerListSchemasTool(server, client);
+registerListTablesTool(server, client);
+registerDescribeTableTool(server, client);
+registerQuerySelectTool(server, client);
+registerExplainSelectTool(server, client);
+registerInsertRowTool(server, client);
+registerInsertRowsTool(server, client);
+registerAlterTableAddColumnTool(server, client);
+registerAlterTableModifyColumnTool(server, client);
+registerAlterTableDropColumnTool(server, client);
+registerAlterTableRenameColumnTool(server, client);
+registerAlterTableAddIndexTool(server, client);
+registerAlterTableDropIndexTool(server, client);
+async function shutdown(signal) {
+    logger.info("Shutting down mysql-db-mcp", { signal });
+    await closePool();
+    process.exit(0);
+}
+process.on("SIGINT", () => {
+    void shutdown("SIGINT");
+});
+process.on("SIGTERM", () => {
+    void shutdown("SIGTERM");
+});
+process.on("uncaughtException", (error) => {
+    logger.error("Uncaught exception", { message: error.message, stack: error.stack });
+    process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+    logger.error("Unhandled rejection", { reason });
+    process.exit(1);
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+logger.info("mysql-db-mcp started");
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;AAEjC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACtC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,+BAA+B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAChD,kCAAkC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnD,gCAAgC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,kCAAkC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnD,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/C,+BAA+B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,KAAK,UAAU,QAAQ,CAAC,MAAsB;IAC5C,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,EAAE,CAAC;IAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,6 @@
+export declare const logger: {
+    debug: (message: string, meta?: Record<string, unknown>) => void;
+    info: (message: string, meta?: Record<string, unknown>) => void;
+    warn: (message: string, meta?: Record<string, unknown>) => void;
+    error: (message: string, meta?: Record<string, unknown>) => void;
+};

package/dist/logger.js

@@ -0,0 +1,53 @@
+const levels = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40
+};
+function configuredLevel() {
+    const value = process.env.MYSQL_MCP_LOG_LEVEL?.toLowerCase();
+    if (value === "debug" || value === "info" || value === "warn" || value === "error") {
+        return value;
+    }
+    return "info";
+}
+function redact(value) {
+    if (typeof value === "string") {
+        return value.replace(/(password|pwd|token|secret)=([^&\s]+)/gi, "$1=<redacted>");
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => redact(item));
+    }
+    if (value && typeof value === "object") {
+        const result = {};
+        for (const [key, entry] of Object.entries(value)) {
+            if (/password|pwd|token|secret|connection|string|dsn|url/i.test(key)) {
+                result[key] = "<redacted>";
+            }
+            else {
+                result[key] = redact(entry);
+            }
+        }
+        return result;
+    }
+    return value;
+}
+function write(level, message, meta) {
+    if (levels[level] < levels[configuredLevel()]) {
+        return;
+    }
+    const line = {
+        time: new Date().toISOString(),
+        level,
+        message,
+        ...(meta ? { meta: redact(meta) } : {})
+    };
+    process.stderr.write(`${JSON.stringify(line)}\n`);
+}
+export const logger = {
+    debug: (message, meta) => write("debug", message, meta),
+    info: (message, meta) => write("info", message, meta),
+    warn: (message, meta) => write("warn", message, meta),
+    error: (message, meta) => write("error", message, meta)
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,SAAS,eAAe;IACtB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,WAAW,EAAE,CAAC;IAC7D,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACnF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,yCAAyC,EAAE,eAAe,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC5E,IAAI,sDAAsD,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrE,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;IAC7E,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC9B,KAAK;QACL,OAAO;QACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;IAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;IACzF,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;IACvF,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;IACvF,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;CAC1F,CAAC"}

package/dist/security.d.ts

@@ -0,0 +1,17 @@
+export type SafeSqlValue = string | number | boolean | null | Date;
+export declare function assertIdentifier(identifier: string, label?: string): void;
+export declare function quoteIdentifier(identifier: string): string;
+export declare function quoteQualifiedTable(schema: string, table: string): string;
+export declare function assertSchemaAllowedForWrite(schema: string): void;
+export declare function assertTableAllowedForWrite(table: string): void;
+export declare function assertSchemaAllowedForDDL(schema: string): void;
+export declare function assertTableAllowedForDDL(table: string): void;
+export declare function assertWriteEnabled(confirm?: boolean): void;
+export declare function assertDDLEnabled(confirm?: boolean, forceConfirm?: boolean): void;
+export declare function assertWriteTarget(schema: string, table: string): void;
+export declare function assertDDLTarget(schema: string, table: string): void;
+export declare function validateSqlValue(value: unknown, label?: string): SafeSqlValue;
+export declare function validateColumnType(columnType: string): string;
+export declare function validateComment(comment: string | undefined): string | undefined;
+export declare function assertSafeSelectSql(sql: string): void;
+export declare function assertSafeExplainSql(sql: string): void;

package/dist/security.js

@@ -0,0 +1,165 @@
+import { config } from "./config.js";
+const identifierPattern = /^[A-Za-z0-9_$]+$/;
+export function assertIdentifier(identifier, label = "identifier") {
+    if (identifier.length === 0 || identifier.length > 64 || !identifierPattern.test(identifier)) {
+        throw new Error(`${label} must contain only letters, numbers, underscores, and $.`);
+    }
+}
+export function quoteIdentifier(identifier) {
+    assertIdentifier(identifier);
+    return `\`${identifier}\``;
+}
+export function quoteQualifiedTable(schema, table) {
+    return `${quoteIdentifier(schema)}.${quoteIdentifier(table)}`;
+}
+function normalizeName(value) {
+    return value.toLowerCase();
+}
+function assertNotBlockedSchema(schema) {
+    assertIdentifier(schema, "schema");
+    const blocked = config.security.blockedSchemas.map(normalizeName);
+    if (blocked.includes(normalizeName(schema))) {
+        throw new Error(`schema '${schema}' is blocked.`);
+    }
+}
+function assertNotBlockedTable(table) {
+    assertIdentifier(table, "table");
+    const blocked = config.security.blockedTables.map(normalizeName);
+    if (blocked.includes(normalizeName(table))) {
+        throw new Error(`table '${table}' is blocked.`);
+    }
+}
+function assertAllowedByList(name, allowed, label) {
+    if (allowed.length === 0) {
+        return;
+    }
+    const normalizedAllowed = allowed.map(normalizeName);
+    if (!normalizedAllowed.includes(normalizeName(name))) {
+        throw new Error(`${label} '${name}' is not in the allowed list.`);
+    }
+}
+export function assertSchemaAllowedForWrite(schema) {
+    assertNotBlockedSchema(schema);
+    assertAllowedByList(schema, config.security.writeAllowedSchemas, "schema");
+}
+export function assertTableAllowedForWrite(table) {
+    assertNotBlockedTable(table);
+    assertAllowedByList(table, config.security.writeAllowedTables, "table");
+}
+export function assertSchemaAllowedForDDL(schema) {
+    assertNotBlockedSchema(schema);
+    assertAllowedByList(schema, config.security.ddlAllowedSchemas, "schema");
+}
+export function assertTableAllowedForDDL(table) {
+    assertNotBlockedTable(table);
+    assertAllowedByList(table, config.security.ddlAllowedTables, "table");
+}
+export function assertWriteEnabled(confirm) {
+    if (!config.security.enableWrite) {
+        throw new Error("Write tools are disabled. Set MYSQL_ENABLE_WRITE=true to enable them.");
+    }
+    if (config.security.requireConfirmation && confirm !== true) {
+        throw new Error("confirm: true is required for write tools.");
+    }
+}
+export function assertDDLEnabled(confirm, forceConfirm = false) {
+    if (!config.security.enableDDL) {
+        throw new Error("DDL tools are disabled. Set MYSQL_ENABLE_DDL=true to enable them.");
+    }
+    if ((forceConfirm || config.security.requireConfirmation) && confirm !== true) {
+        throw new Error("confirm: true is required for DDL tools.");
+    }
+}
+export function assertWriteTarget(schema, table) {
+    assertSchemaAllowedForWrite(schema);
+    assertTableAllowedForWrite(table);
+}
+export function assertDDLTarget(schema, table) {
+    assertSchemaAllowedForDDL(schema);
+    assertTableAllowedForDDL(table);
+}
+export function validateSqlValue(value, label = "value") {
+    if (value === undefined) {
+        throw new Error(`${label} cannot be undefined.`);
+    }
+    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value instanceof Date) {
+        if (typeof value === "number" && !Number.isFinite(value)) {
+            throw new Error(`${label} must be a finite number.`);
+        }
+        return value;
+    }
+    throw new Error(`${label} must be string, number, boolean, null, or Date.`);
+}
+export function validateColumnType(columnType) {
+    const normalized = columnType.trim().toUpperCase().replace(/\s+/g, "");
+    if (/^VARCHAR\((\d{1,5})\)$/.test(normalized) || /^CHAR\((\d{1,5})\)$/.test(normalized)) {
+        const size = Number(normalized.match(/\((\d+)\)/)?.[1]);
+        if (size >= 1 && size <= 65535) {
+            return normalized;
+        }
+        throw new Error("VARCHAR/CHAR length must be between 1 and 65535.");
+    }
+    if (/^DECIMAL\((\d{1,2}),(\d{1,2})\)$/.test(normalized)) {
+        const match = normalized.match(/^DECIMAL\((\d+),(\d+)\)$/);
+        const precision = Number(match?.[1]);
+        const scale = Number(match?.[2]);
+        if (precision >= 1 && precision <= 65 && scale >= 0 && scale <= 30 && scale <= precision) {
+            return normalized;
+        }
+        throw new Error("DECIMAL precision must be 1-65, scale must be 0-30, and scale must be <= precision.");
+    }
+    const allowedSimpleTypes = new Set([
+        "TEXT",
+        "MEDIUMTEXT",
+        "LONGTEXT",
+        "INT",
+        "INTEGER",
+        "BIGINT",
+        "SMALLINT",
+        "TINYINT",
+        "FLOAT",
+        "DOUBLE",
+        "DATE",
+        "DATETIME",
+        "TIMESTAMP",
+        "TIME",
+        "BOOLEAN",
+        "JSON"
+    ]);
+    if (allowedSimpleTypes.has(normalized)) {
+        return normalized;
+    }
+    throw new Error("columnType is not allowed.");
+}
+export function validateComment(comment) {
+    if (comment === undefined) {
+        return undefined;
+    }
+    if (comment.length > 255) {
+        throw new Error("comment must be at most 255 characters.");
+    }
+    return comment;
+}
+export function assertSafeSelectSql(sql) {
+    const trimmed = sql.trim();
+    if (trimmed.length === 0) {
+        throw new Error("sql is required.");
+    }
+    if (trimmed.includes(";")) {
+        throw new Error("Multiple statements and semicolons are not allowed.");
+    }
+    if (/\/\*|\*\/|--|#/u.test(trimmed)) {
+        throw new Error("SQL comments are not allowed.");
+    }
+    if (!/^(select|with)\b/i.test(trimmed)) {
+        throw new Error("Only SELECT queries are allowed.");
+    }
+    const blocked = /\b(insert|update|delete|alter|create|drop|truncate|replace|merge|call|exec|execute|grant|revoke|commit|rollback|start\s+transaction|begin|lock|unlock|handler|load\s+data|into\s+outfile|into\s+dumpfile)\b/i;
+    if (blocked.test(trimmed)) {
+        throw new Error("SQL contains a blocked keyword.");
+    }
+}
+export function assertSafeExplainSql(sql) {
+    assertSafeSelectSql(sql);
+}
+//# sourceMappingURL=security.js.map

package/dist/security.js.map

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

package/dist/tools/alterTableAddColumn.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MySqlClient } from "../db/MySqlClient.js";
+export declare function registerAlterTableAddColumnTool(server: McpServer, client: MySqlClient): void;

package/dist/tools/alterTableAddColumn.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { assertDDLEnabled, assertIdentifier, quoteIdentifier, validateColumnType } from "../security.js";
+import { assertAndQuoteDDLTarget, buildColumnDefinition, primitiveValueSchema, resolveSchema, runTool } from "./shared.js";
+export function registerAlterTableAddColumnTool(server, client) {
+    server.tool("alter_table_add_column", "Add a column to a table with a whitelisted MySQL column type. Disabled unless MYSQL_ENABLE_DDL=true.", {
+        schema: z.string().optional(),
+        table: z.string(),
+        columnName: z.string(),
+        columnType: z.string(),
+        nullable: z.boolean().optional(),
+        defaultValue: primitiveValueSchema.optional(),
+        comment: z.string().optional(),
+        afterColumn: z.string().optional(),
+        confirm: z.boolean().optional()
+    }, async (args) => runTool(async () => {
+        assertDDLEnabled(args.confirm);
+        const schemaName = resolveSchema(args.schema);
+        assertIdentifier(args.table, "table");
+        const tableSql = assertAndQuoteDDLTarget(schemaName, args.table);
+        const safeColumnType = validateColumnType(args.columnType);
+        const definition = buildColumnDefinition({
+            columnName: args.columnName,
+            columnType: safeColumnType,
+            nullable: args.nullable,
+            defaultValue: args.defaultValue,
+            hasDefaultValue: Object.prototype.hasOwnProperty.call(args, "defaultValue"),
+            comment: args.comment
+        });
+        const params = [...definition.params];
+        const pieces = [`ALTER TABLE ${tableSql}`, `ADD COLUMN ${definition.sql}`];
+        if (args.afterColumn !== undefined) {
+            assertIdentifier(args.afterColumn, "afterColumn");
+            if (!(await client.columnExists(schemaName, args.table, args.afterColumn))) {
+                throw new Error(`afterColumn '${args.afterColumn}' does not exist.`);
+            }
+            pieces.push(`AFTER ${quoteIdentifier(args.afterColumn)}`);
+        }
+        const executedSqlTemplate = pieces.join(" ");
+        const result = await client.execute(executedSqlTemplate, params);
+        return {
+            affectedRows: result.affectedRows,
+            schemaName,
+            tableName: args.table,
+            operation: "add_column",
+            executedSqlTemplate
+        };
+    }));
+}
+//# sourceMappingURL=alterTableAddColumn.js.map

package/dist/tools/alterTableAddColumn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alterTableAddColumn.js","sourceRoot":"","sources":["../../src/tools/alterTableAddColumn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzG,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3H,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,MAAmB;IACpF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,sGAAsG,EACtG;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAChC,YAAY,EAAE,oBAAoB,CAAC,QAAQ,EAAE;QAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAChC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,qBAAqB,CAAC;YACvC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,cAAc;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;YAC3E,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,cAAc,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;YAClD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;gBAC3E,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,WAAW,mBAAmB,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,SAAS,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QACjE,OAAO;YACL,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,SAAS,EAAE,YAAY;YACvB,mBAAmB;SACpB,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/tools/alterTableAddIndex.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MySqlClient } from "../db/MySqlClient.js";
+export declare function registerAlterTableAddIndexTool(server: McpServer, client: MySqlClient): void;

package/dist/tools/alterTableAddIndex.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { assertDDLEnabled, assertIdentifier, quoteIdentifier } from "../security.js";
+import { assertAndQuoteDDLTarget, resolveSchema, runTool } from "./shared.js";
+export function registerAlterTableAddIndexTool(server, client) {
+    server.tool("alter_table_add_index", "Add a normal or unique index to existing columns. Disabled unless MYSQL_ENABLE_DDL=true.", {
+        schema: z.string().optional(),
+        table: z.string(),
+        indexName: z.string(),
+        columns: z.array(z.string()),
+        unique: z.boolean().optional(),
+        confirm: z.boolean().optional()
+    }, async (args) => runTool(async () => {
+        assertDDLEnabled(args.confirm);
+        const schemaName = resolveSchema(args.schema);
+        assertIdentifier(args.table, "table");
+        assertIdentifier(args.indexName, "indexName");
+        if (args.indexName.toUpperCase() === "PRIMARY") {
+            throw new Error("Creating PRIMARY indexes is not allowed.");
+        }
+        if (args.columns.length === 0 || args.columns.length > 16) {
+            throw new Error("columns must contain 1 to 16 column names.");
+        }
+        for (const column of args.columns) {
+            assertIdentifier(column, "column");
+        }
+        const tableSql = assertAndQuoteDDLTarget(schemaName, args.table);
+        if (!(await client.columnsExist(schemaName, args.table, args.columns))) {
+            throw new Error("All index columns must exist.");
+        }
+        if (await client.indexExists(schemaName, args.table, args.indexName)) {
+            throw new Error(`index '${args.indexName}' already exists.`);
+        }
+        const indexKind = args.unique === true ? "ADD UNIQUE INDEX" : "ADD INDEX";
+        const columnSql = args.columns.map((column) => quoteIdentifier(column)).join(", ");
+        const executedSqlTemplate = `ALTER TABLE ${tableSql} ${indexKind} ${quoteIdentifier(args.indexName)} (${columnSql})`;
+        const result = await client.execute(executedSqlTemplate);
+        return {
+            affectedRows: result.affectedRows,
+            schemaName,
+            tableName: args.table,
+            operation: args.unique === true ? "add_unique_index" : "add_index",
+            executedSqlTemplate
+        };
+    }));
+}
+//# sourceMappingURL=alterTableAddIndex.js.map

package/dist/tools/alterTableAddIndex.js.map

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

package/dist/tools/alterTableDropColumn.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MySqlClient } from "../db/MySqlClient.js";
+export declare function registerAlterTableDropColumnTool(server: McpServer, client: MySqlClient): void;

package/dist/tools/alterTableDropColumn.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { assertDDLEnabled, assertIdentifier, quoteIdentifier } from "../security.js";
+import { assertAndQuoteDDLTarget, resolveSchema, runTool } from "./shared.js";
+export function registerAlterTableDropColumnTool(server, client) {
+    server.tool("alter_table_drop_column", "Drop a column. This high-risk DDL always requires confirm: true.", {
+        schema: z.string().optional(),
+        table: z.string(),
+        columnName: z.string(),
+        confirm: z.boolean()
+    }, async (args) => runTool(async () => {
+        assertDDLEnabled(args.confirm, true);
+        const schemaName = resolveSchema(args.schema);
+        assertIdentifier(args.table, "table");
+        assertIdentifier(args.columnName, "columnName");
+        const tableSql = assertAndQuoteDDLTarget(schemaName, args.table);
+        if (!(await client.columnExists(schemaName, args.table, args.columnName))) {
+            throw new Error(`column '${args.columnName}' does not exist.`);
+        }
+        if (await client.isPrimaryKeyColumn(schemaName, args.table, args.columnName)) {
+            throw new Error("Refusing to drop primary key columns.");
+        }
+        if (await client.isUniqueIndexColumn(schemaName, args.table, args.columnName)) {
+            throw new Error("Refusing to drop columns that participate in a unique index.");
+        }
+        const executedSqlTemplate = `ALTER TABLE ${tableSql} DROP COLUMN ${quoteIdentifier(args.columnName)}`;
+        const result = await client.execute(executedSqlTemplate);
+        return {
+            affectedRows: result.affectedRows,
+            schemaName,
+            tableName: args.table,
+            operation: "drop_column",
+            executedSqlTemplate
+        };
+    }));
+}
+//# sourceMappingURL=alterTableDropColumn.js.map

package/dist/tools/alterTableDropColumn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alterTableDropColumn.js","sourceRoot":"","sources":["../../src/tools/alterTableDropColumn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,UAAU,gCAAgC,CAAC,MAAiB,EAAE,MAAmB;IACrF,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,kEAAkE,EAClE;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,UAAU,mBAAmB,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,MAAM,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,MAAM,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,mBAAmB,GAAG,eAAe,QAAQ,gBAAgB,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACtG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACzD,OAAO;YACL,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,SAAS,EAAE,aAAa;YACxB,mBAAmB;SACpB,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/tools/alterTableDropIndex.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MySqlClient } from "../db/MySqlClient.js";
+export declare function registerAlterTableDropIndexTool(server: McpServer, client: MySqlClient): void;

package/dist/tools/alterTableDropIndex.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { assertDDLEnabled, assertIdentifier, quoteIdentifier } from "../security.js";
+import { assertAndQuoteDDLTarget, resolveSchema, runTool } from "./shared.js";
+export function registerAlterTableDropIndexTool(server, client) {
+    server.tool("alter_table_drop_index", "Drop a non-primary index. This high-risk DDL always requires confirm: true.", {
+        schema: z.string().optional(),
+        table: z.string(),
+        indexName: z.string(),
+        confirm: z.boolean()
+    }, async (args) => runTool(async () => {
+        assertDDLEnabled(args.confirm, true);
+        const schemaName = resolveSchema(args.schema);
+        assertIdentifier(args.table, "table");
+        assertIdentifier(args.indexName, "indexName");
+        if (args.indexName.toUpperCase() === "PRIMARY") {
+            throw new Error("Dropping PRIMARY is not allowed.");
+        }
+        const tableSql = assertAndQuoteDDLTarget(schemaName, args.table);
+        if (!(await client.indexExists(schemaName, args.table, args.indexName))) {
+            throw new Error(`index '${args.indexName}' does not exist.`);
+        }
+        const executedSqlTemplate = `ALTER TABLE ${tableSql} DROP INDEX ${quoteIdentifier(args.indexName)}`;
+        const result = await client.execute(executedSqlTemplate);
+        return {
+            affectedRows: result.affectedRows,
+            schemaName,
+            tableName: args.table,
+            operation: "drop_index",
+            executedSqlTemplate
+        };
+    }));
+}
+//# sourceMappingURL=alterTableDropIndex.js.map

package/dist/tools/alterTableDropIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alterTableDropIndex.js","sourceRoot":"","sources":["../../src/tools/alterTableDropIndex.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,MAAmB;IACpF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,6EAA6E,EAC7E;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,SAAS,mBAAmB,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,mBAAmB,GAAG,eAAe,QAAQ,eAAe,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACpG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACzD,OAAO;YACL,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,SAAS,EAAE,YAAY;YACvB,mBAAmB;SACpB,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/tools/alterTableModifyColumn.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MySqlClient } from "../db/MySqlClient.js";
+export declare function registerAlterTableModifyColumnTool(server: McpServer, client: MySqlClient): void;

package/dist/tools/alterTableModifyColumn.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { assertDDLEnabled, assertIdentifier, validateColumnType } from "../security.js";
+import { assertAndQuoteDDLTarget, buildColumnDefinition, primitiveValueSchema, resolveSchema, runTool } from "./shared.js";
+export function registerAlterTableModifyColumnTool(server, client) {
+    server.tool("alter_table_modify_column", "Modify a column type, nullability, default, and comment with controlled DDL. Disabled unless MYSQL_ENABLE_DDL=true.", {
+        schema: z.string().optional(),
+        table: z.string(),
+        columnName: z.string(),
+        columnType: z.string(),
+        nullable: z.boolean().optional(),
+        defaultValue: primitiveValueSchema.optional(),
+        comment: z.string().optional(),
+        confirm: z.boolean().optional()
+    }, async (args) => runTool(async () => {
+        assertDDLEnabled(args.confirm);
+        const schemaName = resolveSchema(args.schema);
+        assertIdentifier(args.table, "table");
+        assertIdentifier(args.columnName, "columnName");
+        const tableSql = assertAndQuoteDDLTarget(schemaName, args.table);
+        if (!(await client.columnExists(schemaName, args.table, args.columnName))) {
+            throw new Error(`column '${args.columnName}' does not exist.`);
+        }
+        if (await client.isPrimaryKeyColumn(schemaName, args.table, args.columnName)) {
+            throw new Error("Refusing to modify primary key columns.");
+        }
+        const safeColumnType = validateColumnType(args.columnType);
+        const definition = buildColumnDefinition({
+            columnName: args.columnName,
+            columnType: safeColumnType,
+            nullable: args.nullable,
+            defaultValue: args.defaultValue,
+            hasDefaultValue: Object.prototype.hasOwnProperty.call(args, "defaultValue"),
+            comment: args.comment
+        });
+        const executedSqlTemplate = `ALTER TABLE ${tableSql} MODIFY COLUMN ${definition.sql}`;
+        const result = await client.execute(executedSqlTemplate, definition.params);
+        return {
+            affectedRows: result.affectedRows,
+            schemaName,
+            tableName: args.table,
+            operation: "modify_column",
+            executedSqlTemplate
+        };
+    }));
+}
+//# sourceMappingURL=alterTableModifyColumn.js.map

package/dist/tools/alterTableModifyColumn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alterTableModifyColumn.js","sourceRoot":"","sources":["../../src/tools/alterTableModifyColumn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3H,MAAM,UAAU,kCAAkC,CAAC,MAAiB,EAAE,MAAmB;IACvF,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,qHAAqH,EACrH;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAChC,YAAY,EAAE,oBAAoB,CAAC,QAAQ,EAAE;QAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAChC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,UAAU,mBAAmB,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,MAAM,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,qBAAqB,CAAC;YACvC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,cAAc;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;YAC3E,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QACH,MAAM,mBAAmB,GAAG,eAAe,QAAQ,kBAAkB,UAAU,CAAC,GAAG,EAAE,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5E,OAAO;YACL,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,SAAS,EAAE,eAAe;YAC1B,mBAAmB;SACpB,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/tools/alterTableRenameColumn.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MySqlClient } from "../db/MySqlClient.js";
+export declare function registerAlterTableRenameColumnTool(server: McpServer, client: MySqlClient): void;