@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/resources/vector.js

@@ -0,0 +1,185 @@
+/**
+ * pgvector Status Resource
+ *
+ * Provides pgvector extension status, vector columns, and index information.
+ */
+import { LOW_PRIORITY } from "../../../utils/resourceAnnotations.js";
+/** Safely convert unknown value to string */
+function toStr(value) {
+    return typeof value === "string" ? value : "";
+}
+export function createVectorResource(adapter) {
+    return {
+        uri: "postgres://vector",
+        name: "pgvector Status",
+        description: "pgvector extension status, vector columns, index types, and performance recommendations",
+        mimeType: "application/json",
+        annotations: LOW_PRIORITY,
+        handler: async () => {
+            const result = {
+                extensionInstalled: false,
+                extensionVersion: null,
+                vectorColumns: [],
+                columnCount: 0,
+                indexes: [],
+                indexCount: 0,
+                hnswIndexCount: 0,
+                ivfflatIndexCount: 0,
+                unindexedColumns: [],
+                recommendations: [],
+            };
+            // Check if pgvector is installed (outside try-catch for correct error messaging)
+            const extCheck = await adapter.executeQuery(`SELECT extversion FROM pg_extension WHERE extname = 'vector'`);
+            if (!extCheck.rows || extCheck.rows.length === 0) {
+                result.recommendations.push("pgvector extension is not installed. Use pg_vector_create_extension to enable vector similarity search.");
+                return JSON.stringify(result, null, 2);
+            }
+            result.extensionInstalled = true;
+            const extVersion = extCheck.rows[0]?.["extversion"];
+            result.extensionVersion =
+                typeof extVersion === "string" ? extVersion : null;
+            try {
+                // Get all vector columns
+                const columnsResult = await adapter.executeQuery(`SELECT 
+                        n.nspname as schema_name,
+                        c.relname as table_name,
+                        a.attname as column_name,
+                        COALESCE(
+                            (regexp_match(format_type(a.atttypid, a.atttypmod), 'vector\\((\\d+)\\)'))[1]::int,
+                            0
+                        ) as dimensions,
+                        COALESCE(s.n_live_tup, 0)::int as row_count
+                     FROM pg_attribute a
+                     JOIN pg_class c ON a.attrelid = c.oid
+                     JOIN pg_namespace n ON c.relnamespace = n.oid
+                     LEFT JOIN pg_stat_user_tables s ON s.relid = c.oid
+                     WHERE format_type(a.atttypid, a.atttypmod) LIKE 'vector%'
+                       AND n.nspname NOT IN ('pg_catalog', 'information_schema')
+                       AND a.attnum > 0
+                       AND NOT a.attisdropped
+                     ORDER BY n.nspname, c.relname, a.attname`);
+                if (columnsResult.rows) {
+                    for (const row of columnsResult.rows) {
+                        result.vectorColumns.push({
+                            schema: toStr(row["schema_name"]),
+                            table: toStr(row["table_name"]),
+                            column: toStr(row["column_name"]),
+                            dimensions: Number(row["dimensions"] ?? 0),
+                            rowCount: Number(row["row_count"] ?? 0),
+                        });
+                    }
+                }
+                result.columnCount = result.vectorColumns.length;
+                // Get vector indexes
+                const indexResult = await adapter.executeQuery(`SELECT 
+                        n.nspname as schema_name,
+                        t.relname as table_name,
+                        i.relname as index_name,
+                        am.amname as index_type,
+                        a.attname as column_name,
+                        pg_size_pretty(pg_relation_size(i.oid)) as index_size,
+                        pg_get_indexdef(idx.indexrelid) as options
+                     FROM pg_index idx
+                     JOIN pg_class i ON idx.indexrelid = i.oid
+                     JOIN pg_class t ON idx.indrelid = t.oid
+                     JOIN pg_namespace n ON t.relnamespace = n.oid
+                     JOIN pg_am am ON i.relam = am.oid
+                     JOIN pg_attribute a ON a.attrelid = t.oid AND a.attnum = ANY(idx.indkey)
+                     WHERE am.amname IN ('hnsw', 'ivfflat')
+                       AND n.nspname NOT IN ('pg_catalog', 'information_schema')
+                     ORDER BY n.nspname, t.relname, i.relname`);
+                if (indexResult.rows) {
+                    for (const row of indexResult.rows) {
+                        const options = row["options"];
+                        result.indexes.push({
+                            schema: toStr(row["schema_name"]),
+                            table: toStr(row["table_name"]),
+                            indexName: toStr(row["index_name"]),
+                            indexType: toStr(row["index_type"]),
+                            column: toStr(row["column_name"]),
+                            size: toStr(row["index_size"]) || "0 bytes",
+                            options: typeof options === "string" ? options : null,
+                        });
+                    }
+                }
+                result.indexCount = result.indexes.length;
+                result.hnswIndexCount = result.indexes.filter((i) => i.indexType === "hnsw").length;
+                result.ivfflatIndexCount = result.indexes.filter((i) => i.indexType === "ivfflat").length;
+                // Find unindexed vector columns and generate actionable SQL
+                // Skip small tables where indexes provide minimal benefit
+                const SMALL_TABLE_THRESHOLD = 1000;
+                const indexedColumns = new Set(result.indexes.map((i) => `${i.schema}.${i.table}.${i.column}`));
+                // Get existing index names to avoid conflicts
+                const existingIndexResult = await adapter.executeQuery(`
+                    SELECT indexname FROM pg_indexes WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
+                `);
+                const existingIndexNames = new Set((existingIndexResult.rows ?? []).map((r) => r["indexname"]));
+                const unindexedCols = result.vectorColumns.filter((c) => !indexedColumns.has(`${c.schema}.${c.table}.${c.column}`) &&
+                    c.rowCount >= SMALL_TABLE_THRESHOLD);
+                const smallTableCount = result.vectorColumns.filter((c) => !indexedColumns.has(`${c.schema}.${c.table}.${c.column}`) &&
+                    c.rowCount < SMALL_TABLE_THRESHOLD).length;
+                result.unindexedColumns = unindexedCols.map((c) => {
+                    // Generate unique index names
+                    let hnswName = `idx_${c.table}_${c.column}_hnsw`;
+                    let ivfflatName = `idx_${c.table}_${c.column}_ivfflat`;
+                    // Add suffix if name already exists
+                    let suffix = 1;
+                    while (existingIndexNames.has(hnswName)) {
+                        hnswName = `idx_${c.table}_${c.column}_hnsw_${String(suffix)}`;
+                        suffix++;
+                    }
+                    suffix = 1;
+                    while (existingIndexNames.has(ivfflatName)) {
+                        ivfflatName = `idx_${c.table}_${c.column}_ivfflat_${String(suffix)}`;
+                        suffix++;
+                    }
+                    return {
+                        column: `${c.schema}.${c.table}.${c.column}`,
+                        suggestedHnswSql: `CREATE INDEX IF NOT EXISTS "${hnswName}" ON "${c.schema}"."${c.table}" USING hnsw ("${c.column}" vector_cosine_ops);`,
+                        suggestedIvfflatSql: `CREATE INDEX IF NOT EXISTS "${ivfflatName}" ON "${c.schema}"."${c.table}" USING ivfflat ("${c.column}" vector_l2_ops) WITH (lists = 100);`,
+                    };
+                });
+                // Generate recommendations
+                if (result.columnCount === 0) {
+                    result.recommendations.push("No vector columns found. Use pg_vector_add_column to add vector columns to tables.");
+                }
+                if (result.unindexedColumns.length > 0) {
+                    const columnNames = result.unindexedColumns
+                        .slice(0, 3)
+                        .map((c) => c.column)
+                        .join(", ");
+                    result.recommendations.push(`${String(result.unindexedColumns.length)} vector column(s) on larger tables without indexes: ${columnNames}${result.unindexedColumns.length > 3 ? "..." : ""}. See unindexedColumns for ready-to-use CREATE INDEX SQL.`);
+                }
+                // Note about small tables that were skipped
+                if (smallTableCount > 0 && result.unindexedColumns.length === 0) {
+                    result.recommendations.push(`${String(smallTableCount)} unindexed vector column(s) on small tables (<${String(SMALL_TABLE_THRESHOLD)} rows). Indexes optional for small tables.`);
+                }
+                for (const col of result.vectorColumns) {
+                    const isUnindexed = result.unindexedColumns.some((u) => u.column === `${col.schema}.${col.table}.${col.column}`);
+                    if (col.rowCount > 100000 && isUnindexed) {
+                        result.recommendations.push(`Large unindexed vector column: ${col.table}.${col.column} (${String(col.rowCount)} rows). HNSW index strongly recommended.`);
+                    }
+                }
+                if (result.ivfflatIndexCount > 0 && result.hnswIndexCount === 0) {
+                    result.recommendations.push("Using IVFFlat indexes only. Consider HNSW for better query performance (higher build cost).");
+                }
+                // Add index type guidance
+                result.indexTypeGuidance = {
+                    hnsw: "HNSW (Hierarchical Navigating Small Worlds): Higher recall, faster queries. Best for most use cases. Higher memory and build time. Recommended for production.",
+                    ivfflat: 'IVFFlat (Inverted File with Flat compression): Faster to build, lower memory. Requires tuning "lists" parameter (sqrt(rows) recommended). Better for prototyping or resource-constrained environments.',
+                    recommendation: result.indexCount === 0
+                        ? "Start with HNSW for best query performance. Use IVFFlat if build time or memory is a constraint."
+                        : result.hnswIndexCount > 0 && result.ivfflatIndexCount === 0
+                            ? "Using HNSW indexes - optimal for query performance."
+                            : "Mixed index types detected. Consider migrating IVFFlat to HNSW for consistent performance.",
+                };
+            }
+            catch {
+                // Extension is installed but data queries failed
+                result.recommendations.push("Error querying pgvector data. Check permissions on vector columns and indexes.");
+            }
+            return JSON.stringify(result, null, 2);
+        },
+    };
+}
+//# sourceMappingURL=vector.js.map

