@conte777/db-view-mcp 1.0.0

package/dist/connectors/clickhouse.d.ts

@@ -0,0 +1,20 @@
+import type { Connector, QueryResult, TableInfo, ColumnInfo, ExplainResult, TransactionHandle } from "./interface.js";
+import type { ClickHouseConfig } from "../config/types.js";
+export declare class ClickHouseConnector implements Connector {
+    readonly type: "clickhouse";
+    private client;
+    private config;
+    private maxRows;
+    private queryTimeout;
+    constructor(config: ClickHouseConfig, queryTimeout: number, maxRows: number);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private getClient;
+    query(sql: string, _params?: string[], maxRows?: number): Promise<QueryResult>;
+    execute(sql: string, _params?: string[]): Promise<QueryResult>;
+    listTables(_schema?: string): Promise<TableInfo[]>;
+    describeTable(table: string, _schema?: string): Promise<ColumnInfo[]>;
+    getSchema(): Promise<string>;
+    explain(sql: string): Promise<ExplainResult>;
+    beginTransaction(): Promise<TransactionHandle>;
+}

package/dist/connectors/clickhouse.js

@@ -0,0 +1,95 @@
+import { createClient } from "@clickhouse/client";
+export class ClickHouseConnector {
+    type = "clickhouse";
+    client = null;
+    config;
+    maxRows;
+    queryTimeout;
+    constructor(config, queryTimeout, maxRows) {
+        this.config = config;
+        this.queryTimeout = queryTimeout;
+        this.maxRows = maxRows;
+    }
+    async connect() {
+        this.client = createClient({
+            url: this.config.url,
+            database: this.config.database,
+            username: this.config.user,
+            password: this.config.password,
+            request_timeout: this.queryTimeout,
+        });
+        await this.client.ping();
+    }
+    async disconnect() {
+        if (this.client) {
+            await this.client.close();
+            this.client = null;
+        }
+    }
+    getClient() {
+        if (!this.client)
+            throw new Error("Not connected");
+        return this.client;
+    }
+    async query(sql, _params, maxRows) {
+        const limit = maxRows ?? this.maxRows;
+        const wrappedSql = `SELECT * FROM (${sql}) AS _q LIMIT ${limit}`;
+        const result = await this.getClient().query({ query: wrappedSql, format: "JSONEachRow" });
+        const rows = (await result.json());
+        return { rows, rowCount: rows.length };
+    }
+    async execute(sql, _params) {
+        await this.getClient().command({ query: sql });
+        return { rows: [], rowCount: 0 };
+    }
+    async listTables(_schema) {
+        const result = await this.getClient().query({
+            query: `SELECT name, engine FROM system.tables WHERE database = currentDatabase() ORDER BY name`,
+            format: "JSONEachRow",
+        });
+        const rows = (await result.json());
+        return rows.map((r) => ({
+            schema: this.config.database,
+            name: r.name,
+            type: r.engine.includes("View") ? "view" : "table",
+        }));
+    }
+    async describeTable(table, _schema) {
+        const result = await this.getClient().query({
+            query: `SELECT name, type, default_kind, default_expression, is_in_primary_key
+              FROM system.columns
+              WHERE database = currentDatabase() AND table = {table:String}
+              ORDER BY position`,
+            format: "JSONEachRow",
+            query_params: { table },
+        });
+        const rows = (await result.json());
+        return rows.map((r) => ({
+            name: r.name,
+            type: r.type,
+            nullable: r.type.startsWith("Nullable"),
+            defaultValue: r.default_expression || null,
+            isPrimaryKey: r.is_in_primary_key === 1,
+        }));
+    }
+    async getSchema() {
+        const result = await this.getClient().query({
+            query: `SELECT name, create_table_query FROM system.tables WHERE database = currentDatabase()`,
+            format: "JSONEachRow",
+        });
+        const rows = (await result.json());
+        return rows.map((r) => r.create_table_query).join(";\n\n");
+    }
+    async explain(sql) {
+        const result = await this.getClient().query({
+            query: `EXPLAIN ${sql}`,
+            format: "JSONEachRow",
+        });
+        const rows = (await result.json());
+        return { plan: rows.map((r) => r.explain).join("\n") };
+    }
+    async beginTransaction() {
+        throw new Error("Transactions are not supported in ClickHouse");
+    }
+}
+//# sourceMappingURL=clickhouse.js.map

