@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/tools/core/query.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PostgreSQL Core Tools - Query Operations
+ *
+ * Read and write query tools.
+ */
+import type { PostgresAdapter } from "../../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../../types/index.js";
+/**
+ * Execute a read-only SQL query
+ */
+export declare function createReadQueryTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Execute a write SQL query
+ */
+export declare function createWriteQueryTool(adapter: PostgresAdapter): ToolDefinition;
+//# sourceMappingURL=query.d.ts.map

package/dist/adapters/postgresql/tools/core/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/core/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AAUpC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAyC5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAgD7E"}

package/dist/adapters/postgresql/tools/core/query.js

@@ -0,0 +1,87 @@
+/**
+ * PostgreSQL Core Tools - Query Operations
+ *
+ * Read and write query tools.
+ */
+import { readOnly, write } from "../../../../utils/annotations.js";
+import { getToolIcons } from "../../../../utils/icons.js";
+import { ReadQuerySchemaBase, ReadQuerySchema, WriteQuerySchemaBase, WriteQuerySchema, } from "../../schemas/index.js";
+/**
+ * Execute a read-only SQL query
+ */
+export function createReadQueryTool(adapter) {
+    return {
+        name: "pg_read_query",
+        description: "Execute a read-only SQL query (SELECT, WITH). Returns rows as JSON. Pass transactionId to execute within a transaction.",
+        group: "core",
+        inputSchema: ReadQuerySchemaBase, // Base schema for MCP visibility (sql required)
+        annotations: readOnly("Read Query"),
+        icons: getToolIcons("core", readOnly("Read Query")),
+        handler: async (params, _context) => {
+            const { sql, params: queryParams, transactionId, } = ReadQuerySchema.parse(params);
+            let result;
+            if (transactionId !== undefined) {
+                const client = adapter.getTransactionConnection(transactionId);
+                if (!client) {
+                    throw new Error(`Invalid or expired transactionId: ${transactionId}. Use pg_transaction_begin to start a new transaction.`);
+                }
+                result = await adapter.executeOnConnection(client, sql, queryParams);
+            }
+            else {
+                result = await adapter.executeReadQuery(sql, queryParams);
+            }
+            return {
+                rows: result.rows,
+                rowCount: result.rows?.length ?? 0,
+                // Include column metadata if available
+                fields: result.fields?.map((f) => ({
+                    name: f.name,
+                    dataTypeID: f.dataTypeID,
+                })),
+                executionTimeMs: result.executionTimeMs,
+            };
+        },
+    };
+}
+/**
+ * Execute a write SQL query
+ */
+export function createWriteQueryTool(adapter) {
+    return {
+        name: "pg_write_query",
+        description: "Execute a write SQL query (INSERT, UPDATE, DELETE). Returns affected row count. Pass transactionId to execute within a transaction.",
+        group: "core",
+        inputSchema: WriteQuerySchemaBase, // Base schema for MCP visibility (sql required)
+        annotations: write("Write Query"),
+        icons: getToolIcons("core", write("Write Query")),
+        handler: async (params, _context) => {
+            const { sql, params: queryParams, transactionId, } = WriteQuerySchema.parse(params);
+            // Block SELECT statements - use pg_read_query instead
+            const trimmedUpper = sql.trim().toUpperCase();
+            if (trimmedUpper.startsWith("SELECT")) {
+                throw new Error("pg_write_query is for INSERT/UPDATE/DELETE only. Use pg_read_query for SELECT statements.");
+            }
+            let result;
+            if (transactionId !== undefined) {
+                const client = adapter.getTransactionConnection(transactionId);
+                if (!client) {
+                    throw new Error(`Invalid or expired transactionId: ${transactionId}. Use pg_transaction_begin to start a new transaction.`);
+                }
+                result = await adapter.executeOnConnection(client, sql, queryParams);
+            }
+            else {
+                result = await adapter.executeWriteQuery(sql, queryParams);
+            }
+            return {
+                rowsAffected: result.rowsAffected,
+                affectedRows: result.rowsAffected, // Alias for common API naming
+                rowCount: result.rowsAffected, // Alias for consistency
+                command: result.command,
+                executionTimeMs: result.executionTimeMs,
+                // Include returned rows when using RETURNING clause
+                ...(result.rows && result.rows.length > 0 && { rows: result.rows }),
+            };
+        },
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/adapters/postgresql/tools/core/query.js.map

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

package/dist/adapters/postgresql/tools/core/schemas.d.ts

@@ -0,0 +1,135 @@
+/**
+ * PostgreSQL Core Tools - Additional Schemas
+ *
+ * Schemas that are defined in core tools but not in the main schemas directory.
+ */
+import { z } from "zod";
+export declare const ListObjectsSchemaBase: z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        function: "function";
+        table: "table";
+        view: "view";
+        materialized_view: "materialized_view";
+        index: "index";
+        sequence: "sequence";
+        procedure: "procedure";
+        trigger: "trigger";
+    }>>>;
+    type: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ListObjectsSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        function: "function";
+        table: "table";
+        view: "view";
+        materialized_view: "materialized_view";
+        index: "index";
+        sequence: "sequence";
+        procedure: "procedure";
+        trigger: "trigger";
+    }>>>;
+    type: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+export declare const ObjectDetailsSchemaBase: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    object: z.ZodOptional<z.ZodString>;
+    objectName: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        function: "function";
+        table: "table";
+        view: "view";
+        materialized_view: "materialized_view";
+        partitioned_table: "partitioned_table";
+        index: "index";
+        sequence: "sequence";
+    }>>;
+    objectType: z.ZodOptional<z.ZodEnum<{
+        function: "function";
+        table: "table";
+        view: "view";
+        materialized_view: "materialized_view";
+        partitioned_table: "partitioned_table";
+        index: "index";
+        sequence: "sequence";
+    }>>;
+}, z.core.$strip>;
+export declare const ObjectDetailsSchema: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    object: z.ZodOptional<z.ZodString>;
+    objectName: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        function: "function";
+        table: "table";
+        view: "view";
+        materialized_view: "materialized_view";
+        partitioned_table: "partitioned_table";
+        index: "index";
+        sequence: "sequence";
+    }>>;
+    objectType: z.ZodOptional<z.ZodEnum<{
+        function: "function";
+        table: "table";
+        view: "view";
+        materialized_view: "materialized_view";
+        partitioned_table: "partitioned_table";
+        index: "index";
+        sequence: "sequence";
+    }>>;
+}, z.core.$strip>>, z.ZodTransform<{
+    name: string;
+    schema: string | undefined;
+    type: "function" | "table" | "view" | "materialized_view" | "partitioned_table" | "index" | "sequence" | undefined;
+}, {
+    name?: string | undefined;
+    object?: string | undefined;
+    objectName?: string | undefined;
+    table?: string | undefined;
+    schema?: string | undefined;
+    type?: "function" | "table" | "view" | "materialized_view" | "partitioned_table" | "index" | "sequence" | undefined;
+    objectType?: "function" | "table" | "view" | "materialized_view" | "partitioned_table" | "index" | "sequence" | undefined;
+}>>;
+export declare const AnalyzeDbHealthSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    includeIndexes: z.ZodOptional<z.ZodBoolean>;
+    includeVacuum: z.ZodOptional<z.ZodBoolean>;
+    includeConnections: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>;
+export declare const AnalyzeWorkloadIndexesSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    topQueries: z.ZodOptional<z.ZodNumber>;
+    minCalls: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+export declare const AnalyzeQueryIndexesSchemaBase: z.ZodObject<{
+    sql: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        summary: "summary";
+    }>>;
+}, z.core.$strip>;
+export declare const AnalyzeQueryIndexesSchema: z.ZodPipe<z.ZodObject<{
+    sql: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        summary: "summary";
+    }>>;
+}, z.core.$strip>, z.ZodTransform<{
+    sql: string;
+    params: unknown[] | undefined;
+    verbosity: "full" | "summary";
+}, {
+    sql?: string | undefined;
+    query?: string | undefined;
+    params?: unknown[] | undefined;
+    verbosity?: "full" | "summary" | undefined;
+}>>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/adapters/postgresql/tools/core/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/core/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBA4BhC,CAAC;AAGH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;kBAG7B,CAAC;AAuEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;iBAiClC,CAAC;AAGH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAS5B,CAAC;AAEL,eAAO,MAAM,qBAAqB;;;;kBAgBjC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;kBASxC,CAAC;AAGF,eAAO,MAAM,6BAA6B;;;;;;;;iBAaxC,CAAC;AAGH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;GAOlC,CAAC"}

