@neverinfamous/postgres-mcp 1.0.1

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

@@ -0,0 +1,149 @@
+/**
+ * pg_partman Status Resource
+ *
+ * Provides pg_partman partition set status, configuration, and health.
+ */
+import { LOW_PRIORITY } from "../../../utils/resourceAnnotations.js";
+/** Safely convert unknown value to string */
+function toStr(value) {
+    return typeof value === "string" ? value : "";
+}
+export function createPartmanResource(adapter) {
+    return {
+        uri: "postgres://partman",
+        name: "pg_partman Status",
+        description: "pg_partman partition set configuration, partition counts, and health status",
+        mimeType: "application/json",
+        annotations: LOW_PRIORITY,
+        handler: async () => {
+            const result = {
+                extensionInstalled: false,
+                extensionVersion: null,
+                partitionSets: [],
+                partitionSetCount: 0,
+                partitionInfo: [],
+                healthIssues: [],
+                maintenanceScheduled: false,
+                maintenanceJobCount: 0,
+                recommendations: [],
+            };
+            // Check if pg_partman is installed and get its schema (outside try-catch for correct error messaging)
+            const extCheck = await adapter.executeQuery(`SELECT e.extversion, n.nspname as schema_name
+                 FROM pg_extension e
+                 JOIN pg_namespace n ON e.extnamespace = n.oid
+                 WHERE e.extname = 'pg_partman'`);
+            if (!extCheck.rows || extCheck.rows.length === 0) {
+                result.recommendations.push("pg_partman extension is not installed. Use pg_partman_create_extension to enable automated partition management.");
+                return JSON.stringify(result, null, 2);
+            }
+            result.extensionInstalled = true;
+            const extVersion = extCheck.rows[0]?.["extversion"];
+            result.extensionVersion =
+                typeof extVersion === "string" ? extVersion : null;
+            // Get the schema where pg_partman is installed (defaults to 'partman' for compatibility)
+            const partmanSchemaRaw = extCheck.rows[0]?.["schema_name"];
+            const partmanSchema = typeof partmanSchemaRaw === "string" ? partmanSchemaRaw : "partman";
+            try {
+                // Get partition configurations using dynamically detected schema
+                const configResult = await adapter.executeQuery(`SELECT parent_table, control, partition_interval::text, 
+                            retention::text, premake, datetime_string
+                     FROM "${partmanSchema}".part_config
+                     ORDER BY parent_table`);
+                if (configResult.rows) {
+                    for (const row of configResult.rows) {
+                        const retentionVal = row["retention"];
+                        const datetimeVal = row["datetime_string"];
+                        result.partitionSets.push({
+                            parent_table: toStr(row["parent_table"]),
+                            control: toStr(row["control"]),
+                            partition_interval: toStr(row["partition_interval"]),
+                            retention: typeof retentionVal === "string" ? retentionVal : null,
+                            premake: Number(row["premake"] ?? 0),
+                            datetime_string: typeof datetimeVal === "string" ? datetimeVal : null,
+                        });
+                    }
+                    result.partitionSetCount = result.partitionSets.length;
+                }
+                // Get partition counts and sizes for each parent
+                for (const config of result.partitionSets) {
+                    try {
+                        const infoResult = await adapter.executeQuery(`SELECT COUNT(*)::int as partition_count,
+                                    pg_size_pretty(SUM(pg_total_relation_size(inhrelid))) as total_size
+                             FROM pg_inherits
+                             WHERE inhparent = $1::regclass`, [config.parent_table]);
+                        // Check for default partition with data
+                        const defaultCheck = await adapter.executeQuery(`SELECT EXISTS(
+                                SELECT 1 FROM pg_partitioned_table pt
+                                JOIN pg_class c ON pt.partrelid = c.oid
+                                WHERE c.relname = split_part($1, '.', 2)
+                                  AND pt.partdefid != 0
+                             ) as has_default,
+                             COALESCE((
+                                SELECT n_live_tup::int FROM pg_stat_user_tables
+                                WHERE schemaname || '.' || relname = $1 || '_default'
+                             ), 0) as default_rows`, [config.parent_table]);
+                        const partitionCount = Number(infoResult.rows?.[0]?.["partition_count"] ?? 0);
+                        const totalSizeVal = infoResult.rows?.[0]?.["total_size"];
+                        const totalSize = typeof totalSizeVal === "string" ? totalSizeVal : "0 bytes";
+                        const hasDefault = Boolean(defaultCheck.rows?.[0]?.["has_default"]);
+                        const defaultRows = Number(defaultCheck.rows?.[0]?.["default_rows"] ?? 0);
+                        result.partitionInfo.push({
+                            parent_table: config.parent_table,
+                            partition_count: partitionCount,
+                            total_size: totalSize,
+                            has_default: hasDefault,
+                            default_rows: defaultRows,
+                        });
+                        // Check for data in default partition
+                        if (defaultRows > 0) {
+                            result.healthIssues.push({
+                                table: config.parent_table,
+                                issue: `Default partition contains ${String(defaultRows)} rows. Use pg_partman_partition_data to move to child partitions.`,
+                                severity: defaultRows > 10000 ? "critical" : "warning",
+                            });
+                        }
+                        // Check retention configuration - only warn for tables with many partitions
+                        // where unlimited retention is more likely to be an oversight
+                        if (config.retention === null && partitionCount > 12) {
+                            result.recommendations.push(`${config.parent_table}: No retention policy configured (${String(partitionCount)} partitions). Consider pg_partman_set_retention for cleanup, or ignore if unlimited retention is intended.`);
+                        }
+                    }
+                    catch {
+                        // Individual table error, continue
+                    }
+                }
+                // Generate recommendations
+                if (result.partitionSetCount === 0) {
+                    result.recommendations.push("No partition sets configured. Use pg_partman_create_parent to create managed partitions.");
+                }
+                // Check for maintenance scheduling with broader pattern matching
+                try {
+                    const cronCheck = await adapter.executeQuery(`SELECT COUNT(*)::int as count FROM cron.job 
+                         WHERE command ILIKE '%partman%' 
+                            OR command ILIKE '%run_maintenance%'
+                            OR command ILIKE '%partition%maintenance%'`);
+                    const cronCount = Number(cronCheck.rows?.[0]?.["count"] ?? 0);
+                    result.maintenanceScheduled = cronCount > 0;
+                    result.maintenanceJobCount = cronCount;
+                    result.maintenanceMethod = cronCount > 0 ? "pg_cron" : "unknown";
+                    if (cronCount === 0 && result.partitionSetCount > 0) {
+                        result.recommendations.push("No pg_cron job found for partition maintenance. Setup options:", "Option 1 - pg_cron (recommended): SELECT cron.schedule('partman-maintenance', '*/30 * * * *', $$CALL partman.run_maintenance_proc()$$);", 'Option 2 - External: Add to system cron: */30 * * * * psql -c "CALL partman.run_maintenance_proc()"', "Run frequency: Every 30 minutes is typical. Adjust based on partition interval (faster intervals need more frequent runs).");
+                    }
+                }
+                catch {
+                    // pg_cron not installed
+                    result.maintenanceMethod = "external_or_none";
+                    if (result.partitionSetCount > 0) {
+                        result.recommendations.push("pg_cron not detected. Use external scheduling for maintenance:", 'System cron example: */30 * * * * psql -d your_database -c "CALL partman.run_maintenance_proc()"', "Windows Task Scheduler: Run psql command every 30 minutes", "Alternatively, install pg_cron: shared_preload_libraries = 'pg_cron' in postgresql.conf then restart");
+                    }
+                }
+            }
+            catch {
+                // Extension is installed but data queries failed
+                result.recommendations.push("Error querying pg_partman data. Check permissions on partman schema tables.");
+            }
+            return JSON.stringify(result, null, 2);
+        },
+    };
+}
+//# sourceMappingURL=partman.js.map

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

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

