@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/prompts/extensionSetup.js

@@ -0,0 +1,282 @@
+/**
+ * Extension Setup Prompt
+ *
+ * Guide for installing and configuring PostgreSQL extensions.
+ */
+const extensionInfo = {
+    pgvector: {
+        purpose: "AI-native vector similarity search",
+        useCases: ["Semantic search", "Recommendation systems", "Image similarity"],
+    },
+    postgis: {
+        purpose: "Geospatial operations and GIS",
+        useCases: ["Mapping", "Location-based services", "Spatial analysis"],
+    },
+    hypopg: {
+        purpose: "Hypothetical index testing",
+        useCases: ["Index optimization", "Zero-risk testing", "Performance tuning"],
+    },
+    pg_stat_statements: {
+        purpose: "Query performance tracking",
+        useCases: [
+            "Performance monitoring",
+            "Slow query detection",
+            "Workload analysis",
+        ],
+    },
+    pg_trgm: {
+        purpose: "Fuzzy text search with trigrams",
+        useCases: ["Fuzzy matching", "Typo tolerance", "Text similarity"],
+    },
+    fuzzystrmatch: {
+        purpose: "Phonetic matching and edit distance",
+        useCases: ["Soundex matching", "Levenshtein distance", "Metaphone"],
+    },
+    pg_cron: {
+        purpose: "Job scheduling within PostgreSQL",
+        useCases: ["Scheduled tasks", "Maintenance automation", "ETL pipelines"],
+    },
+    pg_partman: {
+        purpose: "Automated partition management",
+        useCases: [
+            "Time-series partitioning",
+            "Data retention",
+            "Large table management",
+        ],
+    },
+    pg_stat_kcache: {
+        purpose: "OS-level CPU and I/O metrics",
+        useCases: [
+            "Performance profiling",
+            "Resource monitoring",
+            "Query optimization",
+        ],
+    },
+    citext: {
+        purpose: "Case-insensitive text type",
+        useCases: ["Email storage", "Username handling", "Case-insensitive search"],
+    },
+    ltree: {
+        purpose: "Hierarchical tree-structured data",
+        useCases: ["Categories", "Org charts", "File paths", "Taxonomies"],
+    },
+    pgcrypto: {
+        purpose: "Cryptographic functions",
+        useCases: ["Password hashing", "Data encryption", "Secure UUIDs"],
+    },
+};
+export function createExtensionSetupPrompt() {
+    return {
+        name: "pg_extension_setup",
+        description: "Guide for installing and configuring PostgreSQL extensions (pgvector, postgis, pg_cron, pg_partman, citext, ltree, pgcrypto, etc.).",
+        arguments: [
+            {
+                name: "extensionName",
+                description: "Extension name: pgvector, postgis, pg_cron, pg_partman, pg_stat_kcache, citext, ltree, pgcrypto, hypopg, pg_stat_statements, pg_trgm, fuzzystrmatch",
+                required: true,
+            },
+        ],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (args, _context) => {
+            const extensionName = args["extensionName"] ?? "pg_stat_statements";
+            const info = extensionInfo[extensionName] ?? {
+                purpose: "PostgreSQL extension",
+                useCases: ["Database operations"],
+            };
+            let content = `# Extension Setup Guide - ${extensionName}
+
+**Purpose:** ${info.purpose}
+
+## Use Cases
+${info.useCases.map((uc) => `- ${uc}`).join("\n")}
+
+## Setup Steps
+
+### 1. Check Availability
+
+\`\`\`sql
+SELECT * FROM pg_available_extensions WHERE name = '${extensionName}';
+\`\`\`
+
+If not available, install at system level:
+\`\`\`bash
+# Ubuntu/Debian
+sudo apt-get install postgresql-${extensionName}
+
+# macOS (Homebrew)
+brew install ${extensionName}
+\`\`\`
+
+### 2. Install Extension
+
+\`\`\`sql
+CREATE EXTENSION IF NOT EXISTS ${extensionName};
+\`\`\`
+
+Verify: \`SELECT extname, extversion FROM pg_extension WHERE extname = '${extensionName}';\`
+
+### 3. Configuration
+`;
+            if (extensionName === "pg_stat_statements") {
+                content += `
+**postgresql.conf:**
+\`\`\`
+shared_preload_libraries = 'pg_stat_statements'
+pg_stat_statements.track = all
+pg_stat_statements.max = 10000
+\`\`\`
+
+**Restart PostgreSQL after configuration!**
+
+**Verify:**
+\`\`\`sql
+SELECT query, calls, mean_exec_time
+FROM pg_stat_statements
+ORDER BY mean_exec_time DESC LIMIT 10;
+\`\`\`
+`;
+            }
+            else if (extensionName === "hypopg") {
+                content += `
+No configuration needed - works out of the box!
+
+**Test it:**
+\`\`\`sql
+SELECT * FROM hypopg_create_index('CREATE INDEX ON users(email)');
+EXPLAIN SELECT * FROM users WHERE email = 'test@example.com';
+SELECT hypopg_reset();
+\`\`\`
+`;
+            }
+            else if (extensionName === "pgvector") {
+                content += `
+**Create vector column:**
+\`\`\`sql
+ALTER TABLE documents ADD COLUMN embedding vector(1536);
+\`\`\`
+
+**Create HNSW index:**
+\`\`\`sql
+CREATE INDEX ON documents USING hnsw (embedding vector_cosine_ops);
+\`\`\`
+
+Use \`pg_setup_pgvector\` prompt for detailed setup.
+`;
+            }
+            else if (extensionName === "postgis") {
+                content += `
+**Check version:**
+\`\`\`sql
+SELECT PostGIS_Full_Version();
+\`\`\`
+
+**Create spatial column:**
+\`\`\`sql
+ALTER TABLE locations ADD COLUMN geom GEOGRAPHY(POINT, 4326);
+CREATE INDEX ON locations USING GIST (geom);
+\`\`\`
+
+Use \`pg_setup_postgis\` prompt for detailed setup.
+`;
+            }
+            else if (extensionName === "pg_cron") {
+                content += `
+**postgresql.conf:**
+\`\`\`
+shared_preload_libraries = 'pg_cron'
+cron.database_name = 'your_database'
+\`\`\`
+
+**Restart PostgreSQL after configuration!**
+
+**Schedule a job:**
+\`\`\`sql
+SELECT cron.schedule('nightly-vacuum', '0 3 * * *', 'VACUUM ANALYZE');
+\`\`\`
+
+Use \`pg_setup_pgcron\` prompt for detailed setup.
+`;
+            }
+            else if (extensionName === "pg_partman") {
+                content += `
+**Create parent table:**
+\`\`\`sql
+SELECT partman.create_parent(
+    p_parent_table => 'public.events',
+    p_control => 'created_at',
+    p_interval => '1 month'
+);
+\`\`\`
+
+Use \`pg_setup_partman\` prompt for detailed setup.
+`;
+            }
+            else if (extensionName === "pg_stat_kcache") {
+                content += `
+**postgresql.conf:**
+\`\`\`
+shared_preload_libraries = 'pg_stat_statements, pg_stat_kcache'
+\`\`\`
+
+**Restart PostgreSQL after configuration!**
+
+Use \`pg_setup_kcache\` prompt for detailed setup.
+`;
+            }
+            else if (extensionName === "citext") {
+                content += `
+**Use for case-insensitive columns:**
+\`\`\`sql
+ALTER TABLE users ALTER COLUMN email TYPE CITEXT;
+\`\`\`
+
+Use \`pg_setup_citext\` prompt for detailed setup.
+`;
+            }
+            else if (extensionName === "ltree") {
+                content += `
+**Create hierarchical column:**
+\`\`\`sql
+ALTER TABLE categories ADD COLUMN path LTREE;
+CREATE INDEX ON categories USING GIST (path);
+\`\`\`
+
+Use \`pg_setup_ltree\` prompt for detailed setup.
+`;
+            }
+            else if (extensionName === "pgcrypto") {
+                content += `
+**Secure password hashing:**
+\`\`\`sql
+INSERT INTO users (email, password_hash)
+VALUES ('user@example.com', crypt('password', gen_salt('bf', 10)));
+\`\`\`
+
+Use \`pg_setup_pgcrypto\` prompt for detailed setup.
+`;
+            }
+            else {
+                content += `
+Extension-specific configuration may vary. Check the official documentation.
+`;
+            }
+            content += `
+### 4. Best Practices
+
+- Always test extensions in development first
+- Check compatibility with your PostgreSQL version
+- Monitor performance impact after enabling
+- Keep extensions updated
+
+### 5. Troubleshooting
+
+**Extension not found:** Verify system-level installation, check pg_config --sharedir
+**Permission denied:** Must be superuser to install extensions
+**Version mismatch:** Ensure extension compatible with PostgreSQL version
+
+**Pro Tip:** PostgreSQL's extension ecosystem is one of its greatest strengths!`;
+            return content;
+        },
+    };
+}
+//# sourceMappingURL=extensionSetup.js.map

