@neverinfamous/postgres-mcp 1.0.1

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

@@ -0,0 +1,264 @@
+/**
+ * postgres-mcp - pg_partman Tool Schemas
+ *
+ * Input validation schemas for automated partition management.
+ * Includes parameter preprocessing to smooth common agent input mistakes.
+ */
+import { z } from "zod";
+/**
+ * Preprocess partman parameters to normalize common input patterns:
+ * - table → parentTable (most common agent mistake)
+ * - column → controlColumn (for createParent)
+ * - Auto-prefix public. for parentTable when no schema specified
+ */
+/**
+ * Deprecated interval keywords that pg_partman no longer accepts.
+ * Maps legacy keywords to their PostgreSQL interval equivalents.
+ */
+const DEPRECATED_INTERVALS = {
+    daily: "1 day",
+    weekly: "1 week",
+    monthly: "1 month",
+    quarterly: "3 months",
+    yearly: "1 year",
+    hourly: "1 hour",
+};
+function preprocessPartmanParams(input) {
+    if (typeof input !== "object" || input === null) {
+        return input;
+    }
+    const raw = input;
+    const result = { ...raw };
+    // Alias: table → parentTable
+    if (result.table && !result.parentTable) {
+        result.parentTable = result.table;
+    }
+    // Alias: parent → parentTable (documented in ServerInstructions)
+    if (result.parent && !result.parentTable) {
+        result.parentTable = result.parent;
+    }
+    // Alias: name → parentTable (documented in ServerInstructions)
+    if (result.name && !result.parentTable) {
+        result.parentTable = result.name;
+    }
+    // Alias: column → controlColumn
+    if (result.column && !result.controlColumn) {
+        result.controlColumn = result.column;
+    }
+    // Alias: control → controlColumn (pg_partman native terminology)
+    if (result.control && !result.controlColumn) {
+        result.controlColumn = result.control;
+    }
+    // Alias: partitionColumn → controlColumn (consistent with other partition tools)
+    if (result.partitionColumn && !result.controlColumn) {
+        result.controlColumn = result.partitionColumn;
+    }
+    // Alias: target → targetTable
+    if (result.target && !result.targetTable) {
+        result.targetTable = result.target;
+    }
+    // Alias: partitionInterval → interval (more intuitive name)
+    if (result.partitionInterval && !result.interval) {
+        result.interval = result.partitionInterval;
+    }
+    // Alias: keepTable → retentionKeepTable
+    if (result.keepTable !== undefined &&
+        result.retentionKeepTable === undefined) {
+        result.retentionKeepTable = result.keepTable;
+    }
+    // Auto-prefix public. for parentTable when no schema specified
+    if (result.parentTable && !result.parentTable.includes(".")) {
+        result.parentTable = `public.${result.parentTable}`;
+    }
+    return result;
+}
+/**
+ * Schema for creating a partition set with pg_partman.
+ * Uses partman.create_parent() function.
+ */
+export const PartmanCreateParentSchema = z
+    .preprocess(preprocessPartmanParams, z.object({
+    parentTable: z
+        .string()
+        .optional()
+        .describe("Parent table name (schema.table format). Required."),
+    controlColumn: z
+        .string()
+        .optional()
+        .describe("Column used for partitioning (timestamp or integer). Alias: control. Required."),
+    interval: z
+        .string()
+        .optional()
+        .superRefine((val, ctx) => {
+        if (!val)
+            return; // Skip validation for undefined
+        const deprecated = DEPRECATED_INTERVALS[val.toLowerCase()];
+        if (deprecated) {
+            ctx.addIssue({
+                code: "custom",
+                message: `Deprecated interval '${val}'. Use PostgreSQL interval syntax instead: '${deprecated}'. Examples: '1 day', '1 week', '1 month'`,
+            });
+        }
+    })
+        .describe('Partition interval using PostgreSQL syntax (e.g., "1 month", "1 day", "1 week", "10000" for integer). Required.'),
+    premake: z
+        .number()
+        .optional()
+        .describe("Number of partitions to create in advance (default: 4)"),
+    startPartition: z
+        .string()
+        .optional()
+        .describe("Starting value for first partition (timestamp or integer)"),
+    templateTable: z
+        .string()
+        .optional()
+        .describe("Template table for indexes/privileges (schema.table format)"),
+    epochType: z
+        .enum(["seconds", "milliseconds", "nanoseconds"])
+        .optional()
+        .describe("If control column is integer representing epoch time"),
+    defaultPartition: z
+        .boolean()
+        .optional()
+        .describe("Create a default partition (default: true)"),
+}))
+    .default({});
+/**
+ * Schema for running partition maintenance.
+ * Uses partman.run_maintenance() or run_maintenance_proc().
+ */
+export const PartmanRunMaintenanceSchema = z
+    .preprocess(preprocessPartmanParams, z.object({
+    parentTable: z
+        .string()
+        .optional()
+        .describe("Specific parent table to maintain (all if omitted)"),
+    analyze: z
+        .boolean()
+        .optional()
+        .describe("Run ANALYZE on new partitions (default: true)"),
+}))
+    .default({});
+/**
+ * Schema for listing managed partitions.
+ * Uses partman.show_partitions() function.
+ */
+export const PartmanShowPartitionsSchema = z
+    .preprocess(preprocessPartmanParams, z.object({
+    parentTable: z
+        .string()
+        .optional()
+        .describe("Parent table name (schema.table format). Required - specify table to list partitions."),
+    includeDefault: z
+        .boolean()
+        .optional()
+        .describe("Include default partition in results"),
+    order: z
+        .enum(["asc", "desc"])
+        .optional()
+        .describe("Order of partitions by boundary"),
+    limit: z
+        .number()
+        .optional()
+        .describe("Maximum number of partitions to return (default: 50, use 0 for all)"),
+}))
+    .default({});
+/**
+ * Schema for checking data in default partition.
+ * Uses partman.check_default() function.
+ */
+export const PartmanCheckDefaultSchema = z
+    .preprocess(preprocessPartmanParams, z.object({
+    parentTable: z
+        .string()
+        .optional()
+        .describe("Parent table name to check. Required - specify table to check default partition."),
+}))
+    .default({});
+/**
+ * Schema for moving data from default to child partitions.
+ * Uses partman.partition_data_* functions.
+ */
+export const PartmanPartitionDataSchema = z
+    .preprocess(preprocessPartmanParams, z.object({
+    parentTable: z
+        .string()
+        .optional()
+        .describe("Parent table name (schema.table format). Required - specify table to partition data."),
+    batchSize: z
+        .number()
+        .optional()
+        .describe("Rows to move per batch (default: varies by function)"),
+    lockWaitSeconds: z
+        .number()
+        .optional()
+        .describe("Lock wait timeout in seconds"),
+}))
+    .default({});
+/**
+ * Schema for configuring retention policies.
+ * Updates partman.part_config table.
+ */
+export const PartmanRetentionSchema = z
+    .preprocess(preprocessPartmanParams, z.object({
+    parentTable: z
+        .string()
+        .optional()
+        .describe("Parent table name (schema.table format). Required."),
+    retention: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Retention period (e.g., "30 days"). Pass null or omit to disable/clear retention.'),
+    retentionKeepTable: z
+        .boolean()
+        .optional()
+        .describe("Keep tables after detaching (true) or drop them (false). Default: false (DROP). Use true to preserve partition data."),
+}))
+    .default({});
+/**
+ * Schema for undoing partitioning.
+ * Converts a partitioned table back to a regular table.
+ */
+export const PartmanUndoPartitionSchema = z
+    .preprocess(preprocessPartmanParams, z.object({
+    parentTable: z
+        .string()
+        .optional()
+        .describe("Parent table to convert back to regular table. Required."),
+    targetTable: z
+        .string()
+        .optional()
+        .describe("Target table for consolidated data. Must exist before calling. Alias: target. Required."),
+    batchSize: z.number().optional().describe("Rows to move per batch"),
+    keepTable: z
+        .boolean()
+        .optional()
+        .describe("Keep child tables after moving data"),
+}))
+    .default({});
+/**
+ * Schema for updating partition configuration.
+ */
+export const PartmanUpdateConfigSchema = z.preprocess(preprocessPartmanParams, z.object({
+    parentTable: z.string().describe("Parent table name (schema.table format)"),
+    premake: z.number().optional().describe("Number of partitions to pre-make"),
+    optimizeTrigger: z
+        .number()
+        .optional()
+        .describe("Trigger optimization threshold"),
+    optimizeConstraint: z
+        .number()
+        .optional()
+        .describe("Constraint optimization threshold"),
+    inheritFk: z
+        .boolean()
+        .optional()
+        .describe("Inherit foreign keys to children"),
+    retention: z.string().optional().describe("Retention period"),
+    retentionKeepTable: z
+        .boolean()
+        .optional()
+        .describe("Keep tables after detaching"),
+}));
+//# sourceMappingURL=partman.js.map

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * postgres-mcp - Performance Tool Schemas
+ *
+ * Input validation schemas for query analysis and performance monitoring.
+ */
+import { z } from "zod";
+/**
+ * Preprocess explain params to normalize aliases.
+ * Exported so tools can apply it in their handlers.
+ */
+export declare function preprocessExplainParams(input: unknown): unknown;
+/**
+ * Base schema for EXPLAIN tools - used for MCP inputSchema visibility.
+ * Shows sql as required so MCP clients prompt for it.
+ */
+export declare const ExplainSchemaBase: z.ZodObject<{
+    sql: z.ZodString;
+    params: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    analyze: z.ZodOptional<z.ZodBoolean>;
+    buffers: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        json: "json";
+        xml: "xml";
+        yaml: "yaml";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Full schema with preprocessing for alias support.
+ * Used in handler to parse params after MCP has collected them.
+ */
+export declare const ExplainSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    sql: z.ZodString;
+    params: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    analyze: z.ZodOptional<z.ZodBoolean>;
+    buffers: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        json: "json";
+        xml: "xml";
+        yaml: "yaml";
+    }>>;
+}, z.core.$strip>>;
+export declare const IndexStatsSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const TableStatsSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=performance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/schemas/performance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAY/D;AAMD;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAS5B,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;kBAGzB,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;kBAM5B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;kBAM5B,CAAC"}

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