package/dist/connectors/clickhouse.js.map

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

package/dist/connectors/interface.d.ts

@@ -0,0 +1,37 @@
+export interface QueryResult {
+    rows: Record<string, unknown>[];
+    rowCount: number;
+}
+export interface TableInfo {
+    schema: string;
+    name: string;
+    type: string;
+}
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable: boolean;
+    defaultValue: string | null;
+    isPrimaryKey: boolean;
+}
+export interface ExplainResult {
+    plan: string;
+}
+export interface TransactionHandle {
+    id: string;
+    execute(sql: string, params?: string[]): Promise<QueryResult>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+}
+export interface Connector {
+    readonly type: "postgresql" | "clickhouse";
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    query(sql: string, params?: string[], maxRows?: number): Promise<QueryResult>;
+    execute(sql: string, params?: string[]): Promise<QueryResult>;
+    listTables(schema?: string): Promise<TableInfo[]>;
+    describeTable(table: string, schema?: string): Promise<ColumnInfo[]>;
+    getSchema(): Promise<string>;
+    explain(sql: string): Promise<ExplainResult>;
+    beginTransaction(): Promise<TransactionHandle>;
+}

package/dist/connectors/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/connectors/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/connectors/interface.ts"],"names":[],"mappings":""}

package/dist/connectors/manager.d.ts

@@ -0,0 +1,14 @@
+import type { Connector } from "./interface.js";
+import type { ResolvedDatabaseConfig } from "../config/types.js";
+export declare class ConnectorManager {
+    private configs;
+    private connectors;
+    constructor(databases: ResolvedDatabaseConfig[]);
+    getDatabaseIds(): string[];
+    getConfig(dbId: string): ResolvedDatabaseConfig | undefined;
+    getAllConfigs(): ResolvedDatabaseConfig[];
+    getConnector(dbId: string): Promise<Connector>;
+    private createConnector;
+    connectEager(): Promise<void>;
+    disconnectAll(): Promise<void>;
+}

package/dist/connectors/manager.js