package/dist/adapters/postgresql/prompts/extensionSetup.js.map

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

package/dist/adapters/postgresql/prompts/health.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Database Health Check Prompt
+ *
+ * Comprehensive health assessment workflow for PostgreSQL databases.
+ */
+import type { PromptDefinition } from "../../../types/index.js";
+export declare function createDatabaseHealthCheckPrompt(): PromptDefinition;
+//# sourceMappingURL=health.d.ts.map

package/dist/adapters/postgresql/prompts/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/prompts/health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAEhF,wBAAgB,+BAA+B,IAAI,gBAAgB,CA4HlE"}

package/dist/adapters/postgresql/prompts/health.js

@@ -0,0 +1,118 @@
+/**
+ * Database Health Check Prompt
+ *
+ * Comprehensive health assessment workflow for PostgreSQL databases.
+ */
+export function createDatabaseHealthCheckPrompt() {
+    return {
+        name: "pg_database_health_check",
+        description: "Comprehensive database health assessment covering indexes, connections, vacuum, replication, and buffer cache.",
+        arguments: [
+            {
+                name: "focus",
+                description: "Health area to focus on: all, indexes, connections, vacuum, replication, buffer",
+                required: false,
+            },
+        ],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (args, _context) => {
+            const focus = args["focus"] ?? "all";
+            let content = `# Database Health Check - Focus: ${focus.charAt(0).toUpperCase() + focus.slice(1)}
+
+## Health Check Categories
+
+### 1. Extension Availability
+
+First, verify critical extensions are installed:
+
+\`\`\`sql
+SELECT extname, extversion FROM pg_extension WHERE extname IN ('pg_stat_statements', 'hypopg', 'vector', 'postgis');
+\`\`\`
+
+Use \`pg_list_extensions\` to see all installed extensions.
+
+### 2. Database Health Analysis
+
+Use \`pg_analyze_db_health\` with health_type: "${focus}"
+
+This runs comprehensive checks on:
+`;
+            if (focus === "indexes" || focus === "all") {
+                content += `
+**Index Health:**
+- Invalid indexes (need rebuilding)
+- Duplicate indexes (waste space)
+- Bloated indexes (need REINDEX)
+- Unused indexes (candidates for removal)
+`;
+            }
+            if (focus === "connections" || focus === "all") {
+                content += `
+**Connection Health:**
+- Current connection count vs. max_connections
+- Connection pool utilization
+- Idle connections consuming resources
+- Long-running transactions blocking others
+`;
+            }
+            if (focus === "vacuum" || focus === "all") {
+                content += `
+**Vacuum Health:**
+- Transaction ID wraparound risk (CRITICAL)
+- Autovacuum effectiveness
+- Table bloat estimates
+- Dead tuple accumulation
+`;
+            }
+            if (focus === "replication" || focus === "all") {
+                content += `
+**Replication Health:**
+- Replication lag in milliseconds
+- Replication slot status
+- WAL sender/receiver status
+`;
+            }
+            if (focus === "buffer" || focus === "all") {
+                content += `
+**Buffer Cache Health:**
+- Cache hit ratio for tables (should be > 99%)
+- Cache hit ratio for indexes (should be > 99%)
+- Shared buffers effectiveness
+`;
+            }
+            content += `
+### 3. Performance Metrics
+
+Check query performance using \`pg_stat_statements\`:
+- Queries with mean_exec_time > 1000ms
+- High variation in execution times
+- Queries dominating total database time
+
+### 4. Capacity Planning
+
+Use \`pg_capacity_planning\` to analyze growth:
+- Database size growth rate
+- Estimated time to disk full
+- Table growth patterns
+
+### 5. Alert Thresholds
+
+Use \`pg_alert_threshold_set\` for:
+- Connection limits (warning: 80%, critical: 95%)
+- Cache hit ratio (warning: 95%, critical: 90%)
+- Replication lag (warning: 5s, critical: 30s)
+
+## Health Report
+
+After running checks, I'll provide:
+- **Health Score:** Overall status (Good/Warning/Critical)
+- **Critical Issues:** Fix immediately
+- **Warnings:** Plan to fix
+- **Recommendations:** Maintenance schedule
+
+**Pro Tip:** Run health checks during low-traffic periods for accurate baselines!`;
+            return content;
+        },
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/adapters/postgresql/prompts/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../../src/adapters/postgresql/prompts/health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,gHAAgH;QAClH,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EACT,iFAAiF;gBACnF,QAAQ,EAAE,KAAK;aAChB;SACF;QACD,4DAA4D;QAC5D,OAAO,EAAE,KAAK,EACZ,IAA4B,EAC5B,QAAwB,EACP,EAAE;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;YAErC,IAAI,OAAO,GAAG,oCAAoC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;kDAgBpD,KAAK;;;CAGtD,CAAC;YAEI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC3C,OAAO,IAAI;;;;;;CAMlB,CAAC;YACI,CAAC;YAED,IAAI,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC/C,OAAO,IAAI;;;;;;CAMlB,CAAC;YACI,CAAC;YAED,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC1C,OAAO,IAAI;;;;;;CAMlB,CAAC;YACI,CAAC;YAED,IAAI,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC/C,OAAO,IAAI;;;;;CAKlB,CAAC;YACI,CAAC;YAED,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC1C,OAAO,IAAI;;;;;CAKlB,CAAC;YACI,CAAC;YAED,OAAO,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kFA8BiE,CAAC;YAE7E,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/postgresql/prompts/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PostgreSQL MCP Prompts
+ *
+ * AI-powered prompts for query building, schema design, and optimization.
+ * 19 prompts total.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { PromptDefinition } from "../../../types/index.js";
+/**
+ * Get all PostgreSQL prompts
+ */
+export declare function getPostgresPrompts(adapter: PostgresAdapter): PromptDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/postgresql/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,yBAAyB,CAAC;AAgBjC;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,GACvB,gBAAgB,EAAE,CA0BpB"}