@rmwxxwmr/mcp-database-service 0.1.2

package/dist/db/sql/oracleClient.js

@@ -0,0 +1,203 @@
+import { ApplicationError, toApplicationError } from "../../core/errors.js";
+import { BaseSqlAdapter } from "./baseSqlAdapter.js";
+export class OracleAdapter extends BaseSqlAdapter {
+    oracleConfig;
+    connection = null;
+    constructor(oracleConfig, queryTimeoutMs) {
+        super(oracleConfig, queryTimeoutMs);
+        this.oracleConfig = oracleConfig;
+    }
+    async connect() {
+        try {
+            const oracledb = await loadOracleDb(this.oracleConfig);
+            const connectString = this.oracleConfig.connection.serviceName
+                ? `${this.oracleConfig.connection.host}:${this.oracleConfig.connection.port ?? 1521}/${this.oracleConfig.connection.serviceName}`
+                : `${this.oracleConfig.connection.host}:${this.oracleConfig.connection.port ?? 1521}:${this.oracleConfig.connection.sid}`;
+            this.connection = await oracledb.getConnection({
+                user: this.oracleConfig.connection.user,
+                password: this.oracleConfig.connection.password,
+                connectString
+            });
+        }
+        catch (error) {
+            throw toApplicationError(error, "CONNECTION_ERROR");
+        }
+    }
+    async close() {
+        if (!this.connection) {
+            return;
+        }
+        await this.connection.close();
+        this.connection = null;
+    }
+    async executeRaw(sql, params) {
+        if (!this.connection) {
+            throw new ApplicationError("CONNECTION_ERROR", "Oracle connection is not open");
+        }
+        const oracledb = await loadOracleDb(this.oracleConfig);
+        const result = await this.connection.execute(sql, params ?? [], {
+            outFormat: oracledb.OUT_FORMAT_OBJECT
+        });
+        return (result.rows ?? []);
+    }
+    async executeStatementRaw(sql, params) {
+        if (!this.connection) {
+            throw new ApplicationError("CONNECTION_ERROR", "Oracle connection is not open");
+        }
+        const result = await this.connection.execute(sql, params ?? []);
+        const affectedRows = typeof result === "object" && result !== null && "rowsAffected" in result
+            ? Number(result.rowsAffected ?? 0)
+            : null;
+        return { affectedRows };
+    }
+    async explainQueryRows(sql, params) {
+        await this.executeStatementRaw(`EXPLAIN PLAN FOR ${sql}`, params);
+        return this.executeRaw(`
+      SELECT plan_table_output AS planLine
+      FROM TABLE(DBMS_XPLAN.DISPLAY())
+    `);
+    }
+    async analyzeQueryRows(_sql, _params) {
+        throw new ApplicationError("NOT_SUPPORTED", "analyze_query is not supported for Oracle in the current implementation");
+    }
+    pingSql() {
+        return "SELECT 1 AS ok FROM dual";
+    }
+    listSchemasSql() {
+        return "SELECT username AS schema FROM all_users ORDER BY username";
+    }
+    listTablesSql(schema) {
+        return {
+            sql: `
+        SELECT owner AS schema_name, table_name AS name, 'TABLE' AS type
+        FROM all_tables
+        WHERE owner = COALESCE(:schema, SYS_CONTEXT('USERENV', 'CURRENT_SCHEMA'))
+        UNION ALL
+        SELECT owner AS schema_name, view_name AS name, 'VIEW' AS type
+        FROM all_views
+        WHERE owner = COALESCE(:schema, SYS_CONTEXT('USERENV', 'CURRENT_SCHEMA'))
+        ORDER BY name
+      `,
+            params: { schema: schema?.toUpperCase() ?? null }
+        };
+    }
+    describeTableSql(schema, table) {
+        return {
+            sql: `
+        SELECT
+          c.column_name AS name,
+          c.data_type AS datatype,
+          c.nullable AS nullable,
+          c.data_default AS defaultValue,
+          com.comments AS comment_text,
+          CASE
+            WHEN EXISTS (
+              SELECT 1
+              FROM all_constraints cons
+              JOIN all_cons_columns cols
+                ON cons.owner = cols.owner
+               AND cons.constraint_name = cols.constraint_name
+              WHERE cons.constraint_type = 'P'
+                AND cons.owner = c.owner
+                AND cons.table_name = c.table_name
+                AND cols.column_name = c.column_name
+            ) THEN 1 ELSE 0
+          END AS primary_key
+        FROM all_tab_columns c
+        LEFT JOIN all_col_comments com
+          ON com.owner = c.owner
+         AND com.table_name = c.table_name
+         AND com.column_name = c.column_name
+        WHERE c.owner = COALESCE(:schema, SYS_CONTEXT('USERENV', 'CURRENT_SCHEMA'))
+          AND c.table_name = :tableName
+        ORDER BY c.column_id
+      `,
+            params: {
+                schema: schema?.toUpperCase() ?? null,
+                tableName: table.toUpperCase()
+            }
+        };
+    }
+    listIndexesSql(schema, table) {
+        return {
+            sql: `
+        SELECT
+          idx.table_owner AS schema_name,
+          idx.table_name AS table_name,
+          idx.index_name AS index_name,
+          col.column_name AS column_name,
+          CASE WHEN idx.uniqueness = 'UNIQUE' THEN 1 ELSE 0 END AS is_unique,
+          col.column_position AS column_position,
+          col.descend AS sort_order,
+          idx.index_type AS index_type
+        FROM all_indexes idx
+        LEFT JOIN all_ind_columns col
+          ON idx.owner = col.index_owner
+         AND idx.index_name = col.index_name
+         AND idx.table_owner = col.table_owner
+         AND idx.table_name = col.table_name
+        WHERE idx.table_owner = COALESCE(:schema, SYS_CONTEXT('USERENV', 'CURRENT_SCHEMA'))
+          AND idx.table_name = :tableName
+        ORDER BY idx.index_name, col.column_position
+      `,
+            params: {
+                schema: schema?.toUpperCase() ?? null,
+                tableName: table.toUpperCase()
+            }
+        };
+    }
+    tableStatisticsSql(schema, table) {
+        return {
+            sql: `
+        SELECT
+          owner AS schema_name,
+          table_name AS table_name,
+          num_rows AS approximateRowCount,
+          blocks,
+          avg_row_len AS averageRowLength,
+          sample_size AS sampleSize,
+          last_analyzed AS lastAnalyzed,
+          temporary AS isTemporary,
+          partitioned AS isPartitioned
+        FROM all_tables
+        WHERE owner = COALESCE(:schema, SYS_CONTEXT('USERENV', 'CURRENT_SCHEMA'))
+          AND table_name = :tableName
+      `,
+            params: {
+                schema: schema?.toUpperCase() ?? null,
+                tableName: table.toUpperCase()
+            }
+        };
+    }
+}
+let initializedOracleClient = null;
+async function loadOracleDb(config) {
+    const module = await import("oracledb");
+    const oracledb = (module.default ?? module);
+    initializeOracleClientIfNeeded(oracledb, config);
+    return oracledb;
+}
+function initializeOracleClientIfNeeded(oracledb, config) {
+    const desiredMode = config.connection.clientMode ?? (config.connection.clientLibDir ? "thick" : "thin");
+    const desiredLibDir = config.connection.clientLibDir;
+    if (!initializedOracleClient) {
+        if (desiredMode === "thick") {
+            oracledb.initOracleClient?.({ libDir: desiredLibDir });
+        }
+        initializedOracleClient = {
+            mode: desiredMode,
+            clientLibDir: desiredLibDir
+        };
+        return;
+    }
+    if (initializedOracleClient.mode !== desiredMode) {
+        throw new ApplicationError("CONFIG_ERROR", `Oracle client mode conflict: already initialized as ${initializedOracleClient.mode}, requested ${desiredMode}`);
+    }
+    if (desiredMode === "thick" && initializedOracleClient.clientLibDir !== desiredLibDir) {
+        throw new ApplicationError("CONFIG_ERROR", "Oracle thick mode already initialized with a different clientLibDir", {
+            currentLibDir: initializedOracleClient.clientLibDir ?? null,
+            requestedLibDir: desiredLibDir ?? null
+        });
+    }
+}
+//# sourceMappingURL=oracleClient.js.map

