@neverinfamous/postgres-mcp 1.0.1

package/dist/filtering/ToolFilter.js

@@ -0,0 +1,315 @@
+/**
+ * postgres-mcp - Tool Filtering System
+ *
+ * Parses and applies tool filter rules from environment variables.
+ * Compatible with db-mcp filtering syntax.
+ *
+ * Syntax:
+ *   -group    → Disable all tools in a group
+ *   +group    → Enable all tools in a group
+ *   -tool     → Disable a specific tool
+ *   +tool     → Enable a specific tool (after group disable)
+ */
+/**
+ * Cached list of all tool names
+ * Lazy-initialized since TOOL_GROUPS is immutable
+ */
+let cachedAllToolNames = null;
+/**
+ * Reverse lookup map: tool name -> group
+ * Lazy-initialized for O(1) tool group lookups
+ */
+let toolToGroupMap = null;
+/**
+ * Default tool groups and their member tools.
+ * This serves as the canonical mapping of tools to groups.
+ */
+export { TOOL_GROUPS, META_GROUPS } from "./ToolConstants.js";
+import { TOOL_GROUPS, META_GROUPS } from "./ToolConstants.js";
+/**
+ * Get all tool names from all groups (cached)
+ */
+export function getAllToolNames() {
+    if (cachedAllToolNames) {
+        return cachedAllToolNames;
+    }
+    const groups = Object.keys(TOOL_GROUPS);
+    cachedAllToolNames = groups.flatMap((group) => TOOL_GROUPS[group]);
+    return cachedAllToolNames;
+}
+/**
+ * Get or initialize the tool-to-group reverse lookup map
+ */
+function getToolToGroupMap() {
+    if (toolToGroupMap) {
+        return toolToGroupMap;
+    }
+    toolToGroupMap = new Map();
+    const groups = Object.keys(TOOL_GROUPS);
+    for (const group of groups) {
+        for (const tool of TOOL_GROUPS[group]) {
+            toolToGroupMap.set(tool, group);
+        }
+    }
+    return toolToGroupMap;
+}
+/**
+ * Get the group for a specific tool (O(1) lookup)
+ */
+export function getToolGroup(toolName) {
+    return getToolToGroupMap().get(toolName);
+}
+/**
+ * Clear all caches - useful for testing
+ */
+export function clearToolFilterCaches() {
+    cachedAllToolNames = null;
+    toolToGroupMap = null;
+}
+/**
+ * Check if a name is a valid tool group
+ */
+export function isToolGroup(name) {
+    return name in TOOL_GROUPS;
+}
+/**
+ * Check if a name is a valid meta-group
+ */
+export function isMetaGroup(name) {
+    return name in META_GROUPS;
+}
+/**
+ * Get all tool names from a meta-group
+ */
+export function getMetaGroupTools(metaGroup) {
+    const tools = [];
+    for (const group of META_GROUPS[metaGroup]) {
+        tools.push(...TOOL_GROUPS[group]);
+    }
+    return tools;
+}
+/**
+ * Parse a tool filter string into structured rules
+ *
+ * @param filterString - The filter string (e.g., "starter" or "-vector,-postgis,+pg_vector_search")
+ * @returns Parsed filter configuration
+ */
+export function parseToolFilter(filterString) {
+    const allTools = getAllToolNames();
+    const enabledTools = new Set(allTools);
+    if (!filterString || filterString.trim() === "") {
+        return {
+            raw: "",
+            rules: [],
+            enabledTools,
+        };
+    }
+    const rules = [];
+    const parts = filterString
+        .split(",")
+        .map((p) => p.trim())
+        .filter((p) => p);
+    if (parts.length === 0) {
+        return {
+            raw: filterString,
+            rules: [],
+            enabledTools,
+        };
+    }
+    // If first rule is exclusion (-), start with ALL tools
+    // If first rule is inclusion (+) or no prefix, start with NO tools (whitelist mode)
+    const firstPart = parts[0];
+    if (!firstPart) {
+        return {
+            raw: filterString,
+            rules: [],
+            enabledTools,
+        };
+    }
+    const startsWithExclude = firstPart.startsWith("-");
+    if (!startsWithExclude) {
+        enabledTools.clear();
+    }
+    // Track if codemode was explicitly excluded
+    let codemodeExplicitlyExcluded = false;
+    for (const part of parts) {
+        if (!part)
+            continue;
+        let isInclude = true; // Default to include
+        let isExclude = false;
+        let target = part;
+        if (part.startsWith("+")) {
+            isInclude = true;
+            target = part.substring(1);
+        }
+        else if (part.startsWith("-")) {
+            isInclude = false;
+            isExclude = true;
+            target = part.substring(1);
+        }
+        // Track explicit codemode exclusion
+        if (target === "codemode" && isExclude) {
+            codemodeExplicitlyExcluded = true;
+        }
+        // Special case: 'all'
+        if (target === "all") {
+            if (isExclude) {
+                enabledTools.clear();
+            }
+            else {
+                for (const tool of allTools) {
+                    enabledTools.add(tool);
+                }
+            }
+            continue;
+        }
+        const targetIsMetaGroup = isMetaGroup(target);
+        const targetIsGroup = isToolGroup(target);
+        rules.push({
+            type: isInclude ? "include" : "exclude",
+            target,
+            isGroup: targetIsGroup || targetIsMetaGroup,
+        });
+        // Apply rule - check meta-groups first, then regular groups, then individual tools
+        if (targetIsMetaGroup) {
+            // Expand meta-group to all its underlying groups' tools
+            const metaGroupTools = getMetaGroupTools(target);
+            if (isExclude) {
+                for (const tool of metaGroupTools) {
+                    enabledTools.delete(tool);
+                }
+            }
+            else {
+                for (const tool of metaGroupTools) {
+                    enabledTools.add(tool);
+                }
+            }
+        }
+        else if (targetIsGroup) {
+            const groupTools = TOOL_GROUPS[target];
+            if (isExclude) {
+                for (const tool of groupTools) {
+                    enabledTools.delete(tool);
+                }
+            }
+            else {
+                for (const tool of groupTools) {
+                    enabledTools.add(tool);
+                }
+            }
+        }
+        else {
+            // Individual tool
+            if (isExclude) {
+                enabledTools.delete(target);
+            }
+            else {
+                enabledTools.add(target);
+            }
+        }
+    }
+    // Auto-include codemode unless explicitly excluded with -codemode
+    // This ensures code mode is always available by default
+    if (!codemodeExplicitlyExcluded) {
+        const codemodeTools = TOOL_GROUPS.codemode;
+        for (const tool of codemodeTools) {
+            enabledTools.add(tool);
+        }
+    }
+    return {
+        raw: filterString,
+        rules,
+        enabledTools,
+    };
+}
+/**
+ * Check if a tool is enabled based on filter configuration
+ */
+export function isToolEnabled(toolName, config) {
+    return config.enabledTools.has(toolName);
+}
+/**
+ * Filter a list of tool definitions based on filter configuration
+ */
+export function filterTools(tools, config) {
+    return tools.filter((tool) => config.enabledTools.has(tool.name));
+}
+/**
+ * Get the tool filter from environment variable
+ */
+export function getToolFilterFromEnv() {
+    const filterString = process.env["POSTGRES_TOOL_FILTER"] ??
+        process.env["MCP_TOOL_FILTER"] ??
+        process.env["TOOL_FILTER"];
+    return parseToolFilter(filterString);
+}
+/**
+ * Calculate token savings from tool filtering
+ * Assumes ~200 tokens per tool definition (description + parameters)
+ */
+export function calculateTokenSavings(totalTools, enabledTools, tokensPerTool = 200) {
+    const disabledTools = totalTools - enabledTools;
+    const tokensSaved = disabledTools * tokensPerTool;
+    const percentSaved = totalTools > 0 ? Math.round((disabledTools / totalTools) * 100) : 0;
+    return { tokensSaved, percentSaved };
+}
+/**
+ * Generate a summary of the current filter configuration
+ */
+export function getFilterSummary(config) {
+    const allTools = getAllToolNames();
+    const enabledCount = config.enabledTools.size;
+    const disabledCount = allTools.length - enabledCount;
+    const lines = [
+        `Tool Filter Summary:`,
+        `  Total tools: ${String(allTools.length)}`,
+        `  Enabled: ${String(enabledCount)}`,
+        `  Disabled: ${String(disabledCount)}`,
+    ];
+    if (config.rules.length > 0) {
+        lines.push(`  Rules applied:`);
+        for (const rule of config.rules) {
+            const prefix = rule.type === "include" ? "+" : "-";
+            // Determine type: meta-group, group, or tool
+            let type;
+            if (isMetaGroup(rule.target)) {
+                type = "meta-group";
+            }
+            else if (rule.isGroup) {
+                type = "group";
+            }
+            else {
+                type = "tool";
+            }
+            lines.push(`    ${prefix}${rule.target} (${type})`);
+        }
+    }
+    // Show per-group breakdown
+    lines.push(`  By group:`);
+    for (const [group, tools] of Object.entries(TOOL_GROUPS)) {
+        const enabled = tools.filter((t) => config.enabledTools.has(t)).length;
+        lines.push(`    ${group}: ${String(enabled)}/${String(tools.length)}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Get a list of all tool groups with their tool counts
+ */
+export function getToolGroupInfo() {
+    return Object.entries(TOOL_GROUPS).map(([group, tools]) => ({
+        group: group,
+        count: tools.length,
+        tools,
+    }));
+}
+/**
+ * Get a list of all meta-groups with their expanded tool counts
+ */
+export function getMetaGroupInfo() {
+    return Object.entries(META_GROUPS).map(([metaGroup, groups]) => ({
+        metaGroup: metaGroup,
+        groups,
+        count: getMetaGroupTools(metaGroup).length,
+    }));
+}
+//# sourceMappingURL=ToolFilter.js.map

package/dist/filtering/ToolFilter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * postgres-mcp - PostgreSQL MCP Server
+ *
+ * Full-featured PostgreSQL database tools for AI assistants.
+ *
+ * @module postgres-mcp
+ */
+export * from "./types/index.js";
+export { DatabaseAdapter } from "./adapters/DatabaseAdapter.js";
+export { PostgresAdapter } from "./adapters/postgresql/index.js";
+export { PostgresMcpServer } from "./server/McpServer.js";
+export { ConnectionPool } from "./pool/ConnectionPool.js";
+export { parseToolFilter, filterTools, getToolFilterFromEnv, TOOL_GROUPS, getAllToolNames, getToolGroup, } from "./filtering/ToolFilter.js";
+export { logger } from "./utils/logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * postgres-mcp - PostgreSQL MCP Server
+ *
+ * Full-featured PostgreSQL database tools for AI assistants.
+ *
+ * @module postgres-mcp
+ */
+// Export types
+export * from "./types/index.js";
+// Export adapters
+export { DatabaseAdapter } from "./adapters/DatabaseAdapter.js";
+export { PostgresAdapter } from "./adapters/postgresql/index.js";
+// Export server
+export { PostgresMcpServer } from "./server/McpServer.js";
+// Export utilities
+export { ConnectionPool } from "./pool/ConnectionPool.js";
+export { parseToolFilter, filterTools, getToolFilterFromEnv, TOOL_GROUPS, getAllToolNames, getToolGroup, } from "./filtering/ToolFilter.js";
+export { logger } from "./utils/logger.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAe;AACf,cAAc,kBAAkB,CAAC;AAEjC,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/pool/ConnectionPool.d.ts

@@ -0,0 +1,70 @@
+/**
+ * postgres-mcp - Connection Pool Manager
+ *
+ * Wraps pg connection pooling with health monitoring,
+ * statistics tracking, and graceful shutdown support.
+ */
+import pg from "pg";
+import type { PoolClient, QueryResult as PgQueryResult } from "pg";
+import type { PoolConfig, PoolStats, HealthStatus } from "../types/index.js";
+/**
+ * Connection pool configuration with defaults
+ */
+export interface ConnectionPoolConfig {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+    pool?: PoolConfig | undefined;
+    ssl?: pg.ConnectionConfig["ssl"] | undefined;
+    statementTimeout?: number | undefined;
+    applicationName?: string | undefined;
+}
+/**
+ * Connection pool wrapper with statistics and health monitoring
+ */
+export declare class ConnectionPool {
+    private pool;
+    private config;
+    private stats;
+    private shuttingDown;
+    constructor(config: ConnectionPoolConfig);
+    /**
+     * Initialize the connection pool
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get a connection from the pool
+     */
+    getConnection(): Promise<PoolClient>;
+    /**
+     * Release a connection back to the pool
+     */
+    releaseConnection(client: PoolClient): void;
+    /**
+     * Execute a query using a pooled connection
+     */
+    query<T extends Record<string, unknown>[]>(sql: string, params?: unknown[]): Promise<PgQueryResult<T[number]>>;
+    /**
+     * Get pool statistics
+     */
+    getStats(): PoolStats;
+    /**
+     * Check pool health
+     */
+    checkHealth(): Promise<HealthStatus>;
+    /**
+     * Gracefully shutdown the pool
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Check if pool is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Check if pool is shutting down
+     */
+    isClosing(): boolean;
+}
+//# sourceMappingURL=ConnectionPool.d.ts.map

package/dist/pool/ConnectionPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionPool.d.ts","sourceRoot":"","sources":["../../src/pool/ConnectionPool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI7E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,GAAG,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAC7C,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAMX;IACF,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,oBAAoB;IAIxC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6FjC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAqB1C;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAU3C;;OAEG;IACG,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC7C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IA4BpC;;OAEG;IACH,QAAQ,IAAI,SAAS;IAWrB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAuC1C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB/B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB"}