@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/tools/ltree.js

@@ -0,0 +1,390 @@
+/**
+ * PostgreSQL ltree Extension Tools
+ * 8 tools total.
+ */
+import { z } from "zod";
+import { readOnly, write } from "../../../utils/annotations.js";
+import { getToolIcons } from "../../../utils/icons.js";
+import { LtreeQuerySchema, LtreeQuerySchemaBase, LtreeSubpathSchema, LtreeSubpathSchemaBase, LtreeLcaSchema, LtreeMatchSchema, LtreeMatchSchemaBase, LtreeListColumnsSchema, LtreeConvertColumnSchema, LtreeConvertColumnSchemaBase, LtreeIndexSchema, LtreeIndexSchemaBase, } from "../schemas/index.js";
+export function getLtreeTools(adapter) {
+    return [
+        createLtreeExtensionTool(adapter),
+        createLtreeQueryTool(adapter),
+        createLtreeSubpathTool(adapter),
+        createLtreeLcaTool(adapter),
+        createLtreeMatchTool(adapter),
+        createLtreeListColumnsTool(adapter),
+        createLtreeConvertColumnTool(adapter),
+        createLtreeCreateIndexTool(adapter),
+    ];
+}
+function createLtreeExtensionTool(adapter) {
+    return {
+        name: "pg_ltree_create_extension",
+        description: "Enable the ltree extension for hierarchical tree-structured labels.",
+        group: "ltree",
+        inputSchema: z.object({}),
+        annotations: write("Create Ltree Extension"),
+        icons: getToolIcons("ltree", write("Create Ltree Extension")),
+        handler: async (_params, _context) => {
+            await adapter.executeQuery("CREATE EXTENSION IF NOT EXISTS ltree");
+            return { success: true, message: "ltree extension enabled" };
+        },
+    };
+}
+function createLtreeQueryTool(adapter) {
+    return {
+        name: "pg_ltree_query",
+        description: "Query hierarchical relationships in ltree columns. Supports exact paths (descendants/ancestors) and lquery patterns with wildcards.",
+        group: "ltree",
+        inputSchema: LtreeQuerySchemaBase, // Base schema for MCP visibility
+        annotations: readOnly("Query Ltree"),
+        icons: getToolIcons("ltree", readOnly("Query Ltree")),
+        handler: async (params, _context) => {
+            const { table, column, path, mode, schema, limit } = LtreeQuerySchema.parse(params);
+            const schemaName = schema ?? "public";
+            const queryMode = mode ?? "descendants";
+            const qualifiedTable = `"${schemaName}"."${table}"`;
+            const limitClause = limit !== undefined ? `LIMIT ${String(limit)}` : "";
+            // Validate column is ltree type
+            const colCheck = await adapter.executeQuery(`SELECT udt_name FROM information_schema.columns WHERE table_schema = $1 AND table_name = $2 AND column_name = $3`, [schemaName, table, column]);
+            if (!colCheck.rows || colCheck.rows.length === 0) {
+                return {
+                    success: false,
+                    error: `Column "${column}" not found in table ${qualifiedTable}.`,
+                };
+            }
+            const udtName = colCheck.rows[0]?.["udt_name"];
+            if (udtName !== "ltree") {
+                return {
+                    success: false,
+                    error: `Column "${column}" is not an ltree type (found: ${udtName}). Use an ltree column or convert with pg_ltree_convert_column.`,
+                };
+            }
+            // Detect if path contains lquery pattern characters
+            const isLqueryPattern = /[*?{!@|]/.test(path);
+            // Get total count when limit is applied for truncation indicators
+            let totalCount;
+            if (limit !== undefined) {
+                let countSql;
+                if (isLqueryPattern) {
+                    countSql = `SELECT COUNT(*)::int as total FROM ${qualifiedTable} WHERE "${column}" ~ $1::lquery`;
+                }
+                else {
+                    let operator;
+                    switch (queryMode) {
+                        case "ancestors":
+                            operator = "@>";
+                            break;
+                        case "exact":
+                            operator = "=";
+                            break;
+                        default:
+                            operator = "<@";
+                    }
+                    countSql = `SELECT COUNT(*)::int as total FROM ${qualifiedTable} WHERE "${column}" ${operator} $1::ltree`;
+                }
+                const countResult = await adapter.executeQuery(countSql, [path]);
+                totalCount = countResult.rows?.[0]?.["total"];
+            }
+            let sql;
+            if (isLqueryPattern) {
+                // Use lquery pattern matching with ~ operator
+                sql = `SELECT *, nlevel("${column}") as depth FROM ${qualifiedTable} WHERE "${column}" ~ $1::lquery ORDER BY "${column}" ${limitClause}`;
+            }
+            else {
+                // Use standard ltree hierarchy operators
+                // @> means "is ancestor of" (left contains right)
+                // <@ means "is descendant of" (left is contained by right)
+                let operator;
+                switch (queryMode) {
+                    // ancestors: column @> path means column contains path, i.e., column is ancestor of path
+                    case "ancestors":
+                        operator = "@>";
+                        break;
+                    case "exact":
+                        operator = "=";
+                        break;
+                    // descendants: column <@ path means column is contained by path, i.e., column is descendant of path
+                    default:
+                        operator = "<@";
+                }
+                sql = `SELECT *, nlevel("${column}") as depth FROM ${qualifiedTable} WHERE "${column}" ${operator} $1::ltree ORDER BY "${column}" ${limitClause}`;
+            }
+            const result = await adapter.executeQuery(sql, [path]);
+            const resultCount = result.rows?.length ?? 0;
+            const response = {
+                path,
+                mode: isLqueryPattern ? "pattern" : queryMode,
+                isPattern: isLqueryPattern,
+                results: result.rows ?? [],
+                count: resultCount,
+            };
+            // Add truncation indicators when limit is applied
+            if (limit !== undefined && totalCount !== undefined) {
+                response["truncated"] = resultCount < totalCount;
+                response["totalCount"] = totalCount;
+            }
+            return response;
+        },
+    };
+}
+function createLtreeSubpathTool(adapter) {
+    return {
+        name: "pg_ltree_subpath",
+        description: "Extract a portion of an ltree path.",
+        group: "ltree",
+        inputSchema: LtreeSubpathSchemaBase, // Base schema for MCP visibility
+        annotations: readOnly("Ltree Subpath"),
+        icons: getToolIcons("ltree", readOnly("Ltree Subpath")),
+        handler: async (params, _context) => {
+            const { path, offset, length } = LtreeSubpathSchema.parse(params);
+            // First get the path depth for validation
+            const depthResult = await adapter.executeQuery(`SELECT nlevel($1::ltree) as depth`, [path]);
+            const pathDepth = depthResult.rows?.[0]?.["depth"];
+            // Validate offset is within bounds
+            const effectiveOffset = offset < 0 ? pathDepth + offset : offset;
+            if (effectiveOffset < 0 || effectiveOffset >= pathDepth) {
+                return {
+                    success: false,
+                    error: `Invalid offset: ${String(offset)}. Path "${path}" has ${String(pathDepth)} labels (valid offset range: 0 to ${String(pathDepth - 1)}, or -${String(pathDepth)} to -1 for negative indexing).`,
+                    originalPath: path,
+                    pathDepth,
+                };
+            }
+            const sql = length !== undefined
+                ? `SELECT subpath($1::ltree, $2, $3) as subpath, nlevel($1::ltree) as original_depth`
+                : `SELECT subpath($1::ltree, $2) as subpath, nlevel($1::ltree) as original_depth`;
+            const queryParams = length !== undefined ? [path, offset, length] : [path, offset];
+            const result = await adapter.executeQuery(sql, queryParams);
+            const row = result.rows?.[0];
+            return {
+                originalPath: path,
+                offset,
+                length: length ?? "to end",
+                subpath: row?.["subpath"],
+                originalDepth: row?.["original_depth"],
+            };
+        },
+    };
+}
+function createLtreeLcaTool(adapter) {
+    return {
+        name: "pg_ltree_lca",
+        description: "Find the longest common ancestor of multiple ltree paths.",
+        group: "ltree",
+        inputSchema: LtreeLcaSchema,
+        annotations: readOnly("Ltree LCA"),
+        icons: getToolIcons("ltree", readOnly("Ltree LCA")),
+        handler: async (params, _context) => {
+            const { paths } = LtreeLcaSchema.parse(params);
+            const arrayLiteral = paths
+                .map((p) => `'${p.replace(/'/g, "''")}'::ltree`)
+                .join(", ");
+            const sql = `SELECT lca(ARRAY[${arrayLiteral}]) as lca`;
+            const result = await adapter.executeQuery(sql);
+            const lca = result.rows?.[0]?.["lca"];
+            return {
+                paths,
+                longestCommonAncestor: lca ?? "",
+                hasCommonAncestor: lca !== null && lca !== "",
+            };
+        },
+    };
+}
+function createLtreeMatchTool(adapter) {
+    return {
+        name: "pg_ltree_match",
+        description: "Match ltree paths using lquery pattern syntax.",
+        group: "ltree",
+        inputSchema: LtreeMatchSchemaBase, // Base schema for MCP visibility
+        annotations: readOnly("Ltree Match"),
+        icons: getToolIcons("ltree", readOnly("Ltree Match")),
+        handler: async (params, _context) => {
+            const { table, column, pattern, schema, limit } = LtreeMatchSchema.parse(params);
+            const schemaName = schema ?? "public";
+            const qualifiedTable = `"${schemaName}"."${table}"`;
+            const limitClause = limit !== undefined ? `LIMIT ${String(limit)}` : "";
+            // Get total count when limit is applied for truncation indicators
+            let totalCount;
+            if (limit !== undefined) {
+                const countSql = `SELECT COUNT(*)::int as total FROM ${qualifiedTable} WHERE "${column}" ~ $1::lquery`;
+                const countResult = await adapter.executeQuery(countSql, [pattern]);
+                totalCount = countResult.rows?.[0]?.["total"];
+            }
+            const sql = `SELECT *, nlevel("${column}") as depth FROM ${qualifiedTable} WHERE "${column}" ~ $1::lquery ORDER BY "${column}" ${limitClause}`;
+            const result = await adapter.executeQuery(sql, [pattern]);
+            const resultCount = result.rows?.length ?? 0;
+            const response = {
+                pattern,
+                results: result.rows ?? [],
+                count: resultCount,
+            };
+            // Add truncation indicators when limit is applied
+            if (limit !== undefined && totalCount !== undefined) {
+                response["truncated"] = resultCount < totalCount;
+                response["totalCount"] = totalCount;
+            }
+            return response;
+        },
+    };
+}
+function createLtreeListColumnsTool(adapter) {
+    return {
+        name: "pg_ltree_list_columns",
+        description: "List all columns using the ltree type in the database.",
+        group: "ltree",
+        inputSchema: LtreeListColumnsSchema,
+        annotations: readOnly("List Ltree Columns"),
+        icons: getToolIcons("ltree", readOnly("List Ltree Columns")),
+        handler: async (params, _context) => {
+            const { schema } = LtreeListColumnsSchema.parse(params);
+            const conditions = [
+                "udt_name = 'ltree'",
+                "table_schema NOT IN ('pg_catalog', 'information_schema')",
+            ];
+            const queryParams = [];
+            if (schema !== undefined) {
+                conditions.push(`table_schema = $1`);
+                queryParams.push(schema);
+            }
+            const sql = `SELECT table_schema, table_name, column_name, is_nullable, column_default FROM information_schema.columns WHERE ${conditions.join(" AND ")} ORDER BY table_schema, table_name, ordinal_position`;
+            const result = await adapter.executeQuery(sql, queryParams);
+            return { columns: result.rows ?? [], count: result.rows?.length ?? 0 };
+        },
+    };
+}
+function createLtreeConvertColumnTool(adapter) {
+    return {
+        name: "pg_ltree_convert_column",
+        description: "Convert an existing TEXT column to LTREE type. Note: If views depend on this column, you must drop and recreate them manually before conversion.",
+        group: "ltree",
+        inputSchema: LtreeConvertColumnSchemaBase, // Base schema for MCP visibility
+        annotations: write("Convert to Ltree"),
+        icons: getToolIcons("ltree", write("Convert to Ltree")),
+        handler: async (params, _context) => {
+            const { table, column, schema } = LtreeConvertColumnSchema.parse(params);
+            const schemaName = schema ?? "public";
+            const qualifiedTable = `"${schemaName}"."${table}"`;
+            // Check if ltree extension is installed
+            const extCheck = await adapter.executeQuery(`
+        SELECT EXISTS(
+          SELECT 1 FROM pg_extension WHERE extname = 'ltree'
+        ) as installed
+      `);
+            const hasExt = extCheck.rows?.[0]?.["installed"] ?? false;
+            if (!hasExt) {
+                return {
+                    success: false,
+                    error: "ltree extension is not installed. Run pg_ltree_create_extension first.",
+                };
+            }
+            const colCheck = await adapter.executeQuery(`SELECT data_type, udt_name FROM information_schema.columns WHERE table_schema = $1 AND table_name = $2 AND column_name = $3`, [schemaName, table, column]);
+            if (!colCheck.rows || colCheck.rows.length === 0) {
+                return {
+                    success: false,
+                    error: `Column "${column}" not found in table ${qualifiedTable}. Verify the table and column names.`,
+                };
+            }
+            const dataType = colCheck.rows[0]?.["data_type"];
+            const udtName = colCheck.rows[0]?.["udt_name"];
+            const currentType = dataType === "USER-DEFINED" ? udtName : dataType;
+            if (udtName === "ltree") {
+                return {
+                    success: true,
+                    message: `Column ${column} is already ltree`,
+                    wasAlreadyLtree: true,
+                };
+            }
+            // Validate source column is text-based (like citext tool does)
+            const allowedTypes = ["text", "varchar", "character varying", "bpchar"];
+            const normalizedType = dataType.toLowerCase();
+            if (!allowedTypes.includes(normalizedType)) {
+                return {
+                    success: false,
+                    error: `Cannot convert column "${column}" of type "${currentType}" to ltree. Only text-based columns can be converted.`,
+                    currentType,
+                    allowedTypes: ["text", "varchar", "character varying"],
+                    suggestion: "Create a new TEXT column with ltree-formatted paths, then convert that column.",
+                };
+            }
+            // Check for dependent views before attempting the conversion
+            const depCheck = await adapter.executeQuery(`
+        SELECT DISTINCT 
+          c.relname as dependent_view,
+          n.nspname as view_schema
+        FROM pg_depend d
+        JOIN pg_rewrite r ON d.objid = r.oid
+        JOIN pg_class c ON r.ev_class = c.oid
+        JOIN pg_namespace n ON c.relnamespace = n.oid
+        JOIN pg_class t ON d.refobjid = t.oid
+        JOIN pg_namespace tn ON t.relnamespace = tn.oid
+        JOIN pg_attribute a ON d.refobjid = a.attrelid AND d.refobjsubid = a.attnum
+        WHERE c.relkind = 'v'
+          AND tn.nspname = $1
+          AND t.relname = $2
+          AND a.attname = $3
+        `, [schemaName, table, column]);
+            const dependentViews = depCheck.rows ?? [];
+            if (dependentViews.length > 0) {
+                return {
+                    success: false,
+                    error: "Column has dependent views that must be dropped before conversion",
+                    dependentViews: dependentViews.map((v) => `${v["view_schema"]}.${v["dependent_view"]}`),
+                    hint: "Drop the listed views, run this conversion, then recreate the views. PostgreSQL cannot ALTER COLUMN TYPE when views depend on it.",
+                };
+            }
+            try {
+                await adapter.executeQuery(`ALTER TABLE ${qualifiedTable} ALTER COLUMN "${column}" TYPE ltree USING "${column}"::ltree`);
+                return {
+                    success: true,
+                    message: `Column ${column} converted to ltree`,
+                    table: qualifiedTable,
+                    previousType: currentType,
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    success: false,
+                    error: `Failed to convert column: ${errorMessage}`,
+                    hint: "If views depend on this column, they may need to be dropped and recreated",
+                };
+            }
+        },
+    };
+}
+function createLtreeCreateIndexTool(adapter) {
+    return {
+        name: "pg_ltree_create_index",
+        description: "Create a GiST index on an ltree column for efficient tree queries.",
+        group: "ltree",
+        inputSchema: LtreeIndexSchemaBase, // Base schema for MCP visibility
+        annotations: write("Create Ltree Index"),
+        icons: getToolIcons("ltree", write("Create Ltree Index")),
+        handler: async (params, _context) => {
+            const { table, column, indexName, schema } = LtreeIndexSchema.parse(params);
+            const schemaName = schema ?? "public";
+            const qualifiedTable = `"${schemaName}"."${table}"`;
+            const idxName = indexName ?? `idx_${table}_${column}_ltree`;
+            const idxCheck = await adapter.executeQuery(`SELECT EXISTS(SELECT 1 FROM pg_indexes WHERE schemaname = $1 AND indexname = $2) as exists`, [schemaName, idxName]);
+            if (idxCheck.rows?.[0]?.["exists"])
+                return {
+                    success: true,
+                    message: `Index ${idxName} already exists`,
+                    indexName: idxName,
+                    alreadyExists: true,
+                };
+            await adapter.executeQuery(`CREATE INDEX "${idxName}" ON ${qualifiedTable} USING GIST ("${column}")`);
+            return {
+                success: true,
+                message: `GiST index created`,
+                indexName: idxName,
+                table: qualifiedTable,
+                column,
+                indexType: "gist",
+            };
+        },
+    };
+}
+//# sourceMappingURL=ltree.js.map

package/dist/adapters/postgresql/tools/ltree.js.map

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

package/dist/adapters/postgresql/tools/monitoring.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PostgreSQL Monitoring Tools
+ *
+ * Database health, sizes, connections, and replication status.
+ * 11 tools total.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../types/index.js";
+/**
+ * Get all monitoring tools
+ */
+export declare function getMonitoringTools(adapter: PostgresAdapter): ToolDefinition[];
+//# sourceMappingURL=monitoring.d.ts.map

package/dist/adapters/postgresql/tools/monitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/tools/monitoring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AAU9E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,EAAE,CAc7E"}