@connorbritain/mssql-mcp-reader 0.1.0

package/dist/tools/DescribeTableTool.js

@@ -0,0 +1,108 @@
+import sql from "mssql";
+import { getEnvironmentManager } from "../config/EnvironmentManager.js";
+export class DescribeTableTool {
+    constructor() {
+        this.name = "describe_table";
+        this.description = "Describes the schema (columns and types) of a specified MSSQL Database table. " +
+            "For server-level access environments, you can specify a database to target.";
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                tableName: {
+                    type: "string",
+                    description: "Name of the table to describe (can include schema: 'dbo.TableName')",
+                },
+                database: {
+                    type: "string",
+                    description: "Optional: Target database name for server-level access environments.",
+                },
+            },
+            required: ["tableName"],
+        };
+    }
+    async run(params) {
+        try {
+            const { tableName, database, environment } = params;
+            // Validate database access if specified
+            if (database) {
+                const envManager = getEnvironmentManager();
+                const dbCheck = envManager.isDatabaseAllowed(environment, database);
+                if (!dbCheck.allowed) {
+                    return {
+                        success: false,
+                        message: dbCheck.reason || `Access to database '${database}' is not allowed.`,
+                        error: "DATABASE_ACCESS_DENIED",
+                    };
+                }
+            }
+            // Parse schema and table name
+            let schemaName = "dbo";
+            let actualTableName = tableName;
+            if (tableName.includes(".")) {
+                const parts = tableName.split(".");
+                schemaName = parts[0];
+                actualTableName = parts[1];
+            }
+            const request = new sql.Request();
+            // Build query with optional database context
+            let query;
+            if (database) {
+                const safeDbName = database.replace(/]/g, "]]");
+                query = `
+          USE [${safeDbName}];
+          SELECT
+            COLUMN_NAME as name,
+            DATA_TYPE as type,
+            CHARACTER_MAXIMUM_LENGTH as max_length,
+            IS_NULLABLE as nullable,
+            COLUMN_DEFAULT as default_value,
+            ORDINAL_POSITION as position
+          FROM INFORMATION_SCHEMA.COLUMNS
+          WHERE TABLE_NAME = @tableName AND TABLE_SCHEMA = @schemaName
+          ORDER BY ORDINAL_POSITION
+        `;
+            }
+            else {
+                query = `
+          SELECT
+            COLUMN_NAME as name,
+            DATA_TYPE as type,
+            CHARACTER_MAXIMUM_LENGTH as max_length,
+            IS_NULLABLE as nullable,
+            COLUMN_DEFAULT as default_value,
+            ORDINAL_POSITION as position
+          FROM INFORMATION_SCHEMA.COLUMNS
+          WHERE TABLE_NAME = @tableName AND TABLE_SCHEMA = @schemaName
+          ORDER BY ORDINAL_POSITION
+        `;
+            }
+            request.input("tableName", sql.NVarChar, actualTableName);
+            request.input("schemaName", sql.NVarChar, schemaName);
+            const result = await request.query(query);
+            if (result.recordset.length === 0) {
+                return {
+                    success: false,
+                    message: `Table '${schemaName}.${actualTableName}' not found${database ? ` in database [${database}]` : ""}.`,
+                    error: "TABLE_NOT_FOUND",
+                };
+            }
+            return {
+                success: true,
+                message: `Described table '${schemaName}.${actualTableName}'${database ? ` in [${database}]` : ""}`,
+                database: database || undefined,
+                schema: schemaName,
+                tableName: actualTableName,
+                columnCount: result.recordset.length,
+                columns: result.recordset,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to describe table: ${error}`,
+                error: "QUERY_FAILED",
+            };
+        }
+    }
+}
+//# sourceMappingURL=DescribeTableTool.js.map

package/dist/tools/DescribeTableTool.js.map

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

package/dist/tools/ExplainQueryTool.d.ts

@@ -0,0 +1,24 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare class ExplainQueryTool implements Tool {
+    [key: string]: any;
+    name: string;
+    description: string;
+    inputSchema: any;
+    run(params: any): Promise<{
+        success: boolean;
+        message: string;
+        hasPlanXml: boolean;
+    } | {
+        success: boolean;
+        message: string;
+        error: string;
+    } | {
+        planXml: string;
+        success: boolean;
+        message: string;
+        hasPlanXml: boolean;
+        error?: undefined;
+    }>;
+    private extractPlanXml;
+}
+//# sourceMappingURL=ExplainQueryTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExplainQueryTool.d.ts","sourceRoot":"","sources":["../../src/tools/ExplainQueryTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,qBAAa,gBAAiB,YAAW,IAAI;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,SAAmB;IACvB,WAAW,SAAgG;IAE3G,WAAW,EAiBN,GAAG,CAAC;IAEH,GAAG,CAAC,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;IA4DrB,OAAO,CAAC,cAAc;CAuBvB"}

package/dist/tools/ExplainQueryTool.js

@@ -0,0 +1,98 @@
+import sql from "mssql";
+import { getEnvironmentManager } from "../config/EnvironmentManager.js";
+export class ExplainQueryTool {
+    constructor() {
+        this.name = "explain_query";
+        this.description = "Generates an estimated execution plan (SHOWPLAN_XML) for a SQL query without executing it.";
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "SQL statement to analyze (typically SELECT/UPDATE/INSERT/DELETE).",
+                },
+                environment: {
+                    type: "string",
+                    description: "Optional environment name to target (prod, staging, etc).",
+                },
+                includePlanXml: {
+                    type: "boolean",
+                    description: "If true (default), returns the raw SHOWPLAN XML. Set false for summary only.",
+                },
+            },
+            required: ["query"],
+        };
+    }
+    async run(params) {
+        const { query, includePlanXml = true, environment } = params ?? {};
+        if (typeof query !== "string" || !query.trim()) {
+            return {
+                success: false,
+                message: "explain_query requires a non-empty SQL string.",
+                error: "INVALID_QUERY",
+            };
+        }
+        const sanitizedQuery = query.trim();
+        const envManager = getEnvironmentManager();
+        const pool = await envManager.getConnection(environment);
+        let showplanEnabled = false;
+        try {
+            const planRequest = new sql.Request(pool);
+            await planRequest.batch("SET SHOWPLAN_XML ON;");
+            showplanEnabled = true;
+            const explainRequest = new sql.Request(pool);
+            const result = await explainRequest.query(sanitizedQuery);
+            const planOutput = result.recordset?.[0];
+            const planXml = this.extractPlanXml(planOutput);
+            const summary = {
+                success: true,
+                message: "Generated estimated execution plan.",
+                hasPlanXml: Boolean(planXml),
+            };
+            if (includePlanXml && planXml) {
+                return {
+                    ...summary,
+                    planXml,
+                };
+            }
+            return summary;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                message: `Failed to generate plan: ${errorMessage}`,
+                error: "SHOWPLAN_FAILED",
+            };
+        }
+        finally {
+            if (showplanEnabled) {
+                try {
+                    const resetRequest = new sql.Request(pool);
+                    await resetRequest.batch("SET SHOWPLAN_XML OFF;");
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+    }
+    extractPlanXml(row) {
+        if (!row) {
+            return null;
+        }
+        const knownColumns = [
+            "ShowPlanXML",
+            "Microsoft SQL Server 2005 XML Showplan",
+            "Plan",
+        ];
+        for (const column of knownColumns) {
+            if (row[column]) {
+                return row[column];
+            }
+        }
+        const firstXml = Object.values(row).find((value) => typeof value === "string" && value.trim().startsWith("<?xml"));
+        return firstXml ?? null;
+    }
+}
+//# sourceMappingURL=ExplainQueryTool.js.map

package/dist/tools/ExplainQueryTool.js.map

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

package/dist/tools/InspectDependenciesTool.d.ts

@@ -0,0 +1,45 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+interface DependencyReference {
+    name: string;
+    schema: string;
+    type: string;
+    columns?: string[];
+}
+interface DependencyResult {
+    success: boolean;
+    object: string;
+    objectType?: string;
+    referencedBy?: {
+        views: DependencyReference[];
+        storedProcedures: DependencyReference[];
+        functions: DependencyReference[];
+        triggers: DependencyReference[];
+        foreignKeys: {
+            table: string;
+            schema: string;
+            column: string;
+            constraint: string;
+        }[];
+    };
+    references?: {
+        tables: DependencyReference[];
+        views: DependencyReference[];
+        functions: DependencyReference[];
+    };
+    message?: string;
+    error?: string;
+    hint?: string;
+}
+export declare class InspectDependenciesTool implements Tool {
+    [key: string]: any;
+    name: string;
+    description: string;
+    inputSchema: any;
+    run(params: {
+        objectName: string;
+        includeColumns?: boolean;
+        environment?: string;
+    }): Promise<DependencyResult>;
+}
+export {};
+//# sourceMappingURL=InspectDependenciesTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InspectDependenciesTool.d.ts","sourceRoot":"","sources":["../../src/tools/InspectDependenciesTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE;QACb,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAC7B,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;QACxC,SAAS,EAAE,mBAAmB,EAAE,CAAC;QACjC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;QAChC,WAAW,EAAE;YACX,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;SACpB,EAAE,CAAC;KACL,CAAC;IACF,UAAU,CAAC,EAAE;QACX,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAC9B,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAC7B,SAAS,EAAE,mBAAmB,EAAE,CAAC;KAClC,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,uBAAwB,YAAW,IAAI;IAClD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,SAA0B;IAC9B,WAAW,SAA0H;IAErI,WAAW,EAaN,GAAG,CAAC;IAEH,GAAG,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;CAsNzF"}

package/dist/tools/InspectDependenciesTool.js

@@ -0,0 +1,215 @@
+import sql from "mssql";
+export class InspectDependenciesTool {
+    constructor() {
+        this.name = "inspect_dependencies";
+        this.description = "Shows what database objects depend on a table, view, or other object. Use for impact analysis before schema changes.";
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                objectName: {
+                    type: "string",
+                    description: "Name of the object to inspect (e.g., 'dbo.Customers' or 'Customers')",
+                },
+                includeColumns: {
+                    type: "boolean",
+                    description: "Include column-level dependency details. Default: false",
+                },
+            },
+            required: ["objectName"],
+        };
+    }
+    async run(params) {
+        const { objectName, includeColumns = false } = params;
+        try {
+            // Parse schema and object name
+            const parts = objectName.split(".");
+            let schemaName = "dbo";
+            let objName = objectName;
+            if (parts.length === 2) {
+                schemaName = parts[0];
+                objName = parts[1];
+            }
+            const pool = sql.globalPool;
+            if (!pool) {
+                return {
+                    success: false,
+                    object: objectName,
+                    error: "NO_CONNECTION",
+                    message: "No database connection available.",
+                };
+            }
+            // First, get the object type
+            const objectTypeResult = await pool.request()
+                .input("schema", sql.NVarChar, schemaName)
+                .input("name", sql.NVarChar, objName)
+                .query(`
+          SELECT
+            o.type_desc AS objectType,
+            o.object_id AS objectId
+          FROM sys.objects o
+          INNER JOIN sys.schemas s ON o.schema_id = s.schema_id
+          WHERE s.name = @schema AND o.name = @name
+        `);
+            if (objectTypeResult.recordset.length === 0) {
+                return {
+                    success: false,
+                    object: objectName,
+                    error: "OBJECT_NOT_FOUND",
+                    message: `Object '${schemaName}.${objName}' not found.`,
+                };
+            }
+            const objectType = objectTypeResult.recordset[0].objectType;
+            const objectId = objectTypeResult.recordset[0].objectId;
+            // Get objects that reference this object (what depends on this)
+            const referencedByResult = await pool.request()
+                .input("schema", sql.NVarChar, schemaName)
+                .input("name", sql.NVarChar, objName)
+                .query(`
+          SELECT DISTINCT
+            OBJECT_SCHEMA_NAME(d.referencing_id) AS referencingSchema,
+            OBJECT_NAME(d.referencing_id) AS referencingName,
+            o.type_desc AS referencingType
+          FROM sys.sql_expression_dependencies d
+          INNER JOIN sys.objects o ON d.referencing_id = o.object_id
+          WHERE d.referenced_schema_name = @schema
+            AND d.referenced_entity_name = @name
+            AND d.referencing_id != d.referenced_id
+          ORDER BY o.type_desc, referencingName
+        `);
+            // Get foreign keys pointing to this table (if it's a table)
+            let foreignKeys = [];
+            if (objectType === "USER_TABLE") {
+                const fkResult = await pool.request()
+                    .input("objectId", sql.Int, objectId)
+                    .query(`
+            SELECT
+              OBJECT_SCHEMA_NAME(fk.parent_object_id) AS referencingSchema,
+              OBJECT_NAME(fk.parent_object_id) AS referencingTable,
+              COL_NAME(fkc.parent_object_id, fkc.parent_column_id) AS referencingColumn,
+              fk.name AS constraintName
+            FROM sys.foreign_keys fk
+            INNER JOIN sys.foreign_key_columns fkc ON fk.object_id = fkc.constraint_object_id
+            WHERE fk.referenced_object_id = @objectId
+            ORDER BY referencingTable, referencingColumn
+          `);
+                foreignKeys = fkResult.recordset;
+            }
+            // Get objects that this object references (what this depends on)
+            const referencesResult = await pool.request()
+                .input("schema", sql.NVarChar, schemaName)
+                .input("name", sql.NVarChar, objName)
+                .query(`
+          SELECT DISTINCT
+            d.referenced_schema_name AS referencedSchema,
+            d.referenced_entity_name AS referencedName,
+            COALESCE(o.type_desc, 'UNKNOWN') AS referencedType
+          FROM sys.sql_expression_dependencies d
+          LEFT JOIN sys.objects o ON d.referenced_id = o.object_id
+          WHERE OBJECT_SCHEMA_NAME(d.referencing_id) = @schema
+            AND OBJECT_NAME(d.referencing_id) = @name
+            AND d.referenced_entity_name IS NOT NULL
+          ORDER BY referencedType, referencedName
+        `);
+            // Categorize referencing objects
+            const views = [];
+            const storedProcedures = [];
+            const functions = [];
+            const triggers = [];
+            for (const row of referencedByResult.recordset) {
+                const ref = {
+                    name: row.referencingName,
+                    schema: row.referencingSchema,
+                    type: row.referencingType,
+                };
+                switch (row.referencingType) {
+                    case "VIEW":
+                        views.push(ref);
+                        break;
+                    case "SQL_STORED_PROCEDURE":
+                        storedProcedures.push(ref);
+                        break;
+                    case "SQL_SCALAR_FUNCTION":
+                    case "SQL_TABLE_VALUED_FUNCTION":
+                    case "SQL_INLINE_TABLE_VALUED_FUNCTION":
+                        functions.push(ref);
+                        break;
+                    case "SQL_TRIGGER":
+                        triggers.push(ref);
+                        break;
+                    default:
+                        // Other types go to functions as catch-all
+                        functions.push(ref);
+                }
+            }
+            // Categorize referenced objects
+            const referencedTables = [];
+            const referencedViews = [];
+            const referencedFunctions = [];
+            for (const row of referencesResult.recordset) {
+                const ref = {
+                    name: row.referencedName,
+                    schema: row.referencedSchema || "dbo",
+                    type: row.referencedType,
+                };
+                switch (row.referencedType) {
+                    case "USER_TABLE":
+                        referencedTables.push(ref);
+                        break;
+                    case "VIEW":
+                        referencedViews.push(ref);
+                        break;
+                    default:
+                        referencedFunctions.push(ref);
+                }
+            }
+            const result = {
+                success: true,
+                object: `${schemaName}.${objName}`,
+                objectType,
+                referencedBy: {
+                    views,
+                    storedProcedures,
+                    functions,
+                    triggers,
+                    foreignKeys: foreignKeys.map((fk) => ({
+                        table: fk.referencingTable,
+                        schema: fk.referencingSchema,
+                        column: fk.referencingColumn,
+                        constraint: fk.constraintName,
+                    })),
+                },
+                references: {
+                    tables: referencedTables,
+                    views: referencedViews,
+                    functions: referencedFunctions,
+                },
+            };
+            // Add summary counts
+            const totalReferencedBy = views.length +
+                storedProcedures.length +
+                functions.length +
+                triggers.length +
+                foreignKeys.length;
+            const totalReferences = referencedTables.length + referencedViews.length + referencedFunctions.length;
+            if (totalReferencedBy === 0 && totalReferences === 0) {
+                result.message = `No dependencies found for '${schemaName}.${objName}'.`;
+            }
+            else {
+                result.message = `Found ${totalReferencedBy} object(s) that reference this ${objectType.toLowerCase().replace(/_/g, " ")}, and ${totalReferences} object(s) that it references.`;
+            }
+            if (totalReferencedBy > 0) {
+                result.hint = "Modifying or dropping this object may affect the listed dependents.";
+            }
+            return result;
+        }
+        catch (error) {
+            return {
+                success: false,
+                object: objectName,
+                error: "QUERY_ERROR",
+                message: `Failed to inspect dependencies: ${error.message}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=InspectDependenciesTool.js.map

package/dist/tools/InspectDependenciesTool.js.map

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

package/dist/tools/ListDatabasesTool.d.ts

@@ -0,0 +1,27 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare class ListDatabasesTool implements Tool {
+    [key: string]: any;
+    name: string;
+    description: string;
+    inputSchema: any;
+    run(params: any): Promise<{
+        success: boolean;
+        message: string;
+        error: string;
+        environment?: undefined;
+        accessLevel?: undefined;
+        totalDatabases?: undefined;
+        accessibleDatabases?: undefined;
+        databases?: undefined;
+    } | {
+        success: boolean;
+        message: string;
+        environment: string;
+        accessLevel: "server";
+        totalDatabases: number;
+        accessibleDatabases: number;
+        databases: any[];
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=ListDatabasesTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ListDatabasesTool.d.ts","sourceRoot":"","sources":["../../src/tools/ListDatabasesTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,qBAAa,iBAAkB,YAAW,IAAI;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,SAAoB;IACxB,WAAW,SAAiH;IAC5H,WAAW,EAkBN,GAAG,CAAC;IAEH,GAAG,CAAC,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;;;CAyFtB"}

package/dist/tools/ListDatabasesTool.js

@@ -0,0 +1,107 @@
+import sql from "mssql";
+import { getEnvironmentManager } from "../config/EnvironmentManager.js";
+export class ListDatabasesTool {
+    constructor() {
+        this.name = "list_databases";
+        this.description = "Lists databases on the SQL Server instance. Requires server-level access. Filtered by environment policies.";
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                environment: {
+                    type: "string",
+                    description: "Target environment name (optional, uses default if not specified)",
+                },
+                includeSystemDbs: {
+                    type: "boolean",
+                    description: "Include system databases (master, msdb, model, tempdb). Default: false",
+                },
+                stateFilter: {
+                    type: "string",
+                    enum: ["ONLINE", "OFFLINE", "RESTORING", "RECOVERING", "SUSPECT", "ALL"],
+                    description: "Filter by database state. Default: ONLINE",
+                },
+            },
+            required: [],
+        };
+    }
+    async run(params) {
+        const { environment, includeSystemDbs = false, stateFilter = "ONLINE" } = params ?? {};
+        try {
+            const envManager = getEnvironmentManager();
+            const envConfig = envManager.getEnvironment(environment);
+            // Check if environment has server-level access
+            const accessLevel = envConfig.accessLevel ?? "database";
+            if (accessLevel !== "server") {
+                return {
+                    success: false,
+                    message: `Environment '${envConfig.name}' has database-level access only. ` +
+                        `list_databases requires server-level access (accessLevel: "server").`,
+                    error: "ACCESS_LEVEL_DENIED",
+                };
+            }
+            const request = new sql.Request();
+            // Build the query
+            let query = `
+        SELECT
+          d.name AS database_name,
+          d.database_id,
+          d.state_desc AS state,
+          d.recovery_model_desc AS recovery_model,
+          d.compatibility_level,
+          d.collation_name,
+          d.create_date,
+          d.is_read_only,
+          CAST(SUM(mf.size) * 8.0 / 1024 AS DECIMAL(10,2)) AS size_mb
+        FROM sys.databases d
+        LEFT JOIN sys.master_files mf ON d.database_id = mf.database_id
+        WHERE 1=1
+      `;
+            // Filter by state
+            if (stateFilter && stateFilter !== "ALL") {
+                query += ` AND d.state_desc = '${stateFilter}'`;
+            }
+            // Exclude system databases if not requested
+            if (!includeSystemDbs) {
+                query += ` AND d.database_id > 4`; // System DBs have IDs 1-4
+            }
+            query += `
+        GROUP BY d.name, d.database_id, d.state_desc, d.recovery_model_desc,
+                 d.compatibility_level, d.collation_name, d.create_date, d.is_read_only
+        ORDER BY d.name
+      `;
+            const result = await request.query(query);
+            // Filter results by allowedDatabases/deniedDatabases policies
+            const filteredDatabases = result.recordset.filter((db) => {
+                const check = envManager.isDatabaseAllowed(environment, db.database_name);
+                return check.allowed;
+            });
+            // Mark which databases are accessible vs restricted
+            const databases = result.recordset.map((db) => {
+                const check = envManager.isDatabaseAllowed(environment, db.database_name);
+                return {
+                    ...db,
+                    accessible: check.allowed,
+                    restriction_reason: check.reason,
+                };
+            });
+            return {
+                success: true,
+                message: `Found ${result.recordset.length} database(s), ${filteredDatabases.length} accessible`,
+                environment: envConfig.name,
+                accessLevel: accessLevel,
+                totalDatabases: result.recordset.length,
+                accessibleDatabases: filteredDatabases.length,
+                databases: databases,
+            };
+        }
+        catch (error) {
+            console.error("Error listing databases:", error);
+            return {
+                success: false,
+                message: `Failed to list databases: ${error}`,
+                error: "QUERY_FAILED",
+            };
+        }
+    }
+}
+//# sourceMappingURL=ListDatabasesTool.js.map