@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/DatabaseAdapter.js

@@ -0,0 +1,250 @@
+/**
+ * postgres-mcp - Database Adapter Interface
+ *
+ * Abstract base class that all database adapters must implement.
+ * Provides a consistent interface for database operations.
+ */
+import { z } from "zod";
+import { logger } from "../utils/logger.js";
+/**
+ * Abstract base class for database adapters
+ */
+export class DatabaseAdapter {
+    /** Connection state */
+    connected = false;
+    /**
+     * Check if connected to the database
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Register tools with the MCP server
+     * @param server - MCP server instance
+     * @param enabledTools - Set of enabled tool names (from filtering)
+     */
+    registerTools(server, enabledTools) {
+        const tools = this.getToolDefinitions();
+        let registered = 0;
+        for (const tool of tools) {
+            if (enabledTools.has(tool.name)) {
+                this.registerTool(server, tool);
+                registered++;
+            }
+        }
+        logger.info(`Registered ${String(registered)}/${String(tools.length)} tools from ${this.name}`, { module: "SERVER" });
+    }
+    /**
+     * Register a single tool with the MCP server
+     */
+    registerTool(server, tool) {
+        // MCP SDK server.tool() registration
+        // Extract the Zod shape from inputSchema for MCP SDK compatibility
+        // Handle complex chains: z.preprocess().transform().refine() etc.
+        const zodShape = this.extractZodShape(tool.inputSchema);
+        // Build metadata object with annotations and icons
+        const metadata = {
+            ...(tool.annotations ?? {}),
+        };
+        if (tool.icons && tool.icons.length > 0) {
+            metadata["icons"] = tool.icons;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        server.tool(tool.name, tool.description, 
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        zodShape, 
+        // Pass annotations and icons (SDK 1.25+)
+        metadata, async (params) => {
+            const context = this.createContext();
+            const result = await tool.handler(params, context);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: typeof result === "string"
+                            ? result
+                            : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        });
+    }
+    /**
+     * Extract the Zod shape from a schema, handling complex pipelines
+     * Traverses through: preprocess, transform, effects, refine, pipe
+     */
+    extractZodShape(schema) {
+        if (schema === null || schema === undefined) {
+            return {};
+        }
+        const s = schema;
+        // Direct ZodObject - has shape directly
+        if (s.shape !== undefined && typeof s.shape === "object") {
+            return s.shape;
+        }
+        // Check _def for wrapped types
+        if (s._def !== undefined) {
+            // ZodEffects (preprocess, transform, refine) - dive into innerType
+            if (s._def.innerType !== undefined) {
+                return this.extractZodShape(s._def.innerType);
+            }
+            // ZodPipeline or other wrapped - dive into schema
+            if (s._def.schema !== undefined) {
+                return this.extractZodShape(s._def.schema);
+            }
+        }
+        return {};
+    }
+    /**
+     * Register resources with the MCP server
+     */
+    registerResources(server) {
+        const resources = this.getResourceDefinitions();
+        for (const resource of resources) {
+            this.registerResource(server, resource);
+        }
+        logger.info(`Registered ${String(resources.length)} resources from ${this.name}`, { module: "SERVER" });
+    }
+    /**
+     * Register a single resource with the MCP server
+     */
+    registerResource(server, resource) {
+        server.registerResource(resource.name, resource.uri, {
+            description: resource.description,
+            mimeType: resource.mimeType ?? "application/json",
+            // Pass annotations if defined (SDK 1.25+)
+            ...(resource.annotations && { annotations: resource.annotations }),
+        }, async (uri) => {
+            const context = this.createContext();
+            const result = await resource.handler(uri.toString(), context);
+            return {
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        mimeType: resource.mimeType ?? "application/json",
+                        text: typeof result === "string"
+                            ? result
+                            : JSON.stringify(result, null, 2),
+                        // Include annotations in contents response for resource reads
+                        ...(resource.annotations && {
+                            annotations: resource.annotations,
+                        }),
+                    },
+                ],
+            };
+        });
+    }
+    /**
+     * Register prompts with the MCP server
+     */
+    registerPrompts(server) {
+        const prompts = this.getPromptDefinitions();
+        for (const prompt of prompts) {
+            this.registerPrompt(server, prompt);
+        }
+        logger.info(`Registered ${String(prompts.length)} prompts from ${this.name}`, { module: "SERVER" });
+    }
+    /**
+     * Register a single prompt with the MCP server
+     */
+    registerPrompt(server, prompt) {
+        // Build Zod schema from prompt.arguments definitions
+        const zodShape = {};
+        if (prompt.arguments) {
+            for (const arg of prompt.arguments) {
+                zodShape[arg.name] = arg.required
+                    ? z.string().describe(arg.description)
+                    : z.string().optional().describe(arg.description);
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        server.prompt(prompt.name, prompt.description, zodShape, async (providedArgs) => {
+            const context = this.createContext();
+            const args = providedArgs;
+            const result = await prompt.handler(args, context);
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: typeof result === "string"
+                                ? result
+                                : JSON.stringify(result, null, 2),
+                        },
+                    },
+                ],
+            };
+        });
+    }
+    // =========================================================================
+    // Query Validation
+    // =========================================================================
+    /**
+     * Validate query for safety (SQL injection prevention)
+     * @param sql - SQL query to validate
+     * @param isReadOnly - Whether to enforce read-only restrictions
+     */
+    validateQuery(sql, isReadOnly) {
+        if (!sql || typeof sql !== "string") {
+            throw new Error("Query must be a non-empty string");
+        }
+        const normalizedSql = sql.trim().toUpperCase();
+        // Check for dangerous patterns
+        const dangerousPatterns = [
+            /;\s*DROP\s+/i,
+            /;\s*DELETE\s+/i,
+            /;\s*TRUNCATE\s+/i,
+            /;\s*INSERT\s+/i,
+            /;\s*UPDATE\s+/i,
+            /--\s*$/m,
+        ];
+        for (const pattern of dangerousPatterns) {
+            if (pattern.test(sql)) {
+                throw new Error("Query contains potentially dangerous patterns");
+            }
+        }
+        // Enforce read-only for SELECT queries
+        if (isReadOnly) {
+            const writeKeywords = [
+                "INSERT",
+                "UPDATE",
+                "DELETE",
+                "DROP",
+                "CREATE",
+                "ALTER",
+                "TRUNCATE",
+                "GRANT",
+                "REVOKE",
+            ];
+            for (const keyword of writeKeywords) {
+                if (normalizedSql.startsWith(keyword)) {
+                    throw new Error(`Read-only mode: ${keyword} statements are not allowed`);
+                }
+            }
+        }
+    }
+    /**
+     * Create a request context for tool execution
+     */
+    createContext(requestId) {
+        return {
+            timestamp: new Date(),
+            requestId: requestId ?? crypto.randomUUID(),
+        };
+    }
+    /**
+     * Get adapter info for logging/debugging
+     */
+    getInfo() {
+        return {
+            type: this.type,
+            name: this.name,
+            version: this.version,
+            connected: this.connected,
+            capabilities: this.getCapabilities(),
+            toolGroups: this.getSupportedToolGroups(),
+        };
+    }
+}
+//# sourceMappingURL=DatabaseAdapter.js.map

