@neverinfamous/postgres-mcp 1.0.1

package/dist/utils/logger.js

@@ -0,0 +1,304 @@
+/**
+ * postgres-mcp - Structured Logger
+ *
+ * Centralized logging utility with RFC 5424 severity levels and structured output.
+ * Supports dual-mode logging: stderr for local debugging and MCP protocol notifications.
+ *
+ * Format: [timestamp] [LEVEL] [MODULE] [CODE] message {context}
+ * Example: [2025-12-18T01:30:00Z] [ERROR] [ADAPTER] [PG_CONNECT_FAILED] Failed to connect {"host":"localhost"}
+ */
+/**
+ * MCP-aware structured logger with dual-mode output
+ *
+ * Follows MCP Server Logging Standards:
+ * - Centralized logger writing to stderr only (stdout reserved for MCP protocol)
+ * - Include: module, operation, entityId, context, stack traces
+ * - Module-prefixed codes (e.g., PG_CONNECT_FAILED, AUTH_TOKEN_INVALID)
+ * - Severity: RFC 5424 levels
+ * - Format: [timestamp] [LEVEL] [MODULE] [CODE] message {context}
+ */
+class Logger {
+    minLevel = "info";
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    mcpServer = null;
+    loggerName = "postgres-mcp";
+    defaultModule = "SERVER";
+    /**
+     * RFC 5424 severity priority (lower number = higher severity)
+     */
+    levelPriority = {
+        emergency: 0,
+        alert: 1,
+        critical: 2,
+        error: 3,
+        warning: 4,
+        notice: 5,
+        info: 6,
+        debug: 7,
+    };
+    /**
+     * Set the minimum log level
+     */
+    setLevel(level) {
+        this.minLevel = level;
+    }
+    /**
+     * Get the current minimum log level
+     */
+    getLevel() {
+        return this.minLevel;
+    }
+    /**
+     * Set the MCP server for protocol logging
+     * When set, logs will be sent to connected MCP clients
+     */
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    setMcpServer(server) {
+        this.mcpServer = server;
+    }
+    /**
+     * Set the logger name (appears in MCP log messages)
+     */
+    setLoggerName(name) {
+        this.loggerName = name;
+    }
+    /**
+     * Set the default module for logs without explicit module
+     */
+    setDefaultModule(module) {
+        this.defaultModule = module;
+    }
+    shouldLog(level) {
+        // Lower priority number = higher severity, so we log if level priority <= minLevel priority
+        return this.levelPriority[level] <= this.levelPriority[this.minLevel];
+    }
+    /**
+     * List of keys that contain sensitive data and should be redacted
+     */
+    sensitiveKeys = new Set([
+        "password",
+        "secret",
+        "token",
+        "key",
+        "apikey",
+        "api_key",
+        "accesstoken",
+        "access_token",
+        "refreshtoken",
+        "refresh_token",
+        "authorization",
+        "credential",
+        "credentials",
+        // OAuth-specific sensitive fields
+        "issuer",
+        "audience",
+        "jwksuri",
+        "jwks_uri",
+        "client_secret",
+        "clientsecret",
+    ]);
+    /**
+     * Sanitize log message to prevent log injection attacks
+     * Removes control characters that could be used to forge log entries or escape sequences
+     */
+    sanitizeMessage(message) {
+        // Remove control characters (ASCII 0x00-0x1F) except:
+        // - 0x09 (tab) - useful for formatting
+        // - 0x0A (newline) - useful for multi-line messages
+        // - 0x0D (carriage return) - pairs with newline
+        // Also remove 0x7F (DEL) and C1 control characters (0x80-0x9F)
+        // eslint-disable-next-line no-control-regex
+        return message.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F\x80-\x9F]/g, "");
+    }
+    /**
+     * Sanitize context object by redacting sensitive values
+     * This prevents clear-text logging of OAuth config and other secrets
+     */
+    sanitizeContext(context) {
+        const sanitized = {};
+        for (const [key, value] of Object.entries(context)) {
+            const lowerKey = key.toLowerCase();
+            // Check if this key matches any sensitive pattern
+            const isSensitive = this.sensitiveKeys.has(lowerKey) ||
+                [...this.sensitiveKeys].some((sk) => lowerKey.includes(sk));
+            if (isSensitive && value !== undefined && value !== null) {
+                sanitized[key] = "[REDACTED]";
+            }
+            else if (typeof value === "object" &&
+                value !== null &&
+                !Array.isArray(value)) {
+                // Recursively sanitize nested objects
+                sanitized[key] = this.sanitizeContext(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Format log entry according to MCP logging standard
+     * Format: [timestamp] [LEVEL] [MODULE] [CODE] message {context}
+     */
+    formatEntry(entry) {
+        const parts = [
+            `[${entry.timestamp}]`,
+            `[${entry.level.toUpperCase()}]`,
+        ];
+        // Add module if present
+        if (entry.module) {
+            parts.push(`[${entry.module}]`);
+        }
+        // Add code if present
+        if (entry.code) {
+            parts.push(`[${entry.code}]`);
+        }
+        // Add message (sanitized to prevent log injection)
+        parts.push(this.sanitizeMessage(entry.message));
+        // Add context if present (excluding module and code which are already in the format)
+        if (entry.context) {
+            // Destructure out fields that are already in the log line format
+            const { module, code, ...restContext } = entry.context;
+            void module;
+            void code; // Intentionally unused - already in format
+            if (Object.keys(restContext).length > 0) {
+                const sanitizedContext = this.sanitizeContext(restContext);
+                parts.push(JSON.stringify(sanitizedContext));
+            }
+        }
+        return parts.join(" ");
+    }
+    /**
+     * Send log message to MCP client if connected
+     */
+    async sendToMcp(entry) {
+        if (!this.mcpServer) {
+            return;
+        }
+        try {
+            const data = {
+                message: entry.message,
+            };
+            if (entry.module)
+                data["module"] = entry.module;
+            if (entry.code)
+                data["code"] = entry.code;
+            if (entry.context) {
+                const sanitized = this.sanitizeContext(entry.context);
+                Object.assign(data, sanitized);
+            }
+            await this.mcpServer.sendLoggingMessage({
+                level: entry.level,
+                logger: this.loggerName,
+                data,
+            });
+        }
+        catch {
+            // Silently ignore MCP logging failures to avoid infinite loops
+        }
+    }
+    /**
+     * Core logging method
+     */
+    log(level, message, context) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const entry = {
+            level,
+            module: context?.module ?? this.defaultModule,
+            code: context?.code,
+            message,
+            timestamp: new Date().toISOString(),
+            context,
+        };
+        const formatted = this.formatEntry(entry);
+        // Write to stderr to avoid interfering with MCP stdio transport
+        // All levels use console.error to write to stderr
+        console.error(formatted);
+        // Also send to MCP client if connected (fire and forget)
+        void this.sendToMcp(entry);
+    }
+    // =========================================================================
+    // Convenience methods for each log level
+    // =========================================================================
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    notice(message, context) {
+        this.log("notice", message, context);
+    }
+    warn(message, context) {
+        this.log("warning", message, context);
+    }
+    warning(message, context) {
+        this.log("warning", message, context);
+    }
+    error(message, context) {
+        this.log("error", message, context);
+    }
+    critical(message, context) {
+        this.log("critical", message, context);
+    }
+    alert(message, context) {
+        this.log("alert", message, context);
+    }
+    emergency(message, context) {
+        this.log("emergency", message, context);
+    }
+    // =========================================================================
+    // Module-scoped logging helpers
+    // =========================================================================
+    /**
+     * Create a child logger scoped to a specific module
+     */
+    forModule(module) {
+        return new ModuleLogger(this, module);
+    }
+}
+/**
+ * Module-scoped logger for cleaner code in specific modules
+ */
+class ModuleLogger {
+    parent;
+    module;
+    constructor(parent, module) {
+        this.parent = parent;
+        this.module = module;
+    }
+    withModule(context) {
+        return { ...context, module: this.module };
+    }
+    debug(message, context) {
+        this.parent.debug(message, this.withModule(context));
+    }
+    info(message, context) {
+        this.parent.info(message, this.withModule(context));
+    }
+    notice(message, context) {
+        this.parent.notice(message, this.withModule(context));
+    }
+    warn(message, context) {
+        this.parent.warn(message, this.withModule(context));
+    }
+    warning(message, context) {
+        this.parent.warning(message, this.withModule(context));
+    }
+    error(message, context) {
+        this.parent.error(message, this.withModule(context));
+    }
+    critical(message, context) {
+        this.parent.critical(message, this.withModule(context));
+    }
+    alert(message, context) {
+        this.parent.alert(message, this.withModule(context));
+    }
+    emergency(message, context) {
+        this.parent.emergency(message, this.withModule(context));
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/promptGenerator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * postgres-mcp - Prompt Generator Utilities
+ *
+ * Helper functions for generating prompts, especially for lazy hydration.
+ */
+import type { ToolDefinition } from "../types/index.js";
+/**
+ * Generate a compact tool index for lazy hydration.
+ * Groups tools by category and provides minimal token overhead.
+ */
+export declare function generateCompactIndex(tools: ToolDefinition[]): string;
+/**
+ * Generate a discovery prompt that helps the AI find relevant tools.
+ */
+export declare function generateDiscoveryPrompt(tools: ToolDefinition[]): string;
+/**
+ * Generate tool tags for search/discovery.
+ */
+export declare function generateToolTags(tool: ToolDefinition): string[];
+//# sourceMappingURL=promptGenerator.d.ts.map

package/dist/utils/promptGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/promptGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CA8BpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CA8BvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAe/D"}

package/dist/utils/promptGenerator.js

@@ -0,0 +1,81 @@
+/**
+ * postgres-mcp - Prompt Generator Utilities
+ *
+ * Helper functions for generating prompts, especially for lazy hydration.
+ */
+/**
+ * Generate a compact tool index for lazy hydration.
+ * Groups tools by category and provides minimal token overhead.
+ */
+export function generateCompactIndex(tools) {
+    // Group tools by their group
+    const grouped = new Map();
+    for (const tool of tools) {
+        const group = tool.group;
+        const groupTools = grouped.get(group) ?? [];
+        groupTools.push(tool);
+        grouped.set(group, groupTools);
+    }
+    // Build compact index
+    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 tool of groupTools) {
+            // Compact format: name - short description
+            const shortDesc = tool.description.split(".")[0] ?? tool.description;
+            lines.push(`- ${tool.name}: ${shortDesc}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Generate a discovery prompt that helps the AI find relevant tools.
+ */
+export function generateDiscoveryPrompt(tools) {
+    const lines = [
+        "You have access to PostgreSQL database tools. Here is how to find what you need:",
+        "",
+        "**Tool Categories:**",
+    ];
+    // Group and count
+    const grouped = new Map();
+    for (const tool of tools) {
+        grouped.set(tool.group, (grouped.get(tool.group) ?? 0) + 1);
+    }
+    for (const [group, count] of grouped) {
+        lines.push(`- ${group}: ${String(count)} tools`);
+    }
+    lines.push("");
+    lines.push("**Common Tasks:**");
+    lines.push("- Query data: pg_read_query");
+    lines.push("- Modify data: pg_write_query");
+    lines.push("- View tables: pg_list_tables, pg_describe_table");
+    lines.push("- Analyze performance: pg_explain_analyze, pg_stat_statements");
+    lines.push("- Manage transactions: pg_transaction_begin/commit/rollback");
+    lines.push("");
+    lines.push("Ask about any category or task for specific tool recommendations.");
+    return lines.join("\n");
+}
+/**
+ * Generate tool tags for search/discovery.
+ */
+export function generateToolTags(tool) {
+    const tags = [tool.group];
+    // Extract keywords from name
+    const nameParts = tool.name.replace("pg_", "").split("_");
+    tags.push(...nameParts);
+    // Extract keywords from description
+    const descWords = tool.description
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((w) => w.length > 3 && !["the", "and", "for", "with"].includes(w));
+    tags.push(...descWords.slice(0, 5)); // Limit to 5 keywords
+    return [...new Set(tags)]; // Deduplicate
+}
+//# sourceMappingURL=promptGenerator.js.map

package/dist/utils/promptGenerator.js.map

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

package/dist/utils/resourceAnnotations.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Resource Annotations Presets
+ *
+ * Reusable annotation configurations for MCP resources.
+ * Used by all resource definition files for consistency.
+ */
+import type { ResourceAnnotations } from "../types/index.js";
+/**
+ * High priority resource (0.8+) - critical for understanding database state
+ * Examples: health, activity, schema
+ */
+export declare const HIGH_PRIORITY: ResourceAnnotations;
+/**
+ * Medium priority resource (0.5-0.7) - useful for analysis and monitoring
+ * Examples: performance, statistics, indexes
+ */
+export declare const MEDIUM_PRIORITY: ResourceAnnotations;
+/**
+ * Low priority resource (0.3-0.4) - supplementary information
+ * Examples: extension status, pool stats
+ */
+export declare const LOW_PRIORITY: ResourceAnnotations;
+/**
+ * Assistant-focused resource - primarily for agent consumption
+ * Examples: capabilities, settings reference
+ */
+export declare const ASSISTANT_FOCUSED: ResourceAnnotations;
+/**
+ * Create annotations with a custom priority
+ */
+export declare function withPriority(priority: number, base?: ResourceAnnotations): ResourceAnnotations;
+/**
+ * Create annotations with lastModified timestamp
+ */
+export declare function withTimestamp(base?: ResourceAnnotations): ResourceAnnotations;
+//# sourceMappingURL=resourceAnnotations.d.ts.map

package/dist/utils/resourceAnnotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceAnnotations.d.ts","sourceRoot":"","sources":["../../src/utils/resourceAnnotations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM7D;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,mBAG3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,mBAG7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,mBAG1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAG/B,CAAC;AAMF;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,mBAAmC,GACxC,mBAAmB,CAErB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,GAAE,mBAAqC,GAC1C,mBAAmB,CAErB"}

package/dist/utils/resourceAnnotations.js

@@ -0,0 +1,57 @@
+/**
+ * Resource Annotations Presets
+ *
+ * Reusable annotation configurations for MCP resources.
+ * Used by all resource definition files for consistency.
+ */
+// =============================================================================
+// Resource Annotation Presets
+// =============================================================================
+/**
+ * High priority resource (0.8+) - critical for understanding database state
+ * Examples: health, activity, schema
+ */
+export const HIGH_PRIORITY = {
+    audience: ["user", "assistant"],
+    priority: 0.9,
+};
+/**
+ * Medium priority resource (0.5-0.7) - useful for analysis and monitoring
+ * Examples: performance, statistics, indexes
+ */
+export const MEDIUM_PRIORITY = {
+    audience: ["user", "assistant"],
+    priority: 0.6,
+};
+/**
+ * Low priority resource (0.3-0.4) - supplementary information
+ * Examples: extension status, pool stats
+ */
+export const LOW_PRIORITY = {
+    audience: ["user", "assistant"],
+    priority: 0.4,
+};
+/**
+ * Assistant-focused resource - primarily for agent consumption
+ * Examples: capabilities, settings reference
+ */
+export const ASSISTANT_FOCUSED = {
+    audience: ["assistant"],
+    priority: 0.5,
+};
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Create annotations with a custom priority
+ */
+export function withPriority(priority, base = HIGH_PRIORITY) {
+    return { ...base, priority };
+}
+/**
+ * Create annotations with lastModified timestamp
+ */
+export function withTimestamp(base = MEDIUM_PRIORITY) {
+    return { ...base, lastModified: new Date().toISOString() };
+}
+//# sourceMappingURL=resourceAnnotations.js.map

package/dist/utils/resourceAnnotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceAnnotations.js","sourceRoot":"","sources":["../../src/utils/resourceAnnotations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAwB;IAClD,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAwB;IAC/C,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwB;IACpD,QAAQ,EAAE,CAAC,WAAW,CAAC;IACvB,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,OAA4B,aAAa;IAEzC,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA4B,eAAe;IAE3C,OAAO,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAC7D,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@neverinfamous/postgres-mcp",
+  "version": "1.0.1",
+  "description": "PostgreSQL MCP server with connection pooling, tool filtering, and full extension support",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "postgres-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "check": "npm run lint && npm run typecheck"
+  },
+  "keywords": [
+    "postgresql",
+    "postgres",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "database",
+    "ai",
+    "typescript"
+  ],
+  "author": "Adamic.tech",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neverinfamous/postgres-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/neverinfamous/postgres-mcp/issues"
+  },
+  "homepage": "https://github.com/neverinfamous/postgres-mcp#readme",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "commander": "^14.0.0",
+    "jose": "^6.0.0",
+    "pg": "^8.17.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.28.0",
+    "@types/node": "^25.0.10",
+    "@types/pg": "^8.11.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.28.0",
+    "globals": "^17.1.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.53.1",
+    "vitest": "^4.0.18"
+  }
+}