@conte777/db-view-mcp 1.0.0

package/dist/tools/readonly/list-tables.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { formatSuccess, formatError } from "../../utils/response.js";
+export function createListTablesParams(dbIds) {
+    return {
+        database: z.enum(dbIds).describe(`Database ID. Available: ${dbIds.join(", ")}`),
+        schema: z.string().optional().describe("Schema name (default: public for PostgreSQL)"),
+    };
+}
+export function listTablesHandler(manager) {
+    return async (params) => {
+        try {
+            const connector = await manager.getConnector(params.database);
+            const tables = await connector.listTables(params.schema);
+            return formatSuccess({ data: tables, database: params.database });
+        }
+        catch (err) {
+            return formatError(String(err));
+        }
+    };
+}
+//# sourceMappingURL=list-tables.js.map

package/dist/tools/readonly/list-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables.js","sourceRoot":"","sources":["../../../src/tools/readonly/list-tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,UAAU,sBAAsB,CAAC,KAAe;IACpD,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAA8B,CAAC,CAAC,QAAQ,CAAC,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KACvF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,OAAO,KAAK,EAAE,MAA6C,EAAE,EAAE;QAC7D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzD,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/readonly/performance.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import type { ConnectorManager } from "../../connectors/manager.js";
+interface SlowQuery {
+    sql: string;
+    duration: number;
+    timestamp: Date;
+    database: string;
+}
+declare class PerformanceTracker {
+    private slowQueries;
+    private threshold;
+    recordQuery(sql: string, duration: number, database: string): void;
+    getSlowQueries(database?: string, limit?: number): SlowQuery[];
+    setThreshold(ms: number): void;
+    getThreshold(): number;
+    reset(): void;
+}
+export declare const performanceTracker: PerformanceTracker;
+export declare function createPerformanceParams(dbIds: string[]): {
+    database: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    action: z.ZodEnum<{
+        getSlowQueries: "getSlowQueries";
+        getMetrics: "getMetrics";
+        reset: "reset";
+        setThreshold: "setThreshold";
+    }>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function performanceHandler(manager: ConnectorManager): (params: {
+    database: string;
+    action: string;
+    threshold?: number;
+    limit?: number;
+}) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export {};

package/dist/tools/readonly/performance.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { formatSuccess, formatError } from "../../utils/response.js";
+class PerformanceTracker {
+    slowQueries = [];
+    threshold = 1000; // ms
+    recordQuery(sql, duration, database) {
+        if (duration >= this.threshold) {
+            this.slowQueries.push({ sql, duration, timestamp: new Date(), database });
+            if (this.slowQueries.length > 100)
+                this.slowQueries.shift();
+        }
+    }
+    getSlowQueries(database, limit = 20) {
+        const filtered = database
+            ? this.slowQueries.filter((q) => q.database === database)
+            : this.slowQueries;
+        return filtered.slice(-limit);
+    }
+    setThreshold(ms) {
+        this.threshold = ms;
+    }
+    getThreshold() {
+        return this.threshold;
+    }
+    reset() {
+        this.slowQueries = [];
+    }
+}
+export const performanceTracker = new PerformanceTracker();
+export function createPerformanceParams(dbIds) {
+    return {
+        database: z.enum(dbIds).describe(`Database ID. Available: ${dbIds.join(", ")}`),
+        action: z.enum(["getSlowQueries", "getMetrics", "reset", "setThreshold"]).describe("Performance action"),
+        threshold: z.number().optional().describe("Slow query threshold in ms (for setThreshold)"),
+        limit: z.number().optional().describe("Max results (for getSlowQueries)"),
+    };
+}
+export function performanceHandler(manager) {
+    return async (params) => {
+        try {
+            switch (params.action) {
+                case "getSlowQueries":
+                    return formatSuccess({
+                        data: performanceTracker.getSlowQueries(params.database, params.limit),
+                        database: params.database,
+                    });
+                case "getMetrics":
+                    return formatSuccess({
+                        data: {
+                            slowQueryThreshold: performanceTracker.getThreshold(),
+                            connectedDatabases: manager.getDatabaseIds(),
+                        },
+                        database: params.database,
+                    });
+                case "reset":
+                    performanceTracker.reset();
+                    return formatSuccess({ data: "Performance metrics reset" });
+                case "setThreshold":
+                    if (!params.threshold)
+                        return formatError("threshold is required for setThreshold");
+                    performanceTracker.setThreshold(params.threshold);
+                    return formatSuccess({ data: `Threshold set to ${params.threshold}ms` });
+                default:
+                    return formatError(`Unknown action: ${params.action}`);
+            }
+        }
+        catch (err) {
+            return formatError(String(err));
+        }
+    };
+}
+//# sourceMappingURL=performance.js.map

package/dist/tools/readonly/performance.js.map

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

package/dist/tools/readonly/query.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import type { ConnectorManager } from "../../connectors/manager.js";
+export declare function createQueryToolParams(dbIds: string[]): {
+    database: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    sql: z.ZodString;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+};
+export declare function queryToolHandler(manager: ConnectorManager): (params: {
+    database: string;
+    sql: string;
+    maxRows?: number;
+}) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/readonly/query.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { formatRows, formatError } from "../../utils/response.js";
+import { validateReadonlySql } from "../../utils/sql-validator.js";
+export function createQueryToolParams(dbIds) {
+    return {
+        database: z.enum(dbIds).describe(`Database ID. Available: ${dbIds.join(", ")}`),
+        sql: z.string().describe("SELECT query to execute"),
+        maxRows: z.number().optional().describe("Maximum number of rows to return"),
+    };
+}
+export function queryToolHandler(manager) {
+    return async (params) => {
+        const validation = validateReadonlySql(params.sql);
+        if (!validation.valid) {
+            return formatError(validation.error, "READONLY_VIOLATION");
+        }
+        try {
+            const connector = await manager.getConnector(params.database);
+            const result = await connector.query(params.sql, undefined, params.maxRows);
+            return formatRows(result.rows, params.database);
+        }
+        catch (err) {
+            return formatError(String(err));
+        }
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/tools/readonly/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/tools/readonly/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACnD,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAA8B,CAAC,CAAC,QAAQ,CAAC,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxG,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACnD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,OAAO,KAAK,EAAE,MAA2D,EAAE,EAAE;QAC3E,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,WAAW,CAAC,UAAU,CAAC,KAAM,EAAE,oBAAoB,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5E,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/readonly/schema.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import type { ConnectorManager } from "../../connectors/manager.js";
+export declare function createSchemaParams(dbIds: string[]): {
+    database: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+};
+export declare function schemaHandler(manager: ConnectorManager): (params: {
+    database: string;
+}) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/readonly/schema.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { formatSuccess, formatError } from "../../utils/response.js";
+export function createSchemaParams(dbIds) {
+    return {
+        database: z.enum(dbIds).describe(`Database ID. Available: ${dbIds.join(", ")}`),
+    };
+}
+export function schemaHandler(manager) {
+    return async (params) => {
+        try {
+            const connector = await manager.getConnector(params.database);
+            const ddl = await connector.getSchema();
+            return formatSuccess({ data: ddl, database: params.database });
+        }
+        catch (err) {
+            return formatError(String(err));
+        }
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/tools/readonly/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/readonly/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,UAAU,kBAAkB,CAAC,KAAe;IAChD,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAA8B,CAAC,CAAC,QAAQ,CAAC,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KACzG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAyB;IACrD,OAAO,KAAK,EAAE,MAA4B,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ConnectorManager } from "../connectors/manager.js";
+import type { Defaults } from "../config/types.js";
+export declare function registerTools(server: McpServer, manager: ConnectorManager, defaults: Defaults): void;

package/dist/tools/registry.js

@@ -0,0 +1,56 @@
+import { createQueryToolParams, queryToolHandler } from "./readonly/query.js";
+import { listDatabasesHandler } from "./readonly/list-databases.js";
+import { createListTablesParams, listTablesHandler } from "./readonly/list-tables.js";
+import { createDescribeTableParams, describeTableHandler } from "./readonly/describe-table.js";
+import { createSchemaParams, schemaHandler } from "./readonly/schema.js";
+import { createExplainParams, explainHandler } from "./readonly/explain.js";
+import { createPerformanceParams, performanceHandler } from "./readonly/performance.js";
+import { createExecuteParams, executeHandler } from "./write/execute.js";
+import { createTransactionParams, transactionHandler } from "./write/transaction.js";
+export function registerTools(server, manager, defaults) {
+    const dbIds = manager.getDatabaseIds();
+    if (defaults.toolsPerDatabase) {
+        registerPerDatabaseTools(server, manager, dbIds);
+    }
+    else {
+        registerParameterTools(server, manager, dbIds);
+    }
+}
+function registerParameterTools(server, manager, dbIds) {
+    server.tool("query", `Execute a read-only SQL query. Available databases: ${dbIds.join(", ")}`, createQueryToolParams(dbIds), queryToolHandler(manager));
+    server.tool("list_databases", "List all configured databases", {}, listDatabasesHandler(manager));
+    server.tool("list_tables", `List tables in a database. Available databases: ${dbIds.join(", ")}`, createListTablesParams(dbIds), listTablesHandler(manager));
+    server.tool("describe_table", `Describe table structure. Available databases: ${dbIds.join(", ")}`, createDescribeTableParams(dbIds), describeTableHandler(manager));
+    server.tool("schema", `Get full database schema (DDL). Available databases: ${dbIds.join(", ")}`, createSchemaParams(dbIds), schemaHandler(manager));
+    server.tool("explain_query", `Run EXPLAIN ANALYZE on a query. Available databases: ${dbIds.join(", ")}`, createExplainParams(dbIds), explainHandler(manager));
+    server.tool("performance", `View performance metrics and slow queries. Available databases: ${dbIds.join(", ")}`, createPerformanceParams(dbIds), performanceHandler(manager));
+    server.tool("execute", `Execute a write SQL statement (INSERT, UPDATE, DELETE, DDL). Available databases: ${dbIds.join(", ")}`, createExecuteParams(dbIds), executeHandler(manager));
+    server.tool("transaction", `Manage database transactions (begin, execute, commit, rollback). Available databases: ${dbIds.join(", ")}`, createTransactionParams(dbIds), transactionHandler(manager));
+}
+function registerPerDatabaseTools(server, manager, dbIds) {
+    for (const dbId of dbIds) {
+        const singleDbIds = [dbId];
+        const config = manager.getConfig(dbId);
+        const desc = config.description ? ` (${config.description})` : "";
+        server.tool(`query_${dbId}`, `Execute a read-only SQL query on ${dbId}${desc}`, { sql: createQueryToolParams(singleDbIds).sql, maxRows: createQueryToolParams(singleDbIds).maxRows }, async (params) => queryToolHandler(manager)({ database: dbId, ...params }));
+        server.tool(`list_tables_${dbId}`, `List tables on ${dbId}${desc}`, { schema: createListTablesParams(singleDbIds).schema }, async (params) => listTablesHandler(manager)({ database: dbId, ...params }));
+        server.tool(`describe_table_${dbId}`, `Describe table structure on ${dbId}${desc}`, { table: createDescribeTableParams(singleDbIds).table, schema: createDescribeTableParams(singleDbIds).schema }, async (params) => describeTableHandler(manager)({ database: dbId, ...params }));
+        server.tool(`schema_${dbId}`, `Get full schema of ${dbId}${desc}`, {}, async () => schemaHandler(manager)({ database: dbId }));
+        server.tool(`explain_query_${dbId}`, `Run EXPLAIN on ${dbId}${desc}`, { sql: createExplainParams(singleDbIds).sql }, async (params) => explainHandler(manager)({ database: dbId, ...params }));
+        server.tool(`performance_${dbId}`, `Performance metrics for ${dbId}${desc}`, {
+            action: createPerformanceParams(singleDbIds).action,
+            threshold: createPerformanceParams(singleDbIds).threshold,
+            limit: createPerformanceParams(singleDbIds).limit,
+        }, async (params) => performanceHandler(manager)({ database: dbId, ...params }));
+        server.tool(`execute_${dbId}`, `Execute write SQL on ${dbId}${desc}`, { statement: createExecuteParams(singleDbIds).statement, params: createExecuteParams(singleDbIds).params }, async (params) => executeHandler(manager)({ database: dbId, ...params }));
+        server.tool(`transaction_${dbId}`, `Manage transactions on ${dbId}${desc}`, {
+            action: createTransactionParams(singleDbIds).action,
+            transactionId: createTransactionParams(singleDbIds).transactionId,
+            statement: createTransactionParams(singleDbIds).statement,
+            params: createTransactionParams(singleDbIds).params,
+        }, async (params) => transactionHandler(manager)({ database: dbId, ...params }));
+    }
+    // list_databases is always global
+    server.tool("list_databases", "List all configured databases", {}, listDatabasesHandler(manager));
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/write/execute.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import type { ConnectorManager } from "../../connectors/manager.js";
+export declare function createExecuteParams(dbIds: string[]): {
+    database: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    statement: z.ZodString;
+    params: z.ZodOptional<z.ZodArray<z.ZodString>>;
+};
+export declare function executeHandler(manager: ConnectorManager): (params: {
+    database: string;
+    statement: string;
+    params?: string[];
+}) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/write/execute.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { formatSuccess, formatError } from "../../utils/response.js";
+export function createExecuteParams(dbIds) {
+    return {
+        database: z.enum(dbIds).describe(`Database ID. Available: ${dbIds.join(", ")}`),
+        statement: z.string().describe("SQL statement to execute (INSERT, UPDATE, DELETE, DDL, etc.)"),
+        params: z.array(z.string()).optional().describe("Query parameters"),
+    };
+}
+export function executeHandler(manager) {
+    return async (params) => {
+        try {
+            const connector = await manager.getConnector(params.database);
+            const result = await connector.execute(params.statement, params.params);
+            return formatSuccess({
+                rows: result.rows,
+                count: result.rowCount,
+                database: params.database,
+            });
+        }
+        catch (err) {
+            return formatError(String(err));
+        }
+    };
+}
+//# sourceMappingURL=execute.js.map

package/dist/tools/write/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/tools/write/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,UAAU,mBAAmB,CAAC,KAAe;IACjD,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAA8B,CAAC,CAAC,QAAQ,CAAC,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;QAC9F,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,OAAO,KAAK,EAAE,MAAkE,EAAE,EAAE;QAClF,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YACxE,OAAO,aAAa,CAAC;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,QAAQ;gBACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/write/transaction.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { ConnectorManager } from "../../connectors/manager.js";
+export declare function createTransactionParams(dbIds: string[]): {
+    database: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    action: z.ZodEnum<{
+        execute: "execute";
+        commit: "commit";
+        rollback: "rollback";
+        begin: "begin";
+    }>;
+    transactionId: z.ZodOptional<z.ZodString>;
+    statement: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodArray<z.ZodString>>;
+};
+export declare function transactionHandler(manager: ConnectorManager): (params: {
+    database: string;
+    action: string;
+    transactionId?: string;
+    statement?: string;
+    params?: string[];
+}) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/write/transaction.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import { formatSuccess, formatError } from "../../utils/response.js";
+const activeTransactions = new Map();
+export function createTransactionParams(dbIds) {
+    return {
+        database: z.enum(dbIds).describe(`Database ID. Available: ${dbIds.join(", ")}`),
+        action: z.enum(["begin", "commit", "rollback", "execute"]).describe("Transaction action"),
+        transactionId: z.string().optional().describe("Transaction ID (required for commit, rollback, execute)"),
+        statement: z.string().optional().describe("SQL statement (required for execute)"),
+        params: z.array(z.string()).optional().describe("Query parameters (for execute)"),
+    };
+}
+export function transactionHandler(manager) {
+    return async (params) => {
+        try {
+            switch (params.action) {
+                case "begin": {
+                    const connector = await manager.getConnector(params.database);
+                    const tx = await connector.beginTransaction();
+                    activeTransactions.set(tx.id, tx);
+                    return formatSuccess({
+                        data: { transactionId: tx.id, message: "Transaction started" },
+                        database: params.database,
+                    });
+                }
+                case "execute": {
+                    if (!params.transactionId)
+                        return formatError("transactionId is required for execute");
+                    if (!params.statement)
+                        return formatError("statement is required for execute");
+                    const tx = activeTransactions.get(params.transactionId);
+                    if (!tx)
+                        return formatError(`Transaction not found: ${params.transactionId}`, "TX_NOT_FOUND");
+                    const result = await tx.execute(params.statement, params.params);
+                    return formatSuccess({
+                        rows: result.rows,
+                        count: result.rowCount,
+                        database: params.database,
+                    });
+                }
+                case "commit": {
+                    if (!params.transactionId)
+                        return formatError("transactionId is required for commit");
+                    const tx = activeTransactions.get(params.transactionId);
+                    if (!tx)
+                        return formatError(`Transaction not found: ${params.transactionId}`, "TX_NOT_FOUND");
+                    await tx.commit();
+                    activeTransactions.delete(params.transactionId);
+                    return formatSuccess({
+                        data: { message: "Transaction committed" },
+                        database: params.database,
+                    });
+                }
+                case "rollback": {
+                    if (!params.transactionId)
+                        return formatError("transactionId is required for rollback");
+                    const tx = activeTransactions.get(params.transactionId);
+                    if (!tx)
+                        return formatError(`Transaction not found: ${params.transactionId}`, "TX_NOT_FOUND");
+                    await tx.rollback();
+                    activeTransactions.delete(params.transactionId);
+                    return formatSuccess({
+                        data: { message: "Transaction rolled back" },
+                        database: params.database,
+                    });
+                }
+                default:
+                    return formatError(`Unknown action: ${params.action}`);
+            }
+        }
+        catch (err) {
+            return formatError(String(err));
+        }
+    };
+}
+//# sourceMappingURL=transaction.js.map

package/dist/tools/write/transaction.js.map

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

package/dist/transport/http.d.ts

@@ -0,0 +1,15 @@
+import type { Server } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ConnectorManager } from "../connectors/manager.js";
+import type { AppConfig, HttpTransportConfig } from "../config/types.js";
+interface SessionEntry {
+    transport: StreamableHTTPServerTransport;
+    server: McpServer;
+}
+export declare function startHttpTransport(config: AppConfig, transportConfig: HttpTransportConfig): Promise<{
+    httpServer: Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
+    manager: ConnectorManager;
+    sessions: Map<string, SessionEntry>;
+}>;
+export {};

package/dist/transport/http.js

@@ -0,0 +1,96 @@
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { createConnectorManager, createMcpServerInstance } from "../server.js";
+export async function startHttpTransport(config, transportConfig) {
+    const manager = createConnectorManager(config);
+    await manager.connectEager();
+    const sessions = new Map();
+    const { host, port } = transportConfig;
+    const app = createMcpExpressApp({ host });
+    if (transportConfig.auth) {
+        const expectedToken = transportConfig.auth.token;
+        app.use("/mcp", (req, res, next) => {
+            const authHeader = req.headers.authorization;
+            if (!authHeader || authHeader !== `Bearer ${expectedToken}`) {
+                res.status(401).json({ error: "Unauthorized" });
+                return;
+            }
+            next();
+        });
+    }
+    if (transportConfig.stateless) {
+        setupStatelessRoutes(app, manager, config);
+    }
+    else {
+        setupStatefulRoutes(app, manager, config, sessions);
+    }
+    setupHealthEndpoint(app, manager, sessions);
+    const httpServer = await new Promise((resolve) => {
+        const server = app.listen(port, host, () => {
+            resolve(server);
+        });
+    });
+    console.error(`db-view-mcp HTTP server listening on http://${host}:${port}/mcp`);
+    console.error(`Health check: http://${host}:${port}/health`);
+    if (transportConfig.stateless) {
+        console.error("Mode: stateless");
+    }
+    else {
+        console.error("Mode: stateful (session-based)");
+    }
+    return { httpServer, manager, sessions };
+}
+function setupStatelessRoutes(app, manager, config) {
+    app.all("/mcp", async (req, res) => {
+        const server = createMcpServerInstance(manager, config);
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+        // Close after handling since stateless has no persistent sessions
+        await transport.close();
+        await server.close();
+    });
+}
+function setupStatefulRoutes(app, manager, config, sessions) {
+    app.all("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && sessions.has(sessionId)) {
+            const session = sessions.get(sessionId);
+            await session.transport.handleRequest(req, res, req.body);
+            return;
+        }
+        if (sessionId && !sessions.has(sessionId)) {
+            res.status(404).json({ error: "Session not found" });
+            return;
+        }
+        // New session — create McpServer + transport
+        const server = createMcpServerInstance(manager, config);
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            onsessioninitialized: (newSessionId) => {
+                sessions.set(newSessionId, { transport, server });
+            },
+        });
+        transport.onclose = () => {
+            const sid = transport.sessionId;
+            if (sid) {
+                sessions.delete(sid);
+            }
+        };
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    });
+}
+function setupHealthEndpoint(app, manager, sessions) {
+    app.get("/health", (_req, res) => {
+        res.json({
+            status: "ok",
+            activeSessions: sessions.size,
+            databases: manager.getDatabaseIds(),
+        });
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/http.js.map

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

package/dist/utils/response.d.ts

@@ -0,0 +1,31 @@
+export interface SuccessResponse {
+    success: true;
+    rows?: Record<string, unknown>[];
+    count?: number;
+    database?: string;
+    data?: unknown;
+}
+export interface ErrorResponse {
+    success: false;
+    error: string;
+    code?: string;
+}
+export declare function formatSuccess(data: Omit<SuccessResponse, "success">): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function formatError(error: string, code?: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+export declare function formatRows(rows: Record<string, unknown>[], database: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};