package/dist/adapters/postgresql/resources/vector.js.map

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

package/dist/adapters/postgresql/schemas/admin.d.ts

@@ -0,0 +1,74 @@
+/**
+ * postgres-mcp - Admin Tool Schemas
+ *
+ * Input validation schemas for database administration operations.
+ *
+ * DUAL-SCHEMA PATTERN:
+ * Base schemas (*SchemaBase) are exported for MCP visibility (shows parameters).
+ * Preprocess schemas (*Schema) are used by handlers for validation + alias resolution.
+ */
+import { z } from "zod";
+export declare const VacuumSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    full: z.ZodOptional<z.ZodBoolean>;
+    analyze: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const VacuumSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    full: z.ZodOptional<z.ZodBoolean>;
+    analyze: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>;
+export declare const AnalyzeSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const AnalyzeSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+export declare const ReindexSchemaBase: z.ZodObject<{
+    target: z.ZodEnum<{
+        table: "table";
+        schema: "schema";
+        database: "database";
+        index: "index";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    indexName: z.ZodOptional<z.ZodString>;
+    concurrently: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const ReindexSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    target: z.ZodEnum<{
+        table: "table";
+        schema: "schema";
+        database: "database";
+        index: "index";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    concurrently: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>;
+export declare const TerminateBackendSchemaBase: z.ZodObject<{
+    pid: z.ZodOptional<z.ZodNumber>;
+    processId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const TerminateBackendSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    pid: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const CancelBackendSchemaBase: z.ZodObject<{
+    pid: z.ZodOptional<z.ZodNumber>;
+    processId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const CancelBackendSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    pid: z.ZodNumber;
+}, z.core.$strip>>;
+//# sourceMappingURL=admin.d.ts.map

package/dist/adapters/postgresql/schemas/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/schemas/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuCxB,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAGH,eAAO,MAAM,YAAY;;;;;;kBASxB,CAAC;AAIF,eAAO,MAAM,iBAAiB;;;;;iBAQ5B,CAAC;AAGH,eAAO,MAAM,aAAa;;;;kBAUzB,CAAC;AA4BF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;iBAoB5B,CAAC;AAGH,eAAO,MAAM,aAAa;;;;;;;;;kBA4BvB,CAAC;AAoBJ,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAGH,eAAO,MAAM,sBAAsB;;kBAKlC,CAAC;AAGF,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAGH,eAAO,MAAM,mBAAmB;;kBAK/B,CAAC"}

package/dist/adapters/postgresql/schemas/admin.js

@@ -0,0 +1,180 @@
+/**
+ * postgres-mcp - Admin Tool Schemas
+ *
+ * Input validation schemas for database administration operations.
+ *
+ * DUAL-SCHEMA PATTERN:
+ * Base schemas (*SchemaBase) are exported for MCP visibility (shows parameters).
+ * Preprocess schemas (*Schema) are used by handlers for validation + alias resolution.
+ */
+import { z } from "zod";
+/**
+ * Preprocess vacuum/analyze parameters:
+ * - Alias: tableName → table
+ * - Parse schema.table format (e.g., 'public.users' → { schema: 'public', table: 'users' })
+ */
+function preprocessTableParams(input) {
+    if (input === null || input === undefined) {
+        return {};
+    }
+    if (typeof input !== "object") {
+        return input;
+    }
+    const result = { ...input };
+    // Alias: tableName → table
+    if (result["tableName"] !== undefined && result["table"] === undefined) {
+        result["table"] = result["tableName"];
+    }
+    // Parse schema.table format
+    const tableVal = result["table"];
+    if (typeof tableVal === "string" && tableVal.includes(".")) {
+        const parts = tableVal.split(".");
+        if (parts.length === 2 && parts[0] !== "" && parts[1] !== "") {
+            // Only override schema if not explicitly provided
+            if (result["schema"] === undefined) {
+                result["schema"] = parts[0];
+            }
+            result["table"] = parts[1];
+        }
+    }
+    return result;
+}
+// ============== VACUUM SCHEMA ==============
+// Base schema for MCP visibility
+export const VacuumSchemaBase = z.object({
+    table: z.string().optional().describe("Table name (all tables if omitted)"),
+    tableName: z.string().optional().describe("Alias for table"),
+    schema: z.string().optional().describe("Schema name"),
+    full: z.boolean().optional().describe("Full vacuum (rewrites table)"),
+    analyze: z.boolean().optional().describe("Update statistics"),
+    verbose: z.boolean().optional().describe("Print progress"),
+});
+// Preprocess schema for handlers (resolves aliases and parses schema.table)
+export const VacuumSchema = z.preprocess(preprocessTableParams, z.object({
+    table: z.string().optional().describe("Table name (all tables if omitted)"),
+    schema: z.string().optional().describe("Schema name"),
+    full: z.boolean().optional().describe("Full vacuum (rewrites table)"),
+    analyze: z.boolean().optional().describe("Update statistics"),
+    verbose: z.boolean().optional().describe("Print progress"),
+}));
+// ============== ANALYZE SCHEMA ==============
+// Base schema for MCP visibility
+export const AnalyzeSchemaBase = z.object({
+    table: z.string().optional().describe("Table name (all tables if omitted)"),
+    tableName: z.string().optional().describe("Alias for table"),
+    schema: z.string().optional().describe("Schema name"),
+    columns: z
+        .array(z.string())
+        .optional()
+        .describe("Specific columns to analyze"),
+});
+// Preprocess schema for handlers (resolves aliases and parses schema.table)
+export const AnalyzeSchema = z.preprocess(preprocessTableParams, z.object({
+    table: z.string().optional().describe("Table name (all tables if omitted)"),
+    schema: z.string().optional().describe("Schema name"),
+    columns: z
+        .array(z.string())
+        .optional()
+        .describe("Specific columns to analyze"),
+}));
+// ============== REINDEX SCHEMA ==============
+/**
+ * Preprocess reindex parameters:
+ * - Alias: tableName/table/indexName → name
+ */
+function preprocessReindexParams(input) {
+    if (typeof input !== "object" || input === null) {
+        return input;
+    }
+    const result = { ...input };
+    // Alias: tableName → name
+    if (result["tableName"] !== undefined && result["name"] === undefined) {
+        result["name"] = result["tableName"];
+    }
+    // Alias: table → name (when target is 'table')
+    if (result["table"] !== undefined && result["name"] === undefined) {
+        result["name"] = result["table"];
+    }
+    // Alias: indexName → name (when target is 'index')
+    if (result["indexName"] !== undefined && result["name"] === undefined) {
+        result["name"] = result["indexName"];
+    }
+    return result;
+}
+// Base schema for MCP visibility (shows all parameters including aliases)
+export const ReindexSchemaBase = z.object({
+    target: z
+        .enum(["table", "index", "schema", "database"])
+        .describe("What to reindex"),
+    name: z
+        .string()
+        .optional()
+        .describe("Name of table/index/schema (defaults to current database when target is database)"),
+    table: z
+        .string()
+        .optional()
+        .describe("Alias for name (when target is table)"),
+    tableName: z.string().optional().describe("Alias for name"),
+    indexName: z
+        .string()
+        .optional()
+        .describe("Alias for name (when target is index)"),
+    concurrently: z.boolean().optional().describe("Reindex concurrently"),
+});
+// Preprocess schema for handlers (resolves aliases, name is now optional for database target)
+export const ReindexSchema = z
+    .preprocess(preprocessReindexParams, z.object({
+    target: z
+        .enum(["table", "index", "schema", "database"])
+        .describe("What to reindex"),
+    name: z
+        .string()
+        .optional()
+        .describe("Name of table/index/schema (defaults to current database when target is database)"),
+    concurrently: z.boolean().optional().describe("Reindex concurrently"),
+}))
+    .refine((data) => {
+    // name is required for table, index, and schema targets
+    const parsed = data;
+    if (parsed.target !== "database" && parsed.name === undefined) {
+        return false;
+    }
+    return true;
+}, {
+    message: "name is required when target is table, index, or schema",
+});
+// ============== TERMINATE/CANCEL BACKEND SCHEMAS ==============
+/**
+ * Preprocess backend PID parameters:
+ * - Alias: processId → pid
+ */
+function preprocessPidParams(input) {
+    if (typeof input !== "object" || input === null) {
+        return input;
+    }
+    const result = { ...input };
+    // Alias: processId → pid
+    if (result["processId"] !== undefined && result["pid"] === undefined) {
+        result["pid"] = result["processId"];
+    }
+    return result;
+}
+// Base schema for MCP visibility (shows pid and alias)
+export const TerminateBackendSchemaBase = z.object({
+    pid: z.number().optional().describe("Process ID to terminate"),
+    processId: z.number().optional().describe("Alias for pid"),
+});
+// Preprocess schema for handlers
+export const TerminateBackendSchema = z.preprocess(preprocessPidParams, z.object({
+    pid: z.number().describe("Process ID to terminate"),
+}));
+// Base schema for MCP visibility (shows pid and alias)
+export const CancelBackendSchemaBase = z.object({
+    pid: z.number().optional().describe("Process ID to cancel"),
+    processId: z.number().optional().describe("Alias for pid"),
+});
+// Preprocess schema for handlers
+export const CancelBackendSchema = z.preprocess(preprocessPidParams, z.object({
+    pid: z.number().describe("Process ID to cancel"),
+}));
+//# sourceMappingURL=admin.js.map

package/dist/adapters/postgresql/schemas/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../../../src/adapters/postgresql/schemas/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAI,KAAiC,EAAE,CAAC;IAEzD,2BAA2B;IAC3B,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QACvE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAC7D,kDAAkD;YAClD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8CAA8C;AAC9C,iCAAiC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC3E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CAC3D,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,UAAU,CACtC,qBAAqB,EACrB,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC3E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CAC3D,CAAC,CACH,CAAC;AAEF,+CAA+C;AAC/C,iCAAiC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC3E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACrD,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,6BAA6B,CAAC;CAC3C,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,UAAU,CACvC,qBAAqB,EACrB,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC3E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACrD,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,6BAA6B,CAAC;CAC3C,CAAC,CACH,CAAC;AAEF,+CAA+C;AAC/C;;;GAGG;AACH,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAI,KAAiC,EAAE,CAAC;IACzD,0BAA0B;IAC1B,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QACtE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IACD,+CAA+C;IAC/C,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,mDAAmD;IACnD,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QACtE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;SAC9C,QAAQ,CAAC,iBAAiB,CAAC;IAC9B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mFAAmF,CACpF;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC3D,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACtE,CAAC,CAAC;AAEH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,UAAU,CACT,uBAAuB,EACvB,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;SAC9C,QAAQ,CAAC,iBAAiB,CAAC;IAC9B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mFAAmF,CACpF;IACH,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACtE,CAAC,CACH;KACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,wDAAwD;IACxD,MAAM,MAAM,GAAG,IAAyC,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,EACD;IACE,OAAO,EAAE,yDAAyD;CACnE,CACF,CAAC;AAEJ,iEAAiE;AACjE;;;GAGG;AACH,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAI,KAAiC,EAAE,CAAC;IACzD,yBAAyB;IACzB,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CAC3D,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,UAAU,CAChD,mBAAmB,EACnB,CAAC,CAAC,MAAM,CAAC;IACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACpD,CAAC,CACH,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CAC3D,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,UAAU,CAC7C,mBAAmB,EACnB,CAAC,CAAC,MAAM,CAAC;IACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACjD,CAAC,CACH,CAAC"}

package/dist/adapters/postgresql/schemas/backup.d.ts

@@ -0,0 +1,68 @@
+/**
+ * postgres-mcp - Backup Tool Schemas
+ *
+ * Input validation schemas for backup and export operations.
+ */
+import { z } from "zod";
+/**
+ * Base schema for MCP visibility (shows all parameters in JSON Schema).
+ * This schema is used for tool registration so MCP clients can see the parameters.
+ */
+export declare const CopyExportSchemaBase: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    sql: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        binary: "binary";
+        csv: "csv";
+    }>>;
+    header: z.ZodOptional<z.ZodBoolean>;
+    delimiter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Transformed schema with alias resolution, table shortcut, and schema.table parsing.
+ */
+export declare const CopyExportSchema: z.ZodPipe<z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    sql: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        binary: "binary";
+        csv: "csv";
+    }>>;
+    header: z.ZodOptional<z.ZodBoolean>;
+    delimiter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodTransform<{
+    query: string;
+    conflictWarning: string | undefined;
+    usedDefaultLimit: boolean;
+    effectiveLimit: number | undefined;
+    sql?: string | undefined;
+    table?: string | undefined;
+    schema?: string | undefined;
+    format?: "text" | "binary" | "csv" | undefined;
+    header?: boolean | undefined;
+    delimiter?: string | undefined;
+    limit?: number | undefined;
+}, {
+    query?: string | undefined;
+    sql?: string | undefined;
+    table?: string | undefined;
+    schema?: string | undefined;
+    format?: "text" | "binary" | "csv" | undefined;
+    header?: boolean | undefined;
+    delimiter?: string | undefined;
+    limit?: number | undefined;
+}>>;
+export declare const DumpSchemaSchema: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/adapters/postgresql/schemas/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/schemas/backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBA2B/B,CAAC;AAKH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0E3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;iBAO3B,CAAC"}

package/dist/adapters/postgresql/schemas/backup.js

@@ -0,0 +1,114 @@
+/**
+ * postgres-mcp - Backup Tool Schemas
+ *
+ * Input validation schemas for backup and export operations.
+ */
+import { z } from "zod";
+/**
+ * Base schema for MCP visibility (shows all parameters in JSON Schema).
+ * This schema is used for tool registration so MCP clients can see the parameters.
+ */
+export const CopyExportSchemaBase = z.object({
+    query: z.string().optional().describe("SELECT query for data to export"),
+    sql: z.string().optional().describe("Alias for query parameter"),
+    table: z
+        .string()
+        .optional()
+        .describe("Table name to export (auto-generates SELECT *). Supports 'schema.table' format"),
+    schema: z
+        .string()
+        .optional()
+        .describe("Schema name when using table (default: public)"),
+    format: z
+        .enum(["csv", "text", "binary"])
+        .optional()
+        .describe("Output format (default: csv)"),
+    header: z.boolean().optional().describe("Include header row (default: true)"),
+    delimiter: z.string().optional().describe("Field delimiter"),
+    limit: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("Maximum number of rows to export (default: 500 to prevent large payloads). Use 0 for all rows"),
+});
+/** Default limit for copyExport when not specified */
+const DEFAULT_EXPORT_LIMIT = 500;
+/**
+ * Transformed schema with alias resolution, table shortcut, and schema.table parsing.
+ */
+export const CopyExportSchema = CopyExportSchemaBase.transform((input) => {
+    // Apply alias: sql → query
+    let query = input.query ?? input.sql;
+    let conflictWarning;
+    // Check for conflicting parameters
+    if ((input.query !== undefined || input.sql !== undefined) &&
+        input.table !== undefined) {
+        conflictWarning =
+            "Both query and table parameters provided. Using query parameter (table ignored).";
+    }
+    // Resolve effective limit:
+    // - undefined = use DEFAULT_EXPORT_LIMIT (500)
+    // - 0 = no limit (export all rows)
+    // - positive number = user-specified limit
+    const effectiveLimit = input.limit === undefined
+        ? DEFAULT_EXPORT_LIMIT
+        : input.limit === 0
+            ? undefined // 0 means no limit
+            : input.limit;
+    // Track whether we used the default limit (handler will check actual row count)
+    let usedDefaultLimit = false;
+    // Auto-generate query from table if provided
+    if ((query === undefined || query === "") && input.table !== undefined) {
+        // Parse schema.table format (e.g., 'public.users' -> schema='public', table='users')
+        // If table contains a dot, always parse it as schema.table (embedded schema takes priority)
+        let tableName = input.table;
+        let schemaName = input.schema ?? "public";
+        if (input.table.includes(".")) {
+            const parts = input.table.split(".");
+            if (parts.length === 2 && parts[0] && parts[1]) {
+                schemaName = parts[0];
+                tableName = parts[1];
+            }
+        }
+        // Build query with LIMIT
+        query = `SELECT * FROM "${schemaName}"."${tableName}"`;
+        if (effectiveLimit !== undefined) {
+            query += ` LIMIT ${String(effectiveLimit)}`;
+            // Track if we're using the default limit (actual truncation determined in handler)
+            if (input.limit === undefined) {
+                usedDefaultLimit = true;
+            }
+        }
+    }
+    else if (query !== undefined && effectiveLimit !== undefined) {
+        // If a custom query is provided and limit is specified, wrap or append LIMIT
+        // Only append if query doesn't already have LIMIT
+        if (!/\bLIMIT\s+\d+\s*$/i.test(query)) {
+            query += ` LIMIT ${String(effectiveLimit)}`;
+            // Track if we're using the default limit (actual truncation determined in handler)
+            if (input.limit === undefined) {
+                usedDefaultLimit = true;
+            }
+        }
+    }
+    if (query === undefined || query === "") {
+        throw new Error("Either query/sql or table parameter is required");
+    }
+    return {
+        ...input,
+        query,
+        conflictWarning,
+        usedDefaultLimit,
+        effectiveLimit,
+    };
+});
+export const DumpSchemaSchema = z.object({
+    table: z.string().optional().describe("Table name"),
+    schema: z.string().optional().describe("Schema name"),
+    filename: z
+        .string()
+        .optional()
+        .describe("Output filename (default: backup.dump)"),
+});
+//# sourceMappingURL=backup.js.map