package/dist/adapters/postgresql/tools/core/schemas.js

@@ -0,0 +1,221 @@
+/**
+ * PostgreSQL Core Tools - Additional Schemas
+ *
+ * Schemas that are defined in core tools but not in the main schemas directory.
+ */
+import { z } from "zod";
+// Helper to handle undefined params (allows tools to be called without {})
+const defaultToEmpty = (val) => val ?? {};
+/**
+ * Preprocess list objects params for type/types alias handling
+ */
+function preprocessListObjectsParams(input) {
+    if (input === undefined || input === null)
+        return {};
+    if (typeof input !== "object")
+        return input;
+    const result = { ...input };
+    // Handle 'type' as alias for 'types' (support singular form)
+    if (result["types"] === undefined && result["type"] !== undefined) {
+        const typeValue = result["type"];
+        // Convert single string to array
+        if (typeof typeValue === "string") {
+            result["types"] = [typeValue];
+        }
+        else if (Array.isArray(typeValue)) {
+            result["types"] = typeValue;
+        }
+        delete result["type"];
+    }
+    // If types is a single string, wrap in array
+    if (typeof result["types"] === "string") {
+        result["types"] = [result["types"]];
+    }
+    return result;
+}
+// Base schema for MCP visibility - exposes all parameters without transform
+export const ListObjectsSchemaBase = z.object({
+    schema: z
+        .string()
+        .optional()
+        .describe("Schema name (default: all user schemas)"),
+    types: z
+        .array(z.enum([
+        "table",
+        "view",
+        "materialized_view",
+        "function",
+        "procedure",
+        "sequence",
+        "index",
+        "trigger",
+    ]))
+        .optional()
+        .describe("Object types to include"),
+    type: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe("Alias for types (singular or array)"),
+    limit: z
+        .number()
+        .optional()
+        .describe("Maximum number of objects to return (default: 100)"),
+});
+// Transformed schema with preprocess for handler parsing
+export const ListObjectsSchema = z.preprocess(preprocessListObjectsParams, ListObjectsSchemaBase);
+// Inner schema for ObjectDetails (used by preprocess and as base for MCP visibility)
+const ObjectDetailsInnerSchema = z.object({
+    name: z
+        .string()
+        .optional()
+        .describe("Object name (supports schema.name format)"),
+    object: z.string().optional().describe("Alias for name"),
+    objectName: z.string().optional().describe("Alias for name (Code Mode API)"),
+    table: z.string().optional().describe("Alias for name"),
+    schema: z.string().optional().describe("Schema name (default: public)"),
+    type: z
+        .enum([
+        "table",
+        "view",
+        "materialized_view",
+        "partitioned_table",
+        "function",
+        "sequence",
+        "index",
+    ])
+        .optional()
+        .describe("Object type hint (case-insensitive)"),
+    objectType: z
+        .enum([
+        "table",
+        "view",
+        "materialized_view",
+        "partitioned_table",
+        "function",
+        "sequence",
+        "index",
+    ])
+        .optional()
+        .describe("Alias for type"),
+});
+// Preprocess function for ObjectDetails
+function preprocessObjectDetailsParams(val) {
+    const obj = (val ?? {});
+    // Support 'table', 'object', and 'objectName' as aliases for 'name'
+    if (obj["name"] === undefined) {
+        if (obj["table"] !== undefined)
+            obj["name"] = obj["table"];
+        else if (obj["object"] !== undefined)
+            obj["name"] = obj["object"];
+        else if (obj["objectName"] !== undefined)
+            obj["name"] = obj["objectName"];
+    }
+    // Parse schema.name format if schema not explicitly provided
+    if (typeof obj["name"] === "string" &&
+        obj["name"].includes(".") &&
+        obj["schema"] === undefined) {
+        const parts = obj["name"].split(".");
+        if (parts.length === 2) {
+            obj["schema"] = parts[0];
+            obj["name"] = parts[1];
+        }
+    }
+    // Normalize 'type' and 'objectType' to lowercase for case-insensitivity
+    if (typeof obj["type"] === "string") {
+        obj["type"] = obj["type"].toLowerCase();
+    }
+    if (typeof obj["objectType"] === "string") {
+        obj["objectType"] = obj["objectType"].toLowerCase();
+    }
+    return obj;
+}
+// Base schema for MCP visibility - exported directly without preprocess wrapper
+// so MCP clients can see all input parameters
+export const ObjectDetailsSchemaBase = z.object({
+    name: z
+        .string()
+        .optional()
+        .describe("Object name (supports schema.name format)"),
+    object: z.string().optional().describe("Alias for name"),
+    objectName: z.string().optional().describe("Alias for name (Code Mode API)"),
+    table: z.string().optional().describe("Alias for name"),
+    schema: z.string().optional().describe("Schema name (default: public)"),
+    type: z
+        .enum([
+        "table",
+        "view",
+        "materialized_view",
+        "partitioned_table",
+        "function",
+        "sequence",
+        "index",
+    ])
+        .optional()
+        .describe("Object type hint (case-insensitive)"),
+    objectType: z
+        .enum([
+        "table",
+        "view",
+        "materialized_view",
+        "partitioned_table",
+        "function",
+        "sequence",
+        "index",
+    ])
+        .optional()
+        .describe("Alias for type"),
+});
+// Full schema with transform for handler parsing
+export const ObjectDetailsSchema = z
+    .preprocess(preprocessObjectDetailsParams, ObjectDetailsInnerSchema)
+    .transform((data) => ({
+    name: data.name ?? data.object ?? data.objectName ?? data.table ?? "",
+    schema: data.schema,
+    type: data.type ?? data.objectType,
+}))
+    .refine((data) => data.name !== "", {
+    message: "name (or object/objectName/table alias) is required",
+});
+export const AnalyzeDbHealthSchema = z.preprocess(defaultToEmpty, z.object({
+    includeIndexes: z
+        .boolean()
+        .optional()
+        .describe("Include unused indexes analysis (default: true)"),
+    includeVacuum: z
+        .boolean()
+        .optional()
+        .describe("Include tables needing vacuum analysis (default: true)"),
+    includeConnections: z
+        .boolean()
+        .optional()
+        .describe("Include connection stats (default: true)"),
+}));
+export const AnalyzeWorkloadIndexesSchema = z.preprocess(defaultToEmpty, z.object({
+    topQueries: z
+        .number()
+        .optional()
+        .describe("Number of top queries to analyze (default: 20)"),
+    minCalls: z.number().optional().describe("Minimum call count threshold"),
+}));
+// Base schema for MCP visibility - exported so tool can use it for inputSchema
+export const AnalyzeQueryIndexesSchemaBase = z.object({
+    sql: z
+        .string()
+        .optional()
+        .describe("Query to analyze for index recommendations"),
+    query: z.string().optional().describe("Alias for sql"),
+    params: z.array(z.unknown()).optional().describe("Query parameters"),
+    verbosity: z
+        .enum(["summary", "full"])
+        .optional()
+        .describe("Response detail level: 'summary' (compact), 'full' (include full plan). Default: summary"),
+});
+// Transformed schema with alias resolution
+export const AnalyzeQueryIndexesSchema = AnalyzeQueryIndexesSchemaBase.transform((data) => ({
+    sql: data.sql ?? data.query ?? "",
+    params: data.params,
+    verbosity: data.verbosity ?? "summary",
+})).refine((data) => data.sql !== "", {
+    message: "sql (or query alias) is required",
+});
+//# sourceMappingURL=schemas.js.map

package/dist/adapters/postgresql/tools/core/schemas.js.map

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

package/dist/adapters/postgresql/tools/core/tables.d.ts

@@ -0,0 +1,24 @@
+/**
+ * PostgreSQL Core Tools - Table Operations
+ *
+ * Table listing, description, creation, and deletion tools.
+ */
+import type { PostgresAdapter } from "../../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../../types/index.js";
+/**
+ * List all tables in the database
+ */
+export declare function createListTablesTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Describe a table's structure
+ */
+export declare function createDescribeTableTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Create a new table
+ */
+export declare function createCreateTableTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Drop a table
+ */
+export declare function createDropTableTool(adapter: PostgresAdapter): ToolDefinition;
+//# sourceMappingURL=tables.d.ts.map

package/dist/adapters/postgresql/tools/core/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/core/tables.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AAapC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAoC7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,cAAc,CA0DhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,GACvB,cAAc,CA6GhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAmC5E"}