@@ -0,0 +1,51 @@
+import { PostgresConnector } from "./postgresql.js";
+import { ClickHouseConnector } from "./clickhouse.js";
+export class ConnectorManager {
+    configs = new Map();
+    connectors = new Map();
+    constructor(databases) {
+        for (const db of databases) {
+            this.configs.set(db.id, db);
+        }
+    }
+    getDatabaseIds() {
+        return Array.from(this.configs.keys());
+    }
+    getConfig(dbId) {
+        return this.configs.get(dbId);
+    }
+    getAllConfigs() {
+        return Array.from(this.configs.values());
+    }
+    async getConnector(dbId) {
+        const existing = this.connectors.get(dbId);
+        if (existing)
+            return existing;
+        const config = this.configs.get(dbId);
+        if (!config)
+            throw new Error(`Unknown database: ${dbId}`);
+        const connector = this.createConnector(config);
+        await connector.connect();
+        this.connectors.set(dbId, connector);
+        return connector;
+    }
+    createConnector(config) {
+        if (config.type === "postgresql") {
+            return new PostgresConnector(config, config.queryTimeout, config.maxRows);
+        }
+        if (config.type === "clickhouse") {
+            return new ClickHouseConnector(config, config.queryTimeout, config.maxRows);
+        }
+        throw new Error(`Unsupported database type: ${config.type}`);
+    }
+    async connectEager() {
+        const eagerDbs = Array.from(this.configs.values()).filter((c) => !c.lazyConnection);
+        await Promise.all(eagerDbs.map((db) => this.getConnector(db.id)));
+    }
+    async disconnectAll() {
+        const tasks = Array.from(this.connectors.values()).map((c) => c.disconnect());
+        await Promise.all(tasks);
+        this.connectors.clear();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/connectors/manager.js.map

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

package/dist/connectors/postgresql.d.ts

@@ -0,0 +1,20 @@
+import type { Connector, QueryResult, TableInfo, ColumnInfo, ExplainResult, TransactionHandle } from "./interface.js";
+import type { PostgresConfig } from "../config/types.js";
+export declare class PostgresConnector implements Connector {
+    readonly type: "postgresql";
+    private pool;
+    private config;
+    private queryTimeout;
+    private maxRows;
+    constructor(config: PostgresConfig, queryTimeout: number, maxRows: number);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private getPool;
+    query(sql: string, params?: string[], maxRows?: number): Promise<QueryResult>;
+    execute(sql: string, params?: string[]): Promise<QueryResult>;
+    listTables(schema?: string): Promise<TableInfo[]>;
+    describeTable(table: string, schema?: string): Promise<ColumnInfo[]>;
+    getSchema(): Promise<string>;
+    explain(sql: string): Promise<ExplainResult>;
+    beginTransaction(): Promise<TransactionHandle>;
+}

package/dist/connectors/postgresql.js

@@ -0,0 +1,138 @@
+import pg from "pg";
+import { randomUUID } from "node:crypto";
+export class PostgresConnector {
+    type = "postgresql";
+    pool = null;
+    config;
+    queryTimeout;
+    maxRows;
+    constructor(config, queryTimeout, maxRows) {
+        this.config = config;
+        this.queryTimeout = queryTimeout;
+        this.maxRows = maxRows;
+    }
+    async connect() {
+        this.pool = new pg.Pool({
+            host: this.config.host,
+            port: this.config.port,
+            database: this.config.database,
+            user: this.config.user,
+            password: this.config.password,
+            ssl: this.config.ssl ? { rejectUnauthorized: false } : undefined,
+            max: 10,
+        });
+        // Verify connection
+        const client = await this.pool.connect();
+        client.release();
+    }
+    async disconnect() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    getPool() {
+        if (!this.pool)
+            throw new Error("Not connected");
+        return this.pool;
+    }
+    async query(sql, params, maxRows) {
+        const limit = maxRows ?? this.maxRows;
+        const wrappedSql = `SELECT * FROM (${sql}) AS _q LIMIT ${limit}`;
+        const result = await this.getPool().query(wrappedSql, params);
+        return { rows: result.rows, rowCount: result.rows.length };
+    }
+    async execute(sql, params) {
+        const result = await this.getPool().query(sql, params);
+        return { rows: result.rows ?? [], rowCount: result.rowCount ?? 0 };
+    }
+    async listTables(schema) {
+        const s = schema ?? "public";
+        const result = await this.getPool().query(`SELECT table_schema, table_name, table_type
+       FROM information_schema.tables
+       WHERE table_schema = $1
+       ORDER BY table_name`, [s]);
+        return result.rows.map((r) => ({
+            schema: r.table_schema,
+            name: r.table_name,
+            type: r.table_type === "BASE TABLE" ? "table" : "view",
+        }));
+    }
+    async describeTable(table, schema) {
+        const s = schema ?? "public";
+        const result = await this.getPool().query(`SELECT
+         c.column_name,
+         c.data_type,
+         c.is_nullable,
+         c.column_default,
+         CASE WHEN pk.column_name IS NOT NULL THEN true ELSE false END as is_primary_key
+       FROM information_schema.columns c
+       LEFT JOIN (
+         SELECT ku.column_name
+         FROM information_schema.table_constraints tc
+         JOIN information_schema.key_column_usage ku
+           ON tc.constraint_name = ku.constraint_name
+           AND tc.table_schema = ku.table_schema
+         WHERE tc.constraint_type = 'PRIMARY KEY'
+           AND tc.table_name = $1
+           AND tc.table_schema = $2
+       ) pk ON c.column_name = pk.column_name
+       WHERE c.table_name = $1 AND c.table_schema = $2
+       ORDER BY c.ordinal_position`, [table, s]);
+        return result.rows.map((r) => ({
+            name: r.column_name,
+            type: r.data_type,
+            nullable: r.is_nullable === "YES",
+            defaultValue: r.column_default,
+            isPrimaryKey: r.is_primary_key,
+        }));
+    }
+    async getSchema() {
+        const result = await this.getPool().query(`SELECT table_name, column_name, data_type, is_nullable, column_default
+       FROM information_schema.columns
+       WHERE table_schema = 'public'
+       ORDER BY table_name, ordinal_position`);
+        const tables = new Map();
+        for (const row of result.rows) {
+            const t = row.table_name;
+            if (!tables.has(t))
+                tables.set(t, []);
+            const nullable = row.is_nullable === "YES" ? " NULL" : " NOT NULL";
+            const def = row.column_default ? ` DEFAULT ${row.column_default}` : "";
+            tables.get(t).push(`  ${row.column_name} ${row.data_type}${nullable}${def}`);
+        }
+        const lines = [];
+        for (const [table, cols] of tables) {
+            lines.push(`CREATE TABLE ${table} (`);
+            lines.push(cols.join(",\n"));
+            lines.push(`);\n`);
+        }
+        return lines.join("\n");
+    }
+    async explain(sql) {
+        const result = await this.getPool().query(`EXPLAIN ANALYZE ${sql}`);
+        const plan = result.rows.map((r) => r["QUERY PLAN"]).join("\n");
+        return { plan };
+    }
+    async beginTransaction() {
+        const client = await this.getPool().connect();
+        await client.query("BEGIN");
+        const id = randomUUID();
+        return {
+            id,
+            async execute(sql, params) {
+                const result = await client.query(sql, params);
+                return { rows: result.rows ?? [], rowCount: result.rowCount ?? 0 };
+            },
+            async commit() {
+                await client.query("COMMIT");
+                client.release();
+            },
+            async rollback() {
+                await client.query("ROLLBACK");
+                client.release();
+            },
+        };
+    }
+}
+//# sourceMappingURL=postgresql.js.map

package/dist/connectors/postgresql.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig, parseCliArgs } from "./config/loader.js";
+import { createServer } from "./server.js";
+import { startHttpTransport } from "./transport/http.js";
+async function main() {
+    const { configPath, transport: cliTransport } = parseCliArgs(process.argv.slice(2));
+    const config = loadConfig(configPath);
+    // CLI --transport overrides config
+    const transportType = cliTransport ?? config.transport.type;
+    if (transportType === "http") {
+        const transportConfig = config.transport.type === "http"
+            ? config.transport
+            : { type: "http", port: 3000, host: "127.0.0.1", stateless: false };
+        const { httpServer, manager } = await startHttpTransport(config, transportConfig);
+        const shutdown = async () => {
+            console.error("Shutting down HTTP server...");
+            httpServer.close();
+            await manager.disconnectAll();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+    else {
+        const { server, manager } = await createServer(config);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        process.on("SIGINT", async () => {
+            await manager.disconnectAll();
+            process.exit(0);
+        });
+        process.on("SIGTERM", async () => {
+            await manager.disconnectAll();
+            process.exit(0);
+        });
+    }
+}
+main().catch((err) => {
+    console.error("Failed to start db-view-mcp:", err);
+    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,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAEtC,mCAAmC;IACnC,MAAM,aAAa,GAAG,YAAY,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;IAE5D,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QAC7B,MAAM,eAAe,GACnB,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM;YAC9B,CAAC,CAAC,MAAM,CAAC,SAAS;YAClB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAEjF,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAElF,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;YAC1B,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC9C,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;QAEvD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAC/B,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConnectorManager } from "./connectors/manager.js";
+import { type AppConfig } from "./config/types.js";
+export declare function createConnectorManager(config: AppConfig): ConnectorManager;
+export declare function createMcpServerInstance(manager: ConnectorManager, config: AppConfig): McpServer;
+export declare function createServer(config: AppConfig): Promise<{
+    server: McpServer;
+    manager: ConnectorManager;
+}>;

package/dist/server.js

@@ -0,0 +1,23 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConnectorManager } from "./connectors/manager.js";
+import { registerTools } from "./tools/registry.js";
+import { resolveDbConfig } from "./config/types.js";
+export function createConnectorManager(config) {
+    const resolvedDbs = config.databases.map((db) => resolveDbConfig(db, config.defaults));
+    return new ConnectorManager(resolvedDbs);
+}
+export function createMcpServerInstance(manager, config) {
+    const server = new McpServer({
+        name: "db-view-mcp",
+        version: "1.0.0",
+    });
+    registerTools(server, manager, config.defaults);
+    return server;
+}
+export async function createServer(config) {
+    const manager = createConnectorManager(config);
+    const server = createMcpServerInstance(manager, config);
+    await manager.connectEager();
+    return { server, manager };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAkB,MAAM,mBAAmB,CAAC;AAEpE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAC9C,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CACrC,CAAC;IACF,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAyB,EACzB,MAAiB;IAEjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAiB;IAClD,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAExD,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;IAE7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/tools/readonly/describe-table.d.ts

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

package/dist/tools/readonly/describe-table.js

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

package/dist/tools/readonly/describe-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-table.js","sourceRoot":"","sources":["../../../src/tools/readonly/describe-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,UAAU,yBAAyB,CAAC,KAAe;IACvD,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAA8B,CAAC,CAAC,QAAQ,CAAC,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KACvF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAC5D,OAAO,KAAK,EAAE,MAA4D,EAAE,EAAE;QAC5E,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3E,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,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/explain.d.ts

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

package/dist/tools/readonly/explain.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { formatSuccess, formatError } from "../../utils/response.js";
+import { validateReadonlySql } from "../../utils/sql-validator.js";
+export function createExplainParams(dbIds) {
+    return {
+        database: z.enum(dbIds).describe(`Database ID. Available: ${dbIds.join(", ")}`),
+        sql: z.string().describe("SQL query to explain"),
+    };
+}
+export function explainHandler(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.explain(params.sql);
+            return formatSuccess({ data: result.plan, database: params.database });
+        }
+        catch (err) {
+            return formatError(String(err));
+        }
+    };
+}
+//# sourceMappingURL=explain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/tools/readonly/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,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,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,OAAO,KAAK,EAAE,MAAyC,EAAE,EAAE;QACzD,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,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnD,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzE,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/list-databases.d.ts

@@ -0,0 +1,7 @@
+import type { ConnectorManager } from "../../connectors/manager.js";
+export declare function listDatabasesHandler(manager: ConnectorManager): () => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

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

@@ -0,0 +1,12 @@
+import { formatSuccess } from "../../utils/response.js";
+export function listDatabasesHandler(manager) {
+    return async () => {
+        const databases = manager.getAllConfigs().map((c) => ({
+            id: c.id,
+            type: c.type,
+            description: c.description ?? "",
+        }));
+        return formatSuccess({ data: databases });
+    };
+}
+//# sourceMappingURL=list-databases.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-databases.js","sourceRoot":"","sources":["../../../src/tools/readonly/list-databases.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAC5D,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;SACjC,CAAC,CAAC,CAAC;QACJ,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/readonly/list-tables.d.ts

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