@calebmabry/postgres-mcp-server 2.0.0

package/dist/http-server.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { randomUUID } from "crypto";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { config } from "./config.js";
+import { registerTools } from "./register-tools.js";
+import { closeDb } from "./db.js";
+import { log } from "./logger.js";
+import { VERSION, PACKAGE_NAME } from "./version.js";
+// Store active transports by session ID
+const transports = {};
+function createServer() {
+    const server = new McpServer({
+        name: PACKAGE_NAME,
+        version: VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    registerTools(server);
+    return server;
+}
+const PORT = config.server.port;
+// Get allowed hosts from environment variable or use defaults
+const allowedHostsEnv = config.server.allowedHosts;
+const allowedHosts = allowedHostsEnv
+    ? allowedHostsEnv.split(',').map(h => h.trim())
+    : undefined;
+const app = createMcpExpressApp({
+    host: '0.0.0.0',
+    allowedHosts
+});
+app.get("/health", (req, res) => {
+    res.json({ status: "ok", timestamp: new Date().toISOString() });
+});
+const mcpPostHandler = async (req, res) => {
+    try {
+        let sessionId = req.headers["mcp-session-id"];
+        // Check if this is an initialization request
+        const isInit = isInitializeRequest(req.body);
+        if (isInit) {
+            // Create new session for initialization
+            sessionId = randomUUID();
+            log.info(`New session created: ${sessionId}`, "http");
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => sessionId,
+            });
+            const server = createServer();
+            await server.connect(transport);
+            transports[sessionId] = transport;
+            // Clean up on transport close
+            const capturedSessionId = sessionId;
+            transport.onclose = () => {
+                log.info(`Session ${capturedSessionId} closed`, "http");
+                delete transports[capturedSessionId];
+            };
+        }
+        else if (!sessionId || !transports[sessionId]) {
+            res.status(400).json({
+                jsonrpc: "2.0",
+                error: {
+                    code: -32600,
+                    message: "Invalid or missing session ID",
+                },
+                id: null,
+            });
+            return;
+        }
+        const transport = transports[sessionId];
+        await transport.handleRequest(req, res, req.body);
+    }
+    catch (error) {
+        log.error("Error handling MCP request", "http", error);
+        if (!res.headersSent) {
+            res.status(500).json({
+                jsonrpc: "2.0",
+                error: {
+                    code: -32603,
+                    message: "Internal server error",
+                },
+                id: null,
+            });
+        }
+    }
+};
+app.post("/mcp", mcpPostHandler);
+// MCP GET handler for SSE streaming
+const mcpGetHandler = async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    if (!sessionId || !transports[sessionId]) {
+        res.status(400).send("Invalid or missing session ID");
+        return;
+    }
+    const lastEventId = req.headers["last-event-id"];
+    if (lastEventId) {
+        log.debug(`Client reconnecting with Last-Event-ID: ${lastEventId}`, "http");
+    }
+    else {
+        log.info(`Establishing SSE stream for session ${sessionId}`, "http");
+    }
+    // Set headers for SSE
+    res.setHeader('Cache-Control', 'no-cache');
+    res.setHeader('Connection', 'keep-alive');
+    // Handle client disconnect
+    req.on('close', () => {
+        log.info(`Client disconnected SSE stream for session ${sessionId}`, "http");
+    });
+    const transport = transports[sessionId];
+    await transport.handleRequest(req, res);
+};
+app.get("/mcp", mcpGetHandler);
+// MCP DELETE handler for session termination
+const mcpDeleteHandler = async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    if (!sessionId || !transports[sessionId]) {
+        res.status(400).send("Invalid or missing session ID");
+        return;
+    }
+    log.info(`Session termination requested: ${sessionId}`, "http");
+    try {
+        const transport = transports[sessionId];
+        await transport.handleRequest(req, res);
+    }
+    catch (error) {
+        log.error(`Error handling session termination for ${sessionId}`, "http", error);
+        if (!res.headersSent) {
+            res.status(500).send("Error processing session termination");
+        }
+    }
+};
+app.delete("/mcp", mcpDeleteHandler);
+log.banner("http", VERSION);
+const server = app.listen(PORT, () => {
+    log.info(`Listening on http://localhost:${PORT}`, "http");
+    log.info(`MCP endpoint: http://localhost:${PORT}/mcp`, "http");
+    log.info(`Health check: http://localhost:${PORT}/health`, "http");
+});
+// Configure keepalive timeout for long-running SSE connections
+server.keepAliveTimeout = 65000; // 65 seconds
+server.headersTimeout = 66000; // Slightly longer than keepAlive
+server.on("error", (error) => {
+    if (error.code === "EADDRINUSE") {
+        log.error(`Port ${PORT} is already in use. Set a different PORT env var.`, "http");
+    }
+    else {
+        log.error("Server error", "http", error);
+    }
+    process.exit(1);
+});
+process.on("uncaughtException", (error) => {
+    log.error("Uncaught exception", "http", error);
+    process.exit(1);
+});
+process.on("unhandledRejection", (reason, promise) => {
+    log.error("Unhandled rejection", "http", { reason, promise });
+    process.exit(1);
+});
+process.on("SIGINT", async () => {
+    log.warn("Shutting down server...", "http");
+    server.close(() => {
+        log.info("HTTP server closed", "http");
+    });
+    for (const sessionId in transports) {
+        try {
+            log.debug(`Closing transport for session ${sessionId}`, "http");
+            await transports[sessionId].close();
+            delete transports[sessionId];
+        }
+        catch (error) {
+            log.error(`Error closing transport for session ${sessionId}`, "http", error);
+        }
+    }
+    await closeDb();
+    log.info("Server shutdown complete", "http");
+    process.exit(0);
+});
+process.on("SIGTERM", async () => {
+    log.warn("Received SIGTERM signal...", "http");
+    process.emit("SIGINT");
+});
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerTools } from "./register-tools.js";
+import { closeDb } from "./db.js";
+import { log } from "./logger.js";
+import { VERSION, PACKAGE_NAME } from "./version.js";
+async function shutdown() {
+    await closeDb();
+    process.exit(0);
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+async function main() {
+    log.banner("stdio", VERSION);
+    const server = new McpServer({
+        name: PACKAGE_NAME,
+        version: VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    registerTools(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log.info("Server connected via stdio transport", "mcp");
+}
+main().catch((error) => {
+    log.error("Server error", "mcp", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAErD,KAAK,UAAU,QAAQ;IACrB,MAAM,OAAO,EAAE,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,KAAK,UAAU,IAAI;IACjB,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IACF,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,IAAI,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,8 @@
+export declare const log: {
+    debug: (msg: string, ctx?: string, extra?: unknown) => void;
+    info: (msg: string, ctx?: string, extra?: unknown) => void;
+    warn: (msg: string, ctx?: string, extra?: unknown) => void;
+    error: (msg: string, ctx?: string, extra?: unknown) => void;
+    banner(mode: "stdio" | "http", version: string): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AA0EA,eAAO,MAAM,GAAG;iBACD,MAAM,QAAQ,MAAM,UAAU,OAAO;gBACrC,MAAM,QAAQ,MAAM,UAAU,OAAO;gBACrC,MAAM,QAAQ,MAAM,UAAU,OAAO;iBACrC,MAAM,QAAQ,MAAM,UAAU,OAAO;iBAErC,OAAO,GAAG,MAAM,WAAW,MAAM;CAiB/C,CAAC"}

package/dist/logger.js

@@ -0,0 +1,85 @@
+import { config } from "./config.js";
+const LOG_LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+const currentLevel = config.app.logLevel;
+// ANSI escape helpers
+const esc = (code) => `\x1b[${code}m`;
+const reset = esc("0");
+const dim = esc("2");
+const bold = esc("1");
+const colors = {
+    cyan: esc("36"),
+    green: esc("32"),
+    yellow: esc("33"),
+    red: esc("31"),
+    magenta: esc("35"),
+    blue: esc("34"),
+    white: esc("37"),
+    gray: esc("90"),
+};
+const levelStyles = {
+    debug: { symbol: "◆", color: colors.magenta, label: "DEBUG" },
+    info: { symbol: "●", color: colors.cyan, label: "INFO " },
+    warn: { symbol: "▲", color: colors.yellow, label: "WARN " },
+    error: { symbol: "✖", color: colors.red, label: "ERROR" },
+};
+const contextColors = {
+    db: colors.green,
+    mcp: colors.blue,
+    http: colors.cyan,
+    query: colors.magenta,
+    tool: colors.yellow,
+};
+function timestamp() {
+    const now = new Date();
+    const h = String(now.getHours()).padStart(2, "0");
+    const m = String(now.getMinutes()).padStart(2, "0");
+    const s = String(now.getSeconds()).padStart(2, "0");
+    const ms = String(now.getMilliseconds()).padStart(3, "0");
+    return `${h}:${m}:${s}.${ms}`;
+}
+function formatContext(ctx) {
+    if (!ctx)
+        return "";
+    const c = contextColors[ctx] || colors.white;
+    return ` ${c}[${ctx}]${reset}`;
+}
+function write(level, msg, ctx, extra) {
+    if (LOG_LEVELS[level] < LOG_LEVELS[currentLevel])
+        return;
+    const style = levelStyles[level];
+    const ts = `${dim}${timestamp()}${reset}`;
+    const badge = `${style.color}${bold}${style.symbol} ${style.label}${reset}`;
+    const context = formatContext(ctx);
+    let line = `${ts} ${badge}${context} ${msg}`;
+    if (extra !== undefined) {
+        if (extra instanceof Error) {
+            line += `\n${dim}  ${extra.stack || extra.message}${reset}`;
+        }
+        else if (typeof extra === "object") {
+            line += `\n${dim}  ${JSON.stringify(extra, null, 2).split("\n").join(`\n  `)}${reset}`;
+        }
+    }
+    process.stderr.write(line + "\n");
+}
+export const log = {
+    debug: (msg, ctx, extra) => write("debug", msg, ctx, extra),
+    info: (msg, ctx, extra) => write("info", msg, ctx, extra),
+    warn: (msg, ctx, extra) => write("warn", msg, ctx, extra),
+    error: (msg, ctx, extra) => write("error", msg, ctx, extra),
+    banner(mode, version) {
+        const readOnly = config.app.readOnly ? "read-only" : "read-write";
+        const logLevel = currentLevel;
+        const lines = [
+            `${bold}${colors.cyan}┌─────────────────────────────────────────┐${reset}`,
+            `${bold}${colors.cyan}│${reset}  ${bold}${colors.white}⚡ postgres-mcp-server${reset}${" ".repeat(19)}${bold}${colors.cyan}│${reset}`,
+            `${bold}${colors.cyan}├─────────────────────────────────────────┤${reset}`,
+            `${bold}${colors.cyan}│${reset}  ${dim}version${reset}    ${colors.green}${version.padEnd(28)}${reset}${bold}${colors.cyan}│${reset}`,
+            `${bold}${colors.cyan}│${reset}  ${dim}transport${reset}  ${colors.green}${mode.padEnd(28)}${reset}${bold}${colors.cyan}│${reset}`,
+            `${bold}${colors.cyan}│${reset}  ${dim}mode${reset}       ${colors.green}${readOnly.padEnd(28)}${reset}${bold}${colors.cyan}│${reset}`,
+            `${bold}${colors.cyan}│${reset}  ${dim}log level${reset}  ${colors.green}${logLevel.padEnd(28)}${reset}${bold}${colors.cyan}│${reset}`,
+            `${bold}${colors.cyan}└─────────────────────────────────────────┘${reset}`,
+        ];
+        process.stderr.write("\n" + lines.join("\n") + "\n\n");
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/register-tools.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all PostgreSQL tools on an MCP server instance
+ */
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=register-tools.d.ts.map

package/dist/register-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-tools.d.ts","sourceRoot":"","sources":["../src/register-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6CzE;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,QA2D9C"}

package/dist/register-tools.js

@@ -0,0 +1,83 @@
+import { config } from "./config.js";
+import { QueryInputSchema, DescribeTableInputSchema, ListTablesInputSchema, ListSchemasInputSchema, ListIndexesInputSchema, ExplainQueryInputSchema, GetTableStatsInputSchema, ListViewsInputSchema, ListFunctionsInputSchema, } from "./validation.js";
+import { queryTool, MAX_PAGE_SIZE, DEFAULT_PAGE_SIZE, MAX_PAYLOAD_SIZE } from "./tools/query.js";
+import { describeTableTool, getConstraintsTool } from "./tools/describe.js";
+import { listTablesTool, listViewsTool } from "./tools/list.js";
+import { listSchemasTool } from "./tools/schemas.js";
+import { listIndexesTool } from "./tools/indexes.js";
+import { explainQueryTool, getTableStatsTool } from "./tools/performance.js";
+import { listFunctionsTool } from "./tools/functions.js";
+import { log } from "./logger.js";
+function wrapTool(name, fn) {
+    return async (args) => {
+        log.info(`${name}`, "tool");
+        log.debug(`${name} args`, "tool", args);
+        const start = performance.now();
+        const result = await fn(args);
+        const ms = (performance.now() - start).toFixed(1);
+        if (result.error) {
+            log.warn(`${name} failed (${ms}ms): ${result.error}`, "tool");
+            return {
+                content: [{ type: "text", text: `Error: ${result.error}` }],
+                isError: true,
+            };
+        }
+        log.info(`${name} completed (${ms}ms)`, "tool");
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    };
+}
+/**
+ * Register all PostgreSQL tools on an MCP server instance
+ */
+export function registerTools(server) {
+    const maxPayloadMB = (MAX_PAYLOAD_SIZE / (1024 * 1024)).toFixed(1);
+    const readOnlyMode = config.app.readOnly;
+    const queryDescription = `Execute SQL queries with pagination support and parameterized queries for security. ` +
+        `Configuration: max ${MAX_PAGE_SIZE} rows/page (default ${DEFAULT_PAGE_SIZE}), max ${maxPayloadMB}MB payload size. ` +
+        `${readOnlyMode ? "READ-ONLY mode: only SELECT, WITH, and EXPLAIN queries allowed. " : ""}` +
+        `Pagination automatically applied to SELECT queries without LIMIT/OFFSET.`;
+    server.registerTool("query", {
+        description: queryDescription,
+        inputSchema: QueryInputSchema,
+    }, wrapTool("query", queryTool));
+    server.registerTool("describe_table", {
+        description: "Get the structure of a database table",
+        inputSchema: DescribeTableInputSchema,
+    }, wrapTool("describe_table", describeTableTool));
+    server.registerTool("list_tables", {
+        description: "List all tables in a schema",
+        inputSchema: ListTablesInputSchema,
+    }, wrapTool("list_tables", listTablesTool));
+    server.registerTool("get_constraints", {
+        description: "Get constraints for a table",
+        inputSchema: DescribeTableInputSchema,
+    }, wrapTool("get_constraints", getConstraintsTool));
+    server.registerTool("list_schemas", {
+        description: "List all schemas in the database",
+        inputSchema: ListSchemasInputSchema,
+    }, wrapTool("list_schemas", listSchemasTool));
+    server.registerTool("list_indexes", {
+        description: "List indexes for a table or schema",
+        inputSchema: ListIndexesInputSchema,
+    }, wrapTool("list_indexes", listIndexesTool));
+    server.registerTool("explain_query", {
+        description: "Get query execution plan (EXPLAIN)",
+        inputSchema: ExplainQueryInputSchema,
+    }, wrapTool("explain_query", explainQueryTool));
+    server.registerTool("get_table_stats", {
+        description: "Get table statistics and size information",
+        inputSchema: GetTableStatsInputSchema,
+    }, wrapTool("get_table_stats", getTableStatsTool));
+    server.registerTool("list_views", {
+        description: "List views in a schema",
+        inputSchema: ListViewsInputSchema,
+    }, wrapTool("list_views", listViewsTool));
+    server.registerTool("list_functions", {
+        description: "List functions and procedures in a schema",
+        inputSchema: ListFunctionsInputSchema,
+    }, wrapTool("list_functions", listFunctionsTool));
+    log.info(`Registered 10 tools`, "mcp");
+}
+//# sourceMappingURL=register-tools.js.map

package/dist/register-tools.js.map

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

package/dist/tools/describe.d.ts

@@ -0,0 +1,31 @@
+export interface DescribeTableInput {
+    schema: string;
+    table: string;
+}
+export interface ColumnInfo {
+    column_name: string;
+    data_type: string;
+    character_maximum_length: number | null;
+    is_nullable: string;
+    column_default: string | null;
+}
+export interface DescribeTableOutput {
+    columns?: ColumnInfo[];
+    error?: string;
+}
+export declare function describeTableTool(input: DescribeTableInput): Promise<DescribeTableOutput>;
+export interface GetConstraintsInput {
+    schema: string;
+    table: string;
+}
+export interface ConstraintInfo {
+    constraint_name: string;
+    constraint_type: string;
+    constraint_definition: string;
+}
+export interface GetConstraintsOutput {
+    constraints?: ConstraintInfo[];
+    error?: string;
+}
+export declare function getConstraintsTool(input: GetConstraintsInput): Promise<GetConstraintsOutput>;
+//# sourceMappingURL=describe.d.ts.map

package/dist/tools/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/tools/describe.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2B/F;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiClG"}

package/dist/tools/describe.js

@@ -0,0 +1,61 @@
+import { getDb } from '../db.js';
+import { sql } from 'kysely';
+export async function describeTableTool(input) {
+    try {
+        const db = getDb();
+        const query = sql `
+      SELECT 
+        column_name,
+        data_type,
+        character_maximum_length,
+        is_nullable,
+        column_default
+      FROM information_schema.columns
+      WHERE table_schema = ${input.schema}
+        AND table_name = ${input.table}
+      ORDER BY ordinal_position
+    `;
+        const result = await query.execute(db);
+        return {
+            columns: result.rows,
+        };
+    }
+    catch (error) {
+        return {
+            error: error instanceof Error ? error.message : 'Unknown error occurred',
+        };
+    }
+}
+export async function getConstraintsTool(input) {
+    try {
+        const db = getDb();
+        const query = sql `
+      SELECT 
+        c.conname as constraint_name,
+        CASE c.contype
+          WHEN 'p' THEN 'PRIMARY KEY'
+          WHEN 'f' THEN 'FOREIGN KEY'
+          WHEN 'u' THEN 'UNIQUE'
+          WHEN 'c' THEN 'CHECK'
+          ELSE c.contype
+        END as constraint_type,
+        pg_get_constraintdef(c.oid) as constraint_definition
+      FROM pg_constraint c
+      JOIN pg_namespace n ON n.oid = c.connamespace
+      JOIN pg_class cl ON cl.oid = c.conrelid
+      WHERE n.nspname = ${input.schema}
+        AND cl.relname = ${input.table}
+      ORDER BY c.conname
+    `;
+        const result = await query.execute(db);
+        return {
+            constraints: result.rows,
+        };
+    }
+    catch (error) {
+        return {
+            error: error instanceof Error ? error.message : 'Unknown error occurred',
+        };
+    }
+}
+//# sourceMappingURL=describe.js.map

package/dist/tools/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/tools/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAoB7B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAyB;IAC/D,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QAEnB,MAAM,KAAK,GAAG,GAAG,CAAY;;;;;;;;6BAQJ,KAAK,CAAC,MAAM;2BACd,KAAK,CAAC,KAAK;;KAEjC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEvC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,IAAI;SACrB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;SACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAkBD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAA0B;IACjE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QAEnB,MAAM,KAAK,GAAG,GAAG,CAAgB;;;;;;;;;;;;;;0BAcX,KAAK,CAAC,MAAM;2BACX,KAAK,CAAC,KAAK;;KAEjC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEvC,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,IAAI;SACzB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;SACzE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/functions.d.ts

@@ -0,0 +1,20 @@
+export interface FunctionInfo {
+    schema_name: string;
+    function_name: string;
+    return_type: string;
+    argument_types: string;
+    function_type: string;
+    language: string;
+    is_aggregate: boolean;
+    is_window: boolean;
+    security_type: string;
+    volatility: string;
+    parallel_safety: string;
+    description?: string;
+}
+export interface ListFunctionsOutput {
+    functions?: FunctionInfo[];
+    error?: string;
+}
+export declare function listFunctionsTool(input: unknown): Promise<ListFunctionsOutput>;
+//# sourceMappingURL=functions.d.ts.map

package/dist/tools/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/tools/functions.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+DpF"}

package/dist/tools/functions.js

@@ -0,0 +1,65 @@
+import { getDb } from '../db.js';
+import { sql } from 'kysely';
+import { ListFunctionsInputSchema, validateInput } from '../validation.js';
+export async function listFunctionsTool(input) {
+    try {
+        // Validate input
+        const validation = validateInput(ListFunctionsInputSchema, input);
+        if (!validation.success) {
+            return { error: `Input validation failed: ${validation.error}` };
+        }
+        const validatedInput = validation.data;
+        const db = getDb();
+        const schema = validatedInput.schema || 'public';
+        const query = sql `
+      SELECT 
+        n.nspname as schema_name,
+        p.proname as function_name,
+        pg_get_function_result(p.oid) as return_type,
+        pg_get_function_arguments(p.oid) as argument_types,
+        CASE p.prokind
+          WHEN 'f' THEN 'function'
+          WHEN 'p' THEN 'procedure'
+          WHEN 'a' THEN 'aggregate'
+          WHEN 'w' THEN 'window'
+          ELSE 'unknown'
+        END as function_type,
+        l.lanname as language,
+        CASE WHEN p.prokind = 'a' THEN true ELSE false END as is_aggregate,
+        CASE WHEN p.prokind = 'w' THEN true ELSE false END as is_window,
+        CASE p.prosecdef
+          WHEN true THEN 'definer'
+          ELSE 'invoker'
+        END as security_type,
+        CASE p.provolatile
+          WHEN 'i' THEN 'immutable'
+          WHEN 's' THEN 'stable'
+          WHEN 'v' THEN 'volatile'
+          ELSE 'unknown'
+        END as volatility,
+        CASE p.proparallel
+          WHEN 's' THEN 'safe'
+          WHEN 'r' THEN 'restricted'
+          WHEN 'u' THEN 'unsafe'
+          ELSE 'unknown'
+        END as parallel_safety,
+        obj_description(p.oid) as description
+      FROM pg_proc p
+      JOIN pg_namespace n ON n.oid = p.pronamespace
+      JOIN pg_language l ON l.oid = p.prolang
+      WHERE n.nspname = ${schema}
+        AND p.prokind IN ('f', 'p', 'a', 'w')
+      ORDER BY function_type, function_name
+    `;
+        const result = await query.execute(db);
+        return {
+            functions: result.rows,
+        };
+    }
+    catch (error) {
+        return {
+            error: error instanceof Error ? error.message : 'Unknown error occurred',
+        };
+    }
+}
+//# sourceMappingURL=functions.js.map