package/dist/adapters/DatabaseAdapter.js.map

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

package/dist/adapters/postgresql/PostgresAdapter.d.ts

@@ -0,0 +1,119 @@
+/**
+ * postgres-mcp - PostgreSQL Adapter
+ *
+ * Main PostgreSQL database adapter with connection pooling,
+ * query execution, and tool registration.
+ */
+import type { PoolClient } from "pg";
+import { DatabaseAdapter } from "../DatabaseAdapter.js";
+import { ConnectionPool } from "../../pool/ConnectionPool.js";
+import type { DatabaseConfig, QueryResult, SchemaInfo, TableInfo, IndexInfo, HealthStatus, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition, ToolGroup } from "../../types/index.js";
+export declare class PostgresAdapter extends DatabaseAdapter {
+    readonly type: "postgresql";
+    readonly name = "PostgreSQL Adapter";
+    readonly version = "0.1.0";
+    private pool;
+    private activeTransactions;
+    private cachedToolDefinitions;
+    private metadataCache;
+    private cacheTtlMs;
+    /**
+     * Get cached value if not expired
+     */
+    private getCached;
+    /**
+     * Set cache value
+     */
+    private setCache;
+    /**
+     * Clear all cached metadata (useful after schema changes)
+     */
+    clearMetadataCache(): void;
+    connect(config: DatabaseConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    getHealth(): Promise<HealthStatus>;
+    executeReadQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    executeWriteQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    executeQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute a query on a specific connection (for transactions)
+     */
+    executeOnConnection(client: PoolClient, sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Begin a transaction
+     */
+    beginTransaction(isolationLevel?: string): Promise<string>;
+    /**
+     * Commit a transaction
+     */
+    commitTransaction(transactionId: string): Promise<void>;
+    /**
+     * Rollback a transaction
+     */
+    rollbackTransaction(transactionId: string): Promise<void>;
+    /**
+     * Create a savepoint
+     */
+    createSavepoint(transactionId: string, savepointName: string): Promise<void>;
+    /**
+     * Release a savepoint
+     */
+    releaseSavepoint(transactionId: string, savepointName: string): Promise<void>;
+    /**
+     * Rollback to a savepoint
+     */
+    rollbackToSavepoint(transactionId: string, savepointName: string): Promise<void>;
+    /**
+     * Get connection for a transaction
+     */
+    getTransactionConnection(transactionId: string): PoolClient | undefined;
+    getSchema(): Promise<SchemaInfo>;
+    /**
+     * Get all indexes across all user tables in a single query
+     * Performance optimization: eliminates N+1 query pattern
+     * Public so it can be used by pg_get_indexes when no table is specified
+     */
+    getAllIndexes(): Promise<IndexInfo[]>;
+    /**
+     * Parse columns from PostgreSQL array format
+     * Handles both native arrays and string representations like "{col1,col2}"
+     */
+    private parseColumnsArray;
+    /**
+     * Extract expression columns from index definition when column names are NULL.
+     * Expression indexes (like LOWER(name)) have attnum=0 which returns NULL from pg_attribute.
+     * This method parses the index definition to extract the actual expressions.
+     */
+    private extractIndexColumns;
+    /**
+     * Extract the column expression part from an index definition, handling nested parentheses.
+     * E.g., "CREATE INDEX idx ON tbl USING btree (lower(name))" → "lower(name)"
+     */
+    private extractIndexExpressionPart;
+    /**
+     * Parse index expressions from the column list, handling nested parentheses.
+     * E.g., "LOWER(name), id, UPPER(TRIM(email))" → ["LOWER(name)", "id", "UPPER(TRIM(email))"]
+     */
+    private parseIndexExpressions;
+    listTables(): Promise<TableInfo[]>;
+    describeTable(tableName: string, schemaName?: string): Promise<TableInfo>;
+    listSchemas(): Promise<string[]>;
+    /**
+     * Get indexes for a table
+     */
+    getTableIndexes(tableName: string, schemaName?: string): Promise<IndexInfo[]>;
+    /**
+     * Check if an extension is available
+     */
+    isExtensionAvailable(extensionName: string): Promise<boolean>;
+    getCapabilities(): AdapterCapabilities;
+    getSupportedToolGroups(): ToolGroup[];
+    getToolDefinitions(): ToolDefinition[];
+    getResourceDefinitions(): ResourceDefinition[];
+    getPromptDefinitions(): PromptDefinition[];
+    /**
+     * Get the connection pool (for monitoring tools)
+     */
+    getPool(): ConnectionPool | null;
+}
+//# sourceMappingURL=PostgresAdapter.d.ts.map

package/dist/adapters/postgresql/PostgresAdapter.d.ts.map

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