@@ -0,0 +1,57 @@
+/**
+ * postgres-mcp - Performance Tool Schemas
+ *
+ * Input validation schemas for query analysis and performance monitoring.
+ */
+import { z } from "zod";
+// Helper to handle undefined params (allows tools to be called without {})
+const defaultToEmpty = (val) => val ?? {};
+/**
+ * Preprocess explain params to normalize aliases.
+ * Exported so tools can apply it in their handlers.
+ */
+export function preprocessExplainParams(input) {
+    if (typeof input !== "object" || input === null) {
+        return input;
+    }
+    const result = { ...input };
+    // Alias: query → sql
+    if (result["query"] !== undefined && result["sql"] === undefined) {
+        result["sql"] = result["query"];
+    }
+    return result;
+}
+// =============================================================================
+// Base Schema (for MCP inputSchema visibility - no preprocess)
+// =============================================================================
+/**
+ * Base schema for EXPLAIN tools - used for MCP inputSchema visibility.
+ * Shows sql as required so MCP clients prompt for it.
+ */
+export const ExplainSchemaBase = z.object({
+    sql: z.string().describe("Query to explain"),
+    params: z.array(z.unknown()).optional().describe("Query parameters"),
+    analyze: z.boolean().optional().describe("Run EXPLAIN ANALYZE"),
+    buffers: z.boolean().optional().describe("Include buffer usage"),
+    format: z
+        .enum(["text", "json", "xml", "yaml"])
+        .optional()
+        .describe("Output format"),
+});
+// =============================================================================
+// Full Schema (with preprocess - for handler parsing)
+// =============================================================================
+/**
+ * Full schema with preprocessing for alias support.
+ * Used in handler to parse params after MCP has collected them.
+ */
+export const ExplainSchema = z.preprocess(preprocessExplainParams, ExplainSchemaBase);
+export const IndexStatsSchema = z.preprocess(defaultToEmpty, z.object({
+    table: z.string().optional().describe("Table name (all tables if omitted)"),
+    schema: z.string().optional().describe("Schema name"),
+}));
+export const TableStatsSchema = z.preprocess(defaultToEmpty, z.object({
+    table: z.string().optional().describe("Table name (all tables if omitted)"),
+    schema: z.string().optional().describe("Schema name"),
+}));
+//# sourceMappingURL=performance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../../../src/adapters/postgresql/schemas/performance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2EAA2E;AAC3E,MAAM,cAAc,GAAG,CAAC,GAAY,EAAW,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,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;IAEzD,qBAAqB;IACrB,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,+DAA+D;AAC/D,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAChE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;SACrC,QAAQ,EAAE;SACV,QAAQ,CAAC,eAAe,CAAC;CAC7B,CAAC,CAAC;AAEH,gFAAgF;AAChF,sDAAsD;AACtD,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,UAAU,CACvC,uBAAuB,EACvB,iBAAiB,CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,UAAU,CAC1C,cAAc,EACd,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;CACtD,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,UAAU,CAC1C,cAAc,EACd,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;CACtD,CAAC,CACH,CAAC"}