@neverinfamous/postgres-mcp 1.0.1

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

@@ -0,0 +1,308 @@
+/**
+ * PostgreSQL MCP Prompts
+ *
+ * AI-powered prompts for query building, schema design, and optimization.
+ * 19 prompts total.
+ */
+// Import modular prompts
+import { createDatabaseHealthCheckPrompt } from "./health.js";
+import { createBackupStrategyPrompt } from "./backup.js";
+import { createIndexTuningPrompt } from "./indexTuning.js";
+import { createExtensionSetupPrompt } from "./extensionSetup.js";
+import { createSetupPgvectorPrompt } from "./pgvector.js";
+import { createSetupPostgisPrompt } from "./postgis.js";
+import { createSetupPgcronPrompt } from "./pgcron.js";
+import { createSetupPartmanPrompt } from "./partman.js";
+import { createSetupKcachePrompt } from "./kcache.js";
+import { createSetupCitextPrompt } from "./citext.js";
+import { createSetupLtreePrompt } from "./ltree.js";
+import { createSetupPgcryptoPrompt } from "./pgcrypto.js";
+/**
+ * Get all PostgreSQL prompts
+ */
+export function getPostgresPrompts(adapter) {
+    const allToolDefinitions = adapter.getToolDefinitions();
+    return [
+        // Original prompts
+        createQueryBuilderPrompt(),
+        createSchemaDesignPrompt(),
+        createPerformanceAnalysisPrompt(),
+        createMigrationPrompt(),
+        createToolIndexPrompt(allToolDefinitions),
+        createQuickQueryPrompt(),
+        createQuickSchemaPrompt(),
+        // Migrated prompts from legacy postgres-mcp-server
+        createDatabaseHealthCheckPrompt(),
+        createBackupStrategyPrompt(),
+        createIndexTuningPrompt(),
+        createExtensionSetupPrompt(),
+        createSetupPgvectorPrompt(),
+        createSetupPostgisPrompt(),
+        // Extension setup prompts
+        createSetupPgcronPrompt(),
+        createSetupPartmanPrompt(),
+        createSetupKcachePrompt(),
+        createSetupCitextPrompt(),
+        createSetupLtreePrompt(),
+        createSetupPgcryptoPrompt(),
+    ];
+}
+function createQueryBuilderPrompt() {
+    return {
+        name: "pg_query_builder",
+        description: "Build a PostgreSQL query based on requirements. Specify tables and operation type.",
+        arguments: [
+            {
+                name: "tables",
+                description: "Comma-separated list of tables",
+                required: true,
+            },
+            {
+                name: "operation",
+                description: "Operation type: SELECT, INSERT, UPDATE, DELETE, JOIN, CTE",
+                required: true,
+            },
+        ],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (args, _context) => {
+            const tables = args["tables"] ?? "";
+            const operation = args["operation"] ?? "";
+            return `Please construct a PostgreSQL query for the following requirements:
+
+**Tables:** ${tables}
+**Operation:** ${operation}
+
+Consider these PostgreSQL best practices:
+1. Use parameterized queries ($1, $2, etc.) for all user input
+2. Include appropriate WHERE clauses to limit results
+3. Use RETURNING clause for INSERT/UPDATE/DELETE when appropriate
+4. Consider using CTEs (WITH queries) for complex logic
+5. Add LIMIT for SELECT queries when full results aren't needed
+6. Use proper index hints if performance is critical
+
+Please provide the SQL query with explanations for each part.`;
+        },
+    };
+}
+function createSchemaDesignPrompt() {
+    return {
+        name: "pg_schema_design",
+        description: "Design a database schema for a given use case.",
+        arguments: [
+            {
+                name: "useCase",
+                description: "Description of the use case or domain",
+                required: true,
+            },
+            {
+                name: "requirements",
+                description: "Specific requirements or constraints",
+                required: false,
+            },
+        ],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (args, _context) => {
+            const useCase = args["useCase"] ?? "";
+            const requirements = args["requirements"] ?? "";
+            return `Please design a PostgreSQL database schema for the following use case:
+
+**Use Case:** ${useCase}
+${requirements ? `**Requirements:** ${requirements}` : ""}
+
+Consider these PostgreSQL-specific features:
+1. Use appropriate data types (JSONB for flexible data, UUID for IDs, TIMESTAMPTZ for dates)
+2. Define proper primary keys and foreign key relationships
+3. Add CHECK constraints for data validation
+4. Consider using SERIAL or IDENTITY for auto-increment columns
+5. Plan for indexes on frequently queried columns
+6. Use schemas (namespaces) to organize related tables
+7. Consider table partitioning for large tables
+
+Please provide:
+- CREATE TABLE statements
+- Index recommendations
+- Constraint definitions
+- Any relevant views or functions`;
+        },
+    };
+}
+function createPerformanceAnalysisPrompt() {
+    return {
+        name: "pg_performance_analysis",
+        description: "Analyze a slow query and suggest optimizations.",
+        arguments: [
+            {
+                name: "query",
+                description: "The SQL query to analyze",
+                required: true,
+            },
+            {
+                name: "context",
+                description: "Additional context (table sizes, current indexes, etc.)",
+                required: false,
+            },
+        ],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (args, _context) => {
+            const query = args["query"] ?? "";
+            const context = args["context"] ?? "";
+            return `Please analyze this PostgreSQL query for performance issues:
+
+\`\`\`sql
+${query}
+\`\`\`
+${context ? `\n**Context:** ${context}` : ""}
+
+Use these PostgreSQL tools to investigate:
+1. \`pg_explain_analyze\` - Get execution plan with timing
+2. \`pg_explain_buffers\` - Check buffer usage
+3. \`pg_index_stats\` - Check if indexes are being used
+4. \`pg_table_stats\` - Check table access patterns
+5. \`pg_bloat_check\` - Check for table bloat
+
+Please analyze and recommend:
+- Missing indexes
+- Query rewrites
+- Configuration changes
+- Maintenance operations (VACUUM, ANALYZE)`;
+        },
+    };
+}
+function createMigrationPrompt() {
+    return {
+        name: "pg_migration",
+        description: "Generate a migration plan for a schema change.",
+        arguments: [
+            {
+                name: "change",
+                description: "Description of the change",
+                required: true,
+            },
+            { name: "table", description: "Target table name", required: false },
+        ],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (args, _context) => {
+            const change = args["change"] ?? "";
+            const table = args["table"] ?? "";
+            return `Please create a PostgreSQL migration plan for:
+
+**Change:** ${change}
+${table ? `**Table:** ${table}` : ""}
+
+Provide:
+1. **Up Migration** - SQL to apply the change
+2. **Down Migration** - SQL to rollback
+3. **Safety Considerations**:
+   - Will this lock the table?
+   - Should this use CONCURRENTLY?
+   - What's the estimated impact on production?
+4. **Testing Steps** - How to verify the migration worked
+5. **Rollback Plan** - Steps if something goes wrong
+
+Use PostgreSQL-specific features like:
+- ALTER TABLE ... ADD COLUMN ... (with DEFAULT for non-nullable)
+- CREATE INDEX CONCURRENTLY
+- Transaction wrappers where appropriate`;
+        },
+    };
+}
+function createToolIndexPrompt(tools) {
+    return {
+        name: "pg_tool_index",
+        description: "Get a compact index of all available PostgreSQL tools for discovery.",
+        arguments: [],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (_args, _context) => {
+            const grouped = new Map();
+            for (const tool of tools) {
+                const group = tool.group;
+                const groupTools = grouped.get(group) ?? [];
+                const firstSentence = tool.description.split(".")[0] ?? tool.description;
+                groupTools.push({
+                    name: tool.name,
+                    desc: firstSentence,
+                });
+                grouped.set(group, groupTools);
+            }
+            const lines = [
+                `# PostgreSQL MCP Tools (${String(tools.length)} total)`,
+                "",
+                "Use specific tool names when needed. Ask for details about any tool.",
+                "",
+            ];
+            for (const [group, groupTools] of grouped) {
+                lines.push(`## ${group} (${String(groupTools.length)})`);
+                for (const t of groupTools) {
+                    lines.push(`- \`${t.name}\`: ${t.desc}`);
+                }
+                lines.push("");
+            }
+            return lines.join("\n");
+        },
+    };
+}
+function createQuickQueryPrompt() {
+    return {
+        name: "pg_quick_query",
+        description: "Quick SQL query guidance for common operations.",
+        arguments: [
+            {
+                name: "action",
+                description: 'What you want to do (e.g., "find users by email")',
+                required: true,
+            },
+        ],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (args, _context) => {
+            const action = args["action"] ?? "";
+            return `To "${action}" in PostgreSQL, use:
+
+**Tool:** \`pg_read_query\` for SELECT, \`pg_write_query\` for INSERT/UPDATE/DELETE
+
+**Example pattern:**
+\`\`\`sql
+-- For read operations
+SELECT * FROM table_name WHERE condition = $1;
+
+-- For write operations
+INSERT INTO table_name (col1, col2) VALUES ($1, $2) RETURNING *;
+UPDATE table_name SET col1 = $1 WHERE condition = $2 RETURNING *;
+DELETE FROM table_name WHERE condition = $1 RETURNING *;
+\`\`\`
+
+Provide your specific requirements and I'll help construct the exact query.`;
+        },
+    };
+}
+function createQuickSchemaPrompt() {
+    return {
+        name: "pg_quick_schema",
+        description: "Quick reference for exploring database schema.",
+        arguments: [],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (_args, _context) => {
+            return `# Quick Schema Exploration
+
+**List all tables:**
+\`pg_list_tables\`
+
+**Describe a table:**
+\`pg_describe_table\` with table name
+
+**List schemas:**
+\`pg_list_schemas\`
+
+**View indexes:**
+\`pg_get_indexes\` with table name
+
+**Full schema export:**
+Access resource: \`postgres://schema\`
+
+**Schema statistics:**
+Access resource: \`postgres://stats\`
+
+What would you like to explore?`;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Index Tuning Prompt
+ *
+ * Comprehensive index analysis and optimization workflow.
+ */
+import type { PromptDefinition } from "../../../types/index.js";
+export declare function createIndexTuningPrompt(): PromptDefinition;
+//# sourceMappingURL=indexTuning.d.ts.map

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

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

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

@@ -0,0 +1,130 @@
+/**
+ * Index Tuning Prompt
+ *
+ * Comprehensive index analysis and optimization workflow.
+ */
+export function createIndexTuningPrompt() {
+    return {
+        name: "pg_index_tuning",
+        description: "Comprehensive index analysis covering unused, missing, and duplicate indexes.",
+        arguments: [
+            {
+                name: "schema",
+                description: "Schema name to analyze (default: public)",
+                required: false,
+            },
+            {
+                name: "focus",
+                description: "Focus area: all, unused, missing, duplicate",
+                required: false,
+            },
+        ],
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (args, _context) => {
+            const schema = args["schema"] ?? "public";
+            const focus = args["focus"] ?? "all";
+            let content = `# Index Tuning Workflow - Schema: ${schema}
+
+Focus Area: **${focus.charAt(0).toUpperCase() + focus.slice(1)}**
+
+## Analysis Steps
+
+### 1. Current Index Usage
+
+\`\`\`sql
+SELECT
+    schemaname,
+    relname as tablename,
+    indexrelname as indexname,
+    idx_scan as index_scans,
+    pg_size_pretty(pg_relation_size(indexrelid)) as index_size
+FROM pg_stat_user_indexes
+WHERE schemaname = '${schema}'
+ORDER BY idx_scan ASC;
+\`\`\`
+
+Use \`pg_index_stats\` for detailed analysis.
+
+**What to look for:**
+- idx_scan = 0 → Never used (candidates for removal)
+- Large indexes with low scan counts → Expensive but rarely useful
+`;
+            if (focus === "unused" || focus === "all") {
+                content += `
+### 2. Unused Indexes
+
+\`\`\`sql
+SELECT indexrelname as indexname, pg_size_pretty(pg_relation_size(indexrelid)) as size
+FROM pg_stat_user_indexes
+WHERE idx_scan = 0 AND schemaname = '${schema}';
+\`\`\`
+
+**Before dropping:**
+- Consider grace period (index might be for monthly reports)
+- Check with application team
+- Calculate storage savings
+`;
+            }
+            if (focus === "missing" || focus === "all") {
+                content += `
+### 3. Missing Indexes
+
+Use \`pg_analyze_workload_indexes\` to find:
+- Queries with sequential scans on large tables
+- Joins without appropriate indexes
+- WHERE clauses on unindexed columns
+
+Test recommendations with \`pg_explain_analyze\` and hypothetical indexes.
+`;
+            }
+            if (focus === "duplicate" || focus === "all") {
+                content += `
+### 4. Duplicate/Redundant Indexes
+
+\`\`\`sql
+SELECT
+    t.tablename,
+    array_agg(i.indexname) as index_names,
+    i.indexdef
+FROM pg_indexes i
+JOIN pg_tables t ON i.tablename = t.tablename
+WHERE t.schemaname = '${schema}'
+GROUP BY t.tablename, i.indexdef
+HAVING COUNT(*) > 1;
+\`\`\`
+
+**Redundant patterns:**
+- Index on (a, b) makes index on (a) redundant
+- Multiple indexes with same columns in different order
+`;
+            }
+            content += `
+### 5. Action Plan
+
+**High Priority:**
+- Drop unused indexes (immediate space savings)
+- Add missing indexes for top slow queries
+
+**Medium Priority:**
+- Replace redundant indexes
+- Rebuild bloated indexes
+
+### 6. Safe Implementation
+
+\`\`\`sql
+-- Safe index creation (doesn't block table)
+CREATE INDEX CONCURRENTLY idx_name ON table(column);
+
+-- Safe index removal
+BEGIN;
+DROP INDEX IF EXISTS idx_old_unused;
+-- Test queries here
+COMMIT; -- or ROLLBACK if issues
+\`\`\`
+
+**Pro Tip:** Use CONCURRENTLY when creating indexes on production databases!`;
+            return content;
+        },
+    };
+}
+//# sourceMappingURL=indexTuning.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexTuning.js","sourceRoot":"","sources":["../../../../src/adapters/postgresql/prompts/indexTuning.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,+EAA+E;QACjF,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;gBACvD,QAAQ,EAAE,KAAK;aAChB;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,6CAA6C;gBAC1D,QAAQ,EAAE,KAAK;aAChB;SACF;QACD,4DAA4D;QAC5D,OAAO,EAAE,KAAK,EACZ,IAA4B,EAC5B,QAAwB,EACP,EAAE;YACnB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;YAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;YAErC,IAAI,OAAO,GAAG,qCAAqC,MAAM;;gBAE/C,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;;;;;;;;;;;;;;sBAcxC,MAAM;;;;;;;;;CAS3B,CAAC;YAEI,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC1C,OAAO,IAAI;;;;;;uCAMoB,MAAM;;;;;;;CAO5C,CAAC;YACI,CAAC;YAED,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC3C,OAAO,IAAI;;;;;;;;;CASlB,CAAC;YACI,CAAC;YAED,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC7C,OAAO,IAAI;;;;;;;;;;wBAUK,MAAM;;;;;;;;CAQ7B,CAAC;YACI,CAAC;YAED,OAAO,IAAI;;;;;;;;;;;;;;;;;;;;;;;;6EAwB4D,CAAC;YAExE,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * pg_stat_kcache Setup Prompt
+ *
+ * Complete guide for setting up OS-level performance monitoring with pg_stat_kcache.
+ */
+import type { PromptDefinition } from "../../../types/index.js";
+export declare function createSetupKcachePrompt(): PromptDefinition;
+//# sourceMappingURL=kcache.d.ts.map

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

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