package/dist/db/sql/oracleClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracleClient.js","sourceRoot":"","sources":["../../../src/db/sql/oracleClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,OAAO,aAAc,SAAQ,cAAc;IAGX;IAF5B,UAAU,GAAsG,IAAI,CAAC;IAE7H,YAAoC,YAAkC,EAAE,cAA6B;QACnG,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QADF,iBAAY,GAAZ,YAAY,CAAsB;IAEtE,CAAC;IAEe,KAAK,CAAC,OAAO;QAC3B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACvD,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW;gBAC5D,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW,EAAE;gBACjI,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YAE5H,IAAI,CAAC,UAAU,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC;gBAC7C,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI;gBACvC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ;gBAC/C,aAAa;aACd,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAEe,KAAK,CAAC,KAAK;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAEkB,KAAK,CAAC,UAAU,CACjC,GAAW,EACX,MAA4C;QAE5C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,+BAA+B,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,EAAE;YAC9D,SAAS,EAAE,QAAQ,CAAC,iBAAiB;SACtC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAA8B,CAAC;IAC1D,CAAC;IAEkB,KAAK,CAAC,mBAAmB,CAC1C,GAAW,EACX,MAA4C;QAE5C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,+BAA+B,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,YAAY,GAChB,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,cAAc,IAAI,MAAM;YACvE,CAAC,CAAC,MAAM,CAAE,MAAoC,CAAC,YAAY,IAAI,CAAC,CAAC;YACjE,CAAC,CAAC,IAAI,CAAC;QAEX,OAAO,EAAE,YAAY,EAAE,CAAC;IAC1B,CAAC;IAEkB,KAAK,CAAC,gBAAgB,CACvC,GAAW,EACX,MAA4C;QAE5C,MAAM,IAAI,CAAC,mBAAmB,CAAC,oBAAoB,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,UAAU,CAAC;;;KAGtB,CAAC,CAAC;IACL,CAAC;IAEkB,KAAK,CAAC,gBAAgB,CACvC,IAAY,EACZ,OAA6C;QAE7C,MAAM,IAAI,gBAAgB,CACxB,eAAe,EACf,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAEkB,OAAO;QACxB,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAEkB,cAAc;QAC/B,OAAO,4DAA4D,CAAC;IACtE,CAAC;IAEkB,aAAa,CAAC,MAAe;QAC9C,OAAO;YACL,GAAG,EAAE;;;;;;;;;OASJ;YACD,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE;SAClD,CAAC;IACJ,CAAC;IAEkB,gBAAgB,CACjC,MAA0B,EAC1B,KAAa;QAEb,OAAO;YACL,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BJ;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,IAAI;gBACrC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE;aAC/B;SACF,CAAC;IACJ,CAAC;IAEkB,cAAc,CAC/B,MAA0B,EAC1B,KAAa;QAEb,OAAO;YACL,GAAG,EAAE;;;;;;;;;;;;;;;;;;;OAmBJ;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,IAAI;gBACrC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE;aAC/B;SACF,CAAC;IACJ,CAAC;IAEkB,kBAAkB,CACnC,MAA0B,EAC1B,KAAa;QAEb,OAAO;YACL,GAAG,EAAE;;;;;;;;;;;;;;OAcJ;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,IAAI;gBACrC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE;aAC/B;SACF,CAAC;IACJ,CAAC;CACF;AAED,IAAI,uBAAuB,GAKhB,IAAI,CAAC;AAEhB,KAAK,UAAU,YAAY,CAAC,MAA4B;IAQtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAOzC,CAAC;IAEF,8BAA8B,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,8BAA8B,CACrC,QAEC,EACD,MAA4B;IAE5B,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxG,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC;IAErD,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC7B,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;YAC5B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,uBAAuB,GAAG;YACxB,IAAI,EAAE,WAAW;YACjB,YAAY,EAAE,aAAa;SAC5B,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,uBAAuB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACjD,MAAM,IAAI,gBAAgB,CACxB,cAAc,EACd,uDAAuD,uBAAuB,CAAC,IAAI,eAAe,WAAW,EAAE,CAChH,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,KAAK,OAAO,IAAI,uBAAuB,CAAC,YAAY,KAAK,aAAa,EAAE,CAAC;QACtF,MAAM,IAAI,gBAAgB,CACxB,cAAc,EACd,qEAAqE,EACrE;YACE,aAAa,EAAE,uBAAuB,CAAC,YAAY,IAAI,IAAI;YAC3D,eAAe,EAAE,aAAa,IAAI,IAAI;SACvC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/db/sql/postgresClient.d.ts

