@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/tools/backup/planning.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PostgreSQL Backup Tools - Planning
+ *
+ * Backup planning tools: backup_plan, restore_command, physical_backup, restore_validate, backup_schedule_optimize.
+ */
+import type { PostgresAdapter } from "../../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../../types/index.js";
+export declare function createBackupPlanTool(adapter: PostgresAdapter): ToolDefinition;
+export declare function createRestoreCommandTool(_adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Generate pg_basebackup command for physical backup
+ */
+export declare function createPhysicalBackupTool(_adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Validate backup restorability
+ */
+export declare function createRestoreValidateTool(_adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Optimize backup schedule
+ */
+export declare function createBackupScheduleOptimizeTool(adapter: PostgresAdapter): ToolDefinition;
+//# sourceMappingURL=planning.d.ts.map

package/dist/adapters/postgresql/tools/backup/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/backup/planning.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AAKpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAwF7E;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,eAAe,GACxB,cAAc,CAwEhB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,eAAe,GACxB,cAAc,CAkFhB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,eAAe,GACxB,cAAc,CA+FhB;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,eAAe,GACvB,cAAc,CAyFhB"}

package/dist/adapters/postgresql/tools/backup/planning.js

@@ -0,0 +1,411 @@
+/**
+ * PostgreSQL Backup Tools - Planning
+ *
+ * Backup planning tools: backup_plan, restore_command, physical_backup, restore_validate, backup_schedule_optimize.
+ */
+import { z } from "zod";
+import { readOnly } from "../../../../utils/annotations.js";
+import { getToolIcons } from "../../../../utils/icons.js";
+export function createBackupPlanTool(adapter) {
+    return {
+        name: "pg_create_backup_plan",
+        description: "Generate a backup strategy recommendation with cron schedule.",
+        group: "backup",
+        inputSchema: z.object({
+            frequency: z
+                .enum(["hourly", "daily", "weekly"])
+                .optional()
+                .describe("Backup frequency (default: daily)"),
+            retention: z
+                .number()
+                .optional()
+                .describe("Number of backups to retain (default: 7)"),
+        }),
+        annotations: readOnly("Create Backup Plan"),
+        icons: getToolIcons("backup", readOnly("Create Backup Plan")),
+        handler: async (params, _context) => {
+            // Parse params through schema to validate enum values
+            const schema = z.object({
+                frequency: z.enum(["hourly", "daily", "weekly"]).optional(),
+                retention: z.number().optional(),
+            });
+            const parsed = schema.parse(params);
+            const freq = parsed.frequency ?? "daily";
+            // Validate retention - must be at least 1
+            if (parsed.retention !== undefined && parsed.retention < 1) {
+                throw new Error("retention must be at least 1 (cannot retain zero or negative backups)");
+            }
+            const retention = parsed.retention ?? 7;
+            // Generate cron schedule based on frequency
+            const getCronSchedule = (frequency) => {
+                switch (frequency) {
+                    case "hourly":
+                        return "0 * * * *"; // Every hour at minute 0
+                    case "weekly":
+                        return "0 2 * * 0"; // Sundays at 2 AM
+                    default:
+                        return "0 2 * * *"; // Daily at 2 AM
+                }
+            };
+            const cronSchedule = getCronSchedule(freq);
+            const sizeResult = await adapter.executeQuery(`SELECT pg_database_size(current_database()) as bytes`);
+            const sizeBytes = Number(sizeResult.rows?.[0]?.["bytes"] ?? 0);
+            const sizeGB = (sizeBytes / (1024 * 1024 * 1024)).toFixed(2);
+            return {
+                strategy: {
+                    fullBackup: {
+                        // Use timestamp with hours/minutes for hourly backups to prevent overwrites
+                        command: freq === "hourly"
+                            ? "pg_dump --format=custom --verbose --file=backup_$(date +%Y%m%d_%H%M).dump $POSTGRES_CONNECTION_STRING"
+                            : "pg_dump --format=custom --verbose --file=backup_$(date +%Y%m%d).dump $POSTGRES_CONNECTION_STRING",
+                        frequency: freq,
+                        cronSchedule,
+                        retention: `${String(retention)} backups`,
+                    },
+                    walArchiving: {
+                        note: "Enable archive_mode and archive_command for point-in-time recovery",
+                        configChanges: [
+                            "archive_mode = on",
+                            "archive_command = 'cp %p /path/to/wal_archive/%f'",
+                        ],
+                    },
+                },
+                estimates: {
+                    databaseSize: `${sizeGB} GB`,
+                    // Per-backup size is ~30% of database due to compression
+                    backupSizeEach: `~${(Number(sizeGB) * 0.3).toFixed(2)} GB (compressed)`,
+                    // Use appropriate frequency label
+                    ...(freq === "weekly"
+                        ? { backupsPerWeek: 1 }
+                        : { backupsPerDay: freq === "hourly" ? 24 : 1 }),
+                    // Total = size per backup * retention count
+                    totalStorageNeeded: `~${(Number(sizeGB) * 0.3 * retention).toFixed(2)} GB (${String(retention)} backups retained)`,
+                },
+            };
+        },
+    };
+}
+export function createRestoreCommandTool(_adapter) {
+    return {
+        name: "pg_restore_command",
+        description: "Generate pg_restore command for restoring backups.",
+        group: "backup",
+        inputSchema: z.object({
+            backupFile: z.string(),
+            database: z
+                .string()
+                .optional()
+                .describe("Target database name (required for complete command)"),
+            schema: z.string().optional(),
+            table: z.string().optional(),
+            dataOnly: z.boolean().optional(),
+            schemaOnly: z.boolean().optional(),
+        }),
+        annotations: readOnly("Restore Command"),
+        icons: getToolIcons("backup", readOnly("Restore Command")),
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (params, _context) => {
+            const parsed = params;
+            // Validate required param
+            if (parsed.backupFile === undefined || parsed.backupFile === "") {
+                throw new Error("backupFile parameter is required");
+            }
+            // Validate mutually exclusive options
+            if (parsed.dataOnly === true && parsed.schemaOnly === true) {
+                throw new Error("dataOnly and schemaOnly cannot both be true - pg_restore only supports one at a time");
+            }
+            let command = "pg_restore --verbose";
+            const warnings = [];
+            if (parsed.database !== undefined) {
+                command += ` --dbname="${parsed.database}"`;
+            }
+            else {
+                warnings.push("No database specified - add --dbname=DBNAME to run this command");
+            }
+            if (parsed.schema !== undefined)
+                command += ` --schema="${parsed.schema}"`;
+            if (parsed.table !== undefined)
+                command += ` --table="${parsed.table}"`;
+            if (parsed.dataOnly === true)
+                command += " --data-only";
+            if (parsed.schemaOnly === true)
+                command += " --schema-only";
+            command += ` "${parsed.backupFile}"`;
+            return {
+                command,
+                ...(warnings.length > 0 && { warnings }),
+                notes: [
+                    "Add --clean to drop database objects before recreating",
+                    "Add --if-exists to avoid errors on drop",
+                    "Add --no-owner to skip ownership commands",
+                    "Use -j N for parallel restore (N workers)",
+                    "For remote restores, add -h HOST -p PORT -U USER to the command",
+                ],
+            };
+        },
+    };
+}
+/**
+ * Generate pg_basebackup command for physical backup
+ */
+export function createPhysicalBackupTool(_adapter) {
+    return {
+        name: "pg_backup_physical",
+        description: "Generate pg_basebackup command for physical (binary) backup.",
+        group: "backup",
+        inputSchema: z.object({
+            targetDir: z.string().describe("Target directory for backup"),
+            format: z.enum(["plain", "tar"]).optional().describe("Backup format"),
+            checkpoint: z
+                .enum(["fast", "spread"])
+                .optional()
+                .describe("Checkpoint mode"),
+            compress: z.number().optional().describe("Compression level 0-9"),
+        }),
+        annotations: readOnly("Physical Backup"),
+        icons: getToolIcons("backup", readOnly("Physical Backup")),
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (params, _context) => {
+            // Parse params through schema to validate enum values
+            const schema = z.object({
+                targetDir: z.string().optional(),
+                format: z.enum(["plain", "tar"]).optional(),
+                checkpoint: z.enum(["fast", "spread"]).optional(),
+                compress: z.number().optional(),
+            });
+            const parsed = schema.parse(params);
+            // Validate required param
+            if (parsed.targetDir === undefined || parsed.targetDir === "") {
+                throw new Error("targetDir parameter is required");
+            }
+            // Validate compress range
+            if (parsed.compress !== undefined &&
+                (parsed.compress < 0 || parsed.compress > 9)) {
+                throw new Error("compress must be between 0 and 9");
+            }
+            let command = "pg_basebackup";
+            command += ` -D "${parsed.targetDir}"`;
+            // Set format flag: plain (-Fp) if specified, otherwise tar (-Ft) as default
+            command += parsed.format === "plain" ? " -Fp" : " -Ft";
+            command += " -Xs";
+            command += " -P";
+            if (parsed.checkpoint === "fast") {
+                command += " -c fast";
+            }
+            else if (parsed.checkpoint === "spread") {
+                command += " -c spread";
+            }
+            if (parsed.compress !== undefined && parsed.compress > 0) {
+                // Use only -Z (--compress) with level, not -z (which is redundant)
+                command += ` -Z ${String(parsed.compress)}`;
+            }
+            // Connection flags should be provided by user or via environment
+            command +=
+                " -h ${PGHOST:-localhost} -p ${PGPORT:-5432} -U ${PGUSER:-postgres}";
+            return {
+                command,
+                notes: [
+                    "Set PGHOST, PGPORT, PGUSER environment variables or replace the placeholders directly",
+                    "Requires replication connection permission",
+                    "Modify -h/-U flags above to change connection target",
+                    "Add --slot=NAME to use a replication slot",
+                    "Physical backups capture the entire cluster",
+                    parsed.format === "plain"
+                        ? "Plain format (-Fp): Creates directory structure with individual data files"
+                        : "Tar format (-Ft): Creates single compressed archive file",
+                ],
+                requirements: [
+                    "wal_level = replica (or higher)",
+                    "max_wal_senders > 0",
+                    "pg_hba.conf must allow replication connections",
+                ],
+            };
+        },
+    };
+}
+/**
+ * Validate backup restorability
+ */
+export function createRestoreValidateTool(_adapter) {
+    return {
+        name: "pg_restore_validate",
+        description: "Generate commands to validate backup integrity and restorability.",
+        group: "backup",
+        inputSchema: z.object({
+            backupFile: z.string().describe("Path to backup file"),
+            backupType: z.enum(["pg_dump", "pg_basebackup"]).optional(),
+        }),
+        annotations: readOnly("Restore Validate"),
+        icons: getToolIcons("backup", readOnly("Restore Validate")),
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (params, _context) => {
+            // Parse params through schema to validate enum values
+            const schema = z.object({
+                backupFile: z.string().optional(),
+                backupType: z.enum(["pg_dump", "pg_basebackup"]).optional(),
+            });
+            const parsed = schema.parse(params);
+            // Validate required param
+            if (parsed.backupFile === undefined || parsed.backupFile === "") {
+                throw new Error("backupFile parameter is required");
+            }
+            const backupType = parsed.backupType ?? "pg_dump";
+            const defaultUsed = parsed.backupType === undefined;
+            if (backupType === "pg_dump") {
+                return {
+                    ...(defaultUsed && {
+                        note: "No backupType specified - defaulting to pg_dump validation steps",
+                    }),
+                    validationSteps: [
+                        {
+                            step: 1,
+                            name: "Check backup file integrity",
+                            command: `pg_restore --list "${parsed.backupFile}"`,
+                        },
+                        {
+                            step: 2,
+                            name: "Test restore to temporary database",
+                            commands: [
+                                "createdb test_restore",
+                                `pg_restore --dbname=test_restore "${parsed.backupFile}"`,
+                                "-- Run validation queries",
+                                "dropdb test_restore",
+                            ],
+                        },
+                        {
+                            step: 3,
+                            name: "Verify table counts match",
+                            note: "Compare pg_class counts between source and restored database",
+                        },
+                    ],
+                    recommendations: [
+                        "Automate validation as part of backup workflow",
+                        "Keep validation logs for compliance",
+                        "Test restores regularly, not just during incidents",
+                    ],
+                };
+            }
+            else {
+                return {
+                    validationSteps: [
+                        {
+                            step: 1,
+                            name: "Verify backup with pg_verifybackup (PostgreSQL 13+)",
+                            command: `pg_verifybackup "${parsed.backupFile}"`,
+                        },
+                        {
+                            step: 2,
+                            name: "Verify base backup files",
+                            command: `ls -la "${parsed.backupFile}"/`,
+                        },
+                        {
+                            step: 3,
+                            name: "Check backup_label file",
+                            command: `cat "${parsed.backupFile}"/backup_label`,
+                        },
+                        {
+                            step: 4,
+                            name: "Test recovery in isolated environment",
+                            note: "Configure recovery.conf/recovery.signal and start standby",
+                        },
+                    ],
+                    recommendations: [
+                        "pg_verifybackup validates checksums (requires data checksums enabled)",
+                        "Maintain WAL archives for point-in-time recovery testing",
+                        "Document recovery procedures and test quarterly",
+                    ],
+                };
+            }
+        },
+    };
+}
+/**
+ * Optimize backup schedule
+ */
+export function createBackupScheduleOptimizeTool(adapter) {
+    return {
+        name: "pg_backup_schedule_optimize",
+        description: "Analyze database activity patterns and recommend optimal backup schedule.",
+        group: "backup",
+        inputSchema: z.object({}),
+        annotations: readOnly("Backup Schedule Optimize"),
+        icons: getToolIcons("backup", readOnly("Backup Schedule Optimize")),
+        handler: async (_params, _context) => {
+            const [dbSize, changeRate, connActivity] = await Promise.all([
+                adapter.executeQuery(`
+                    SELECT 
+                        pg_database_size(current_database()) as size_bytes,
+                        pg_size_pretty(pg_database_size(current_database())) as size
+                `),
+                adapter.executeQuery(`
+                    SELECT 
+                        sum(n_tup_ins + n_tup_upd + n_tup_del) as total_changes,
+                        sum(n_live_tup) as total_rows
+                    FROM pg_stat_user_tables
+                `),
+                adapter.executeQuery(`
+                    SELECT 
+                        extract(hour from backend_start) as hour,
+                        count(*) as connection_count
+                    FROM pg_stat_activity
+                    WHERE backend_type = 'client backend'
+                    GROUP BY extract(hour from backend_start)
+                    ORDER BY hour
+                `),
+            ]);
+            const sizeBytes = Number(dbSize.rows?.[0]?.["size_bytes"] ?? 0);
+            const totalChanges = Number(changeRate.rows?.[0]?.["total_changes"] ?? 0);
+            const totalRows = Number(changeRate.rows?.[0]?.["total_rows"] ?? 1);
+            const changePercent = (totalChanges / Math.max(totalRows, 1)) * 100;
+            let strategy;
+            let fullBackupFrequency;
+            let incrementalFrequency;
+            if (sizeBytes > 100 * 1024 * 1024 * 1024) {
+                strategy = "Large database - use incremental/WAL-based backups";
+                fullBackupFrequency = "Weekly";
+                incrementalFrequency = "Continuous WAL archiving";
+            }
+            else if (changePercent > 50) {
+                strategy = "High change rate - frequent backups recommended";
+                fullBackupFrequency = "Daily";
+                incrementalFrequency = "Every 6 hours";
+            }
+            else if (changePercent > 10) {
+                strategy = "Moderate activity - standard backup schedule";
+                fullBackupFrequency = "Daily";
+                incrementalFrequency = "Every 12 hours";
+            }
+            else {
+                strategy = "Low activity - conservative backup schedule";
+                fullBackupFrequency = "Daily";
+                incrementalFrequency = "Not required";
+            }
+            return {
+                analysis: {
+                    databaseSize: dbSize.rows?.[0]?.["size"],
+                    totalChanges,
+                    // This is change velocity (total DML operations / current rows) - can exceed 100% for high-churn tables
+                    changeVelocity: Number(changePercent.toFixed(2)),
+                    changeVelocityRatio: changePercent.toFixed(2) + "%",
+                    activityByHour: connActivity.rows?.map((row) => ({
+                        hour: Number(row["hour"]),
+                        connection_count: Number(row["connection_count"]),
+                    })),
+                    activityNote: "Activity data reflects current session connections only, not historical patterns",
+                },
+                recommendation: {
+                    strategy,
+                    fullBackupFrequency,
+                    incrementalFrequency,
+                    bestTimeForBackup: "Off-peak hours (typically 2-4 AM local time)",
+                    retentionPolicy: "Keep 7 daily, 4 weekly, 12 monthly",
+                },
+                commands: {
+                    cronSchedule: `0 2 * * * pg_dump -Fc -f /backups/daily_$(date +\\%Y\\%m\\%d).dump $POSTGRES_CONNECTION_STRING`,
+                    walArchive: "archive_command = 'test ! -f /wal_archive/%f && cp %p /wal_archive/%f'",
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=planning.js.map

package/dist/adapters/postgresql/tools/backup/planning.js.map

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

package/dist/adapters/postgresql/tools/citext.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PostgreSQL citext Extension Tools
+ *
+ * Case-insensitive text type for preventing subtle bugs in auth systems,
+ * emails, and usernames. 6 tools total.
+ *
+ * citext provides a case-insensitive character string type at the type level:
+ * - Comparisons are case-insensitive (e.g., 'HELLO' = 'hello')
+ * - Sorting is case-insensitive
+ * - Ideal for email, username, and other identifier columns
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../types/index.js";
+/**
+ * Get all citext tools
+ */
+export declare function getCitextTools(adapter: PostgresAdapter): ToolDefinition[];
+//# sourceMappingURL=citext.d.ts.map

package/dist/adapters/postgresql/tools/citext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citext.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/tools/citext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AAe9E;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,EAAE,CASzE"}