package/dist/adapters/postgresql/resources/performance.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Performance Resource
+ *
+ * Query performance metrics from pg_stat_statements.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createPerformanceResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=performance.d.ts.map

package/dist/adapters/postgresql/resources/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/performance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AAGjC,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CAkLpB"}

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

@@ -0,0 +1,170 @@
+/**
+ * Performance Resource
+ *
+ * Query performance metrics from pg_stat_statements.
+ */
+import { MEDIUM_PRIORITY } from "../../../utils/resourceAnnotations.js";
+export function createPerformanceResource(adapter) {
+    return {
+        uri: "postgres://performance",
+        name: "Query Performance",
+        description: "Query performance metrics from pg_stat_statements",
+        mimeType: "application/json",
+        annotations: MEDIUM_PRIORITY,
+        handler: async (_uri, _context) => {
+            // Check if pg_stat_statements is available
+            const extResult = await adapter.executeQuery(`
+                SELECT COUNT(*) as count 
+                FROM pg_extension 
+                WHERE extname = 'pg_stat_statements'
+            `);
+            const countValue = extResult.rows?.[0]?.["count"];
+            const hasPgStat = Number(countValue ?? 0) > 0;
+            if (!hasPgStat) {
+                return {
+                    extensionStatus: "not_installed",
+                    error: "pg_stat_statements extension not installed",
+                    recommendation: "Run: CREATE EXTENSION pg_stat_statements;",
+                    benefits: [
+                        "Track query performance and identify slow queries",
+                        "Optimize workload based on actual usage patterns",
+                        "Enable all performance intelligence tools",
+                        "Critical for production database monitoring",
+                    ],
+                };
+            }
+            try {
+                // Configurable thresholds
+                const SLOW_QUERY_THRESHOLD_MS = 1000; // 1 second mean time
+                const HIGH_COST_THRESHOLD_MS = 5000; // 5 seconds total time
+                // Get top queries by total time (filter out queries with 0 calls - no useful data)
+                const topQueries = await adapter.executeQuery(`
+                    SELECT 
+                        LEFT(query, 200) as query_preview,
+                        calls,
+                        round(total_exec_time::numeric, 2) as total_time_ms,
+                        round(mean_exec_time::numeric, 2) as mean_time_ms,
+                        round(stddev_exec_time::numeric, 2) as stddev_time_ms,
+                        rows,
+                        round(100.0 * shared_blks_hit / NULLIF(shared_blks_hit + shared_blks_read, 0), 2) as cache_hit_pct
+                    FROM pg_stat_statements
+                    WHERE userid = (SELECT oid FROM pg_roles WHERE rolname = current_user)
+                      AND calls > 0
+                    ORDER BY total_exec_time DESC
+                    LIMIT 20
+                `);
+                // Get slow queries (high mean execution time)
+                const slowQueries = await adapter.executeQuery(`
+                    SELECT 
+                        LEFT(query, 200) as query_preview,
+                        calls,
+                        round(mean_exec_time::numeric, 2) as mean_time_ms,
+                        round(total_exec_time::numeric, 2) as total_time_ms
+                    FROM pg_stat_statements
+                    WHERE userid = (SELECT oid FROM pg_roles WHERE rolname = current_user)
+                      AND calls > 0
+                      AND mean_exec_time > ${String(SLOW_QUERY_THRESHOLD_MS)}
+                    ORDER BY mean_exec_time DESC
+                    LIMIT 10
+                `);
+                // Get high-cost queries (high total execution time)
+                const highCostQueries = await adapter.executeQuery(`
+                    SELECT 
+                        LEFT(query, 200) as query_preview,
+                        calls,
+                        round(total_exec_time::numeric, 2) as total_time_ms,
+                        round(mean_exec_time::numeric, 2) as mean_time_ms
+                    FROM pg_stat_statements
+                    WHERE userid = (SELECT oid FROM pg_roles WHERE rolname = current_user)
+                      AND calls > 0
+                      AND total_exec_time > ${String(HIGH_COST_THRESHOLD_MS)}
+                    ORDER BY total_exec_time DESC
+                    LIMIT 10
+                `);
+                // Get summary statistics
+                const summary = await adapter.executeQuery(`
+                    SELECT 
+                        COUNT(*) as total_queries,
+                        SUM(calls) as total_calls,
+                        round(SUM(total_exec_time)::numeric, 2) as total_time_ms,
+                        round(AVG(mean_exec_time)::numeric, 2) as avg_time_ms
+                    FROM pg_stat_statements
+                    WHERE userid = (SELECT oid FROM pg_roles WHERE rolname = current_user)
+                      AND calls > 0
+                `);
+                const recommendations = [
+                    "Use pg_explain_analyze for detailed query analysis",
+                    "Consider pg_query_plan_compare for optimization testing",
+                ];
+                // Add context-aware recommendations
+                const slowCount = slowQueries.rows?.length ?? 0;
+                const highCostCount = highCostQueries.rows?.length ?? 0;
+                if (slowCount > 0) {
+                    recommendations.unshift(`${String(slowCount)} queries with mean time > ${String(SLOW_QUERY_THRESHOLD_MS)}ms detected. Consider adding indexes or query optimization.`);
+                }
+                if (highCostCount > 0) {
+                    recommendations.unshift(`${String(highCostCount)} high-cost queries detected (total time > ${String(HIGH_COST_THRESHOLD_MS)}ms).`);
+                }
+                // Check if we have any meaningful data
+                const hasData = (topQueries.rows?.length ?? 0) > 0;
+                // Check if ANY stats exist (even for other users) to provide better context
+                let anyStatsExist = false;
+                try {
+                    const anyStatsResult = await adapter.executeQuery(`
+                        SELECT EXISTS(SELECT 1 FROM pg_stat_statements WHERE calls > 0 LIMIT 1) as has_any
+                    `);
+                    anyStatsExist = Boolean(anyStatsResult.rows?.[0]?.["has_any"]);
+                }
+                catch {
+                    /* ignore - permission may be limited */
+                }
+                const noQueryData = !hasData
+                    ? {
+                        reason: anyStatsExist
+                            ? "Query statistics exist but no queries found for current user"
+                            : "No query statistics with calls > 0 found",
+                        suggestions: anyStatsExist
+                            ? [
+                                "Other users may have query data - check with superuser privileges",
+                                "Run some queries as the current user and check again",
+                            ]
+                            : [
+                                "Statistics may have been recently reset",
+                                "Run some queries and check again",
+                                "Use SELECT pg_stat_statements_reset() to clear stale data if needed",
+                            ],
+                    }
+                    : undefined;
+                return {
+                    extensionStatus: "installed",
+                    summary: summary.rows?.[0] ?? {},
+                    topQueries: topQueries.rows ?? [],
+                    slowQueries: slowQueries.rows ?? [],
+                    highCostQueries: highCostQueries.rows ?? [],
+                    thresholds: {
+                        slowQueryMs: SLOW_QUERY_THRESHOLD_MS,
+                        highCostMs: HIGH_COST_THRESHOLD_MS,
+                    },
+                    recommendations,
+                    noQueryData,
+                };
+            }
+            catch {
+                // Extension is installed but data queries failed (likely permission issue)
+                return {
+                    extensionStatus: "installed",
+                    error: "Error querying pg_stat_statements data. Check permissions or ensure pg_stat_statements is in shared_preload_libraries.",
+                    summary: {},
+                    topQueries: [],
+                    slowQueries: [],
+                    highCostQueries: [],
+                    recommendations: [
+                        "Grant SELECT on pg_stat_statements to current user",
+                        "Verify pg_stat_statements is in shared_preload_libraries",
+                    ],
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=performance.js.map

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

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

package/dist/adapters/postgresql/resources/pool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pool Resource
+ *
+ * MCP server connection pool statistics with external pooler detection.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createPoolResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=pool.d.ts.map

package/dist/adapters/postgresql/resources/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/pool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AASjC,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CA2FpB"}

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

@@ -0,0 +1,93 @@
+/**
+ * Pool Resource
+ *
+ * MCP server connection pool statistics with external pooler detection.
+ */
+import { LOW_PRIORITY } from "../../../utils/resourceAnnotations.js";
+export function createPoolResource(adapter) {
+    return {
+        uri: "postgres://pool",
+        name: "Connection Pool",
+        description: "MCP server connection pool statistics with external pooler detection",
+        mimeType: "application/json",
+        annotations: LOW_PRIORITY,
+        handler: async (_uri, _context) => {
+            const pool = adapter.getPool();
+            if (!pool) {
+                return { error: "Pool not initialized" };
+            }
+            const stats = pool.getStats();
+            const health = await pool.checkHealth();
+            // Determine pool status
+            let status;
+            if (stats.total === 0) {
+                status = "empty";
+            }
+            else if (stats.active > 0 && stats.active >= stats.total - 1) {
+                status = "busy";
+            }
+            else if (stats.active > 0) {
+                status = "active";
+            }
+            else {
+                status = "idle";
+            }
+            // Detect external poolers
+            const externalPooler = {
+                detected: false,
+                type: "none",
+            };
+            try {
+                // Check for pgbouncer by looking for its admin database or signature
+                const pgbouncerCheck = await adapter.executeQuery(`
+                    SELECT COUNT(*) as count FROM pg_database WHERE datname = 'pgbouncer'
+                `);
+                const hasPgbouncerDb = Number(pgbouncerCheck.rows?.[0]?.["count"] ?? 0) > 0;
+                if (hasPgbouncerDb) {
+                    externalPooler.detected = true;
+                    externalPooler.type = "pgbouncer";
+                    externalPooler.hint =
+                        'pgbouncer database detected. Use "SHOW POOLS" on pgbouncer admin database for pooler stats.';
+                }
+                // Alternative detection: check for pgbouncer in application_name patterns
+                if (!hasPgbouncerDb) {
+                    const appNameCheck = await adapter.executeQuery(`
+                        SELECT COUNT(*) as count FROM pg_stat_activity 
+                        WHERE application_name ILIKE '%pgbouncer%' OR application_name ILIKE '%pgpool%'
+                    `);
+                    const hasPoolerConnections = Number(appNameCheck.rows?.[0]?.["count"] ?? 0) > 0;
+                    if (hasPoolerConnections) {
+                        externalPooler.detected = true;
+                        externalPooler.type = "pgbouncer";
+                        externalPooler.hint =
+                            "Connections via external pooler detected. This resource shows MCP internal pool stats only.";
+                    }
+                }
+            }
+            catch {
+                // Detection failed, continue with default
+            }
+            // Build contextual note
+            let note = "Reports the MCP server internal connection pool.";
+            if (status === "empty" || status === "idle") {
+                note += " Values of 0 are normal when the pool is idle.";
+            }
+            if (externalPooler.detected) {
+                note += ` External pooler (${externalPooler.type}) detected - see externalPooler.hint for querying pooler stats.`;
+            }
+            else {
+                note +=
+                    " For external poolers like PgBouncer, query the pgbouncer admin database directly.";
+            }
+            return {
+                stats,
+                health,
+                isInitialized: pool.isInitialized(),
+                status,
+                externalPooler,
+                note,
+            };
+        },
+    };
+}
+//# sourceMappingURL=pool.js.map

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

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

package/dist/adapters/postgresql/resources/postgis.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PostGIS Status Resource
+ *
+ * Provides PostGIS extension status, spatial columns, and index information.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createPostgisResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=postgis.d.ts.map

package/dist/adapters/postgresql/resources/postgis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgis.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/postgis.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAoDlE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CAgSpB"}