@@ -0,0 +1,33 @@
+import type { PostgresDatabaseConfig } from "../../config/configTypes.js";
+import { BaseSqlAdapter } from "./baseSqlAdapter.js";
+export declare class PostgresAdapter extends BaseSqlAdapter {
+    private readonly postgresConfig;
+    private client;
+    constructor(postgresConfig: PostgresDatabaseConfig, queryTimeoutMs: number | null);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    protected executeRaw(sql: string, params?: unknown[] | Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    protected executeStatementRaw(sql: string, params?: unknown[] | Record<string, unknown>): Promise<{
+        affectedRows: number | null;
+    }>;
+    protected explainQueryRows(sql: string, params?: unknown[] | Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    protected analyzeQueryRows(sql: string, params?: unknown[] | Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    protected pingSql(): string;
+    protected listSchemasSql(): string;
+    protected listTablesSql(schema?: string): {
+        sql: string;
+        params?: unknown[];
+    };
+    protected describeTableSql(schema: string | undefined, table: string): {
+        sql: string;
+        params?: unknown[];
+    };
+    protected listIndexesSql(schema: string | undefined, table: string): {
+        sql: string;
+        params?: unknown[];
+    };
+    protected tableStatisticsSql(schema: string | undefined, table: string): {
+        sql: string;
+        params?: unknown[];
+    };
+}

package/dist/db/sql/postgresClient.js

@@ -0,0 +1,160 @@
+import { ApplicationError, toApplicationError } from "../../core/errors.js";
+import { BaseSqlAdapter } from "./baseSqlAdapter.js";
+export class PostgresAdapter extends BaseSqlAdapter {
+    postgresConfig;
+    client = null;
+    constructor(postgresConfig, queryTimeoutMs) {
+        super(postgresConfig, queryTimeoutMs);
+        this.postgresConfig = postgresConfig;
+    }
+    async connect() {
+        try {
+            const { Client: PgClient } = await import("pg");
+            this.client = new PgClient({
+                host: this.postgresConfig.connection.host,
+                port: this.postgresConfig.connection.port ?? 5432,
+                database: this.postgresConfig.connection.databaseName,
+                user: this.postgresConfig.connection.user,
+                password: this.postgresConfig.connection.password,
+                connectionTimeoutMillis: this.postgresConfig.connection.connectTimeoutMs,
+                ssl: this.postgresConfig.connection.ssl
+            });
+            await this.client.connect();
+            if (this.postgresConfig.readonly) {
+                await this.client.query("SET SESSION CHARACTERISTICS AS TRANSACTION READ ONLY");
+            }
+            if (this.queryTimeoutMs) {
+                await this.client.query(`SET statement_timeout = ${this.queryTimeoutMs}`);
+            }
+        }
+        catch (error) {
+            throw toApplicationError(error, "CONNECTION_ERROR");
+        }
+    }
+    async close() {
+        if (!this.client) {
+            return;
+        }
+        await this.client.end();
+        this.client = null;
+    }
+    async executeRaw(sql, params) {
+        if (!this.client) {
+            throw new ApplicationError("CONNECTION_ERROR", "PostgreSQL connection is not open");
+        }
+        const result = await this.client.query(sql, Array.isArray(params) ? params : []);
+        return result.rows;
+    }
+    async executeStatementRaw(sql, params) {
+        if (!this.client) {
+            throw new ApplicationError("CONNECTION_ERROR", "PostgreSQL connection is not open");
+        }
+        const result = await this.client.query(sql, Array.isArray(params) ? params : []);
+        return {
+            affectedRows: typeof result.rowCount === "number" ? result.rowCount : null
+        };
+    }
+    async explainQueryRows(sql, params) {
+        return this.executeRaw(`EXPLAIN ${sql}`, params);
+    }
+    async analyzeQueryRows(sql, params) {
+        return this.executeRaw(`EXPLAIN (ANALYZE, BUFFERS, VERBOSE) ${sql}`, params);
+    }
+    pingSql() {
+        return "SELECT 1 AS ok";
+    }
+    listSchemasSql() {
+        return `
+      SELECT schema_name AS schema
+      FROM information_schema.schemata
+      WHERE schema_name NOT IN ('information_schema', 'pg_catalog')
+      ORDER BY schema_name
+    `;
+    }
+    listTablesSql(schema) {
+        return {
+            sql: `
+        SELECT table_schema AS schema, table_name AS name, table_type AS type
+        FROM information_schema.tables
+        WHERE table_schema = COALESCE($1, current_schema())
+        ORDER BY table_name
+      `,
+            params: [schema ?? null]
+        };
+    }
+    describeTableSql(schema, table) {
+        return {
+            sql: `
+        SELECT
+          c.column_name AS name,
+          c.data_type AS dataType,
+          c.is_nullable AS nullable,
+          c.column_default AS defaultValue,
+          pgd.description AS comment,
+          EXISTS (
+            SELECT 1
+            FROM information_schema.table_constraints tc
+            JOIN information_schema.key_column_usage kcu
+              ON tc.constraint_name = kcu.constraint_name
+             AND tc.table_schema = kcu.table_schema
+            WHERE tc.constraint_type = 'PRIMARY KEY'
+              AND tc.table_schema = c.table_schema
+              AND tc.table_name = c.table_name
+              AND kcu.column_name = c.column_name
+          ) AS primaryKey
+        FROM information_schema.columns c
+        LEFT JOIN pg_catalog.pg_statio_all_tables st
+          ON st.relname = c.table_name
+         AND st.schemaname = c.table_schema
+        LEFT JOIN pg_catalog.pg_description pgd
+          ON pgd.objoid = st.relid
+         AND pgd.objsubid = c.ordinal_position
+        WHERE c.table_schema = COALESCE($1, current_schema())
+          AND c.table_name = $2
+        ORDER BY c.ordinal_position
+      `,
+            params: [schema ?? null, table]
+        };
+    }
+    listIndexesSql(schema, table) {
+        return {
+            sql: `
+        SELECT
+          schemaname AS schema_name,
+          tablename AS table_name,
+          indexname AS index_name,
+          indexdef AS definition
+        FROM pg_indexes
+        WHERE schemaname = COALESCE($1, current_schema())
+          AND tablename = $2
+        ORDER BY indexname
+      `,
+            params: [schema ?? null, table]
+        };
+    }
+    tableStatisticsSql(schema, table) {
+        return {
+            sql: `
+        SELECT
+          schemaname AS schema_name,
+          relname AS table_name,
+          n_live_tup AS approximateRowCount,
+          n_dead_tup AS deadRowCount,
+          seq_scan AS sequentialScans,
+          idx_scan AS indexScans,
+          pg_total_relation_size(relid) AS totalBytes,
+          pg_relation_size(relid) AS tableBytes,
+          pg_indexes_size(relid) AS indexBytes,
+          last_analyze AS lastAnalyze,
+          last_autoanalyze AS lastAutoAnalyze,
+          last_vacuum AS lastVacuum,
+          last_autovacuum AS lastAutoVacuum
+        FROM pg_stat_user_tables
+        WHERE schemaname = COALESCE($1, current_schema())
+          AND relname = $2
+      `,
+            params: [schema ?? null, table]
+        };
+    }
+}
+//# sourceMappingURL=postgresClient.js.map

package/dist/db/sql/postgresClient.js.map

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

package/dist/db/types.d.ts

@@ -0,0 +1,24 @@
+import type { DatabaseConfig } from "../config/configTypes.js";
+import type { ColumnInfo, IndexInfo, PingResult, QueryResult, RedisScanResult, SchemaInfo, StatementResult, TableStatistics, TableInfo } from "../core/resultTypes.js";
+export interface DatabaseAdapter {
+    readonly config: DatabaseConfig;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    ping(): Promise<PingResult>;
+}
+export interface SqlDatabaseAdapter extends DatabaseAdapter {
+    listSchemas(): Promise<SchemaInfo[]>;
+    listTables(schema?: string): Promise<TableInfo[]>;
+    describeTable(schema: string | undefined, table: string): Promise<ColumnInfo[]>;
+    listIndexes(schema: string | undefined, table: string): Promise<IndexInfo[]>;
+    getTableStatistics(schema: string | undefined, table: string): Promise<TableStatistics | null>;
+    explainQuery(sql: string, params: unknown[] | undefined, maxRows: number): Promise<QueryResult>;
+    analyzeQuery(sql: string, params: unknown[] | undefined, maxRows: number): Promise<QueryResult>;
+    executeQuery(sql: string, params: unknown[] | undefined, maxRows: number): Promise<QueryResult>;
+    executeStatement(sql: string, params?: unknown[]): Promise<StatementResult>;
+}
+export interface RedisDatabaseAdapter extends DatabaseAdapter {
+    get(key: string): Promise<string | null>;
+    hgetall(key: string): Promise<Record<string, string>>;
+    scan(cursor: string, pattern: string | undefined, count: number): Promise<RedisScanResult>;
+}

package/dist/db/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/db/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/db/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { loadConfig } from "./config/loadConfig.js";
+import { log } from "./core/logger.js";
+import { createServer } from "./server/createServer.js";
+/**
+ * Main entrypoint: load validated config, start the MCP server, and leave all
+ * actual database work to per-request lazy adapters.
+ */
+async function main() {
+    const config = await loadConfig(process.argv.slice(2), process.env);
+    await createServer(config);
+    log("info", "MCP database server started", {
+        databaseCount: config.databases.length
+    });
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    log("error", "Failed to start MCP database server", { message });
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/server/createServer.d.ts

@@ -0,0 +1,46 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { LoadedConfig } from "../config/configTypes.js";
+interface PendingStatementConfirmation {
+    databaseKey: string;
+    sql: string;
+    params?: unknown[];
+    expiresAt: number;
+}
+interface StatementConfirmationInput {
+    databaseKey: string;
+    sql: string;
+    params?: unknown[];
+    confirmationId?: string;
+    confirmExecution?: boolean;
+}
+interface StatementConfirmationContext {
+    database: LoadedConfig["databases"][number];
+    input: StatementConfirmationInput;
+    pendingConfirmations: Map<string, PendingStatementConfirmation>;
+    supportsInteractiveConfirmation: boolean;
+    elicitConfirmation?: (message: string) => Promise<boolean>;
+    now?: () => number;
+    createId?: () => string;
+    maxPendingConfirmations?: number;
+}
+type StatementConfirmationResult = {
+    status: "confirmed";
+} | {
+    status: "pending";
+    confirmationId: string;
+    confirmationMode: "two_step";
+    message: string;
+    statement: string;
+    targetObject: string;
+    riskLevel: "normal" | "high" | "critical";
+    riskDetails: string;
+    sqlPreview: string;
+    paramsPreview: string;
+};
+/**
+ * The MCP layer is intentionally thin: validate input, route to the correct
+ * adapter, and return normalized JSON text for clients.
+ */
+export declare function createServer(config: LoadedConfig): Promise<Server>;
+export declare function confirmStatementExecutionWithFallback(context: StatementConfirmationContext): Promise<StatementConfirmationResult>;
+export {};