@connorbritain/mssql-mcp-core 0.1.0

package/dist/tools/RunScriptTool.d.ts

@@ -0,0 +1,214 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare class RunScriptTool implements Tool {
+    [key: string]: any;
+    name: string;
+    description: string;
+    inputSchema: any;
+    run(params: {
+        scriptName: string;
+        parameters?: Record<string, any>;
+        preview?: boolean;
+        confirm?: boolean;
+        environment?: string;
+        environmentPolicy?: any;
+    }): Promise<{
+        success: boolean;
+        error: string;
+        message: string;
+        availableScripts: string[];
+        script?: undefined;
+        environment?: undefined;
+        requiredTier?: undefined;
+        environmentTier?: undefined;
+        hint?: undefined;
+        errors?: undefined;
+        expectedParameters?: undefined;
+        providedParameters?: undefined;
+        preview?: undefined;
+        description?: undefined;
+        resolvedSql?: undefined;
+        parameters?: undefined;
+        requiresApproval?: undefined;
+        rowsAffected?: undefined;
+        recordCount?: undefined;
+        data?: undefined;
+        sqlError?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        message: string | undefined;
+        script: string;
+        environment: string;
+        availableScripts?: undefined;
+        requiredTier?: undefined;
+        environmentTier?: undefined;
+        hint?: undefined;
+        errors?: undefined;
+        expectedParameters?: undefined;
+        providedParameters?: undefined;
+        preview?: undefined;
+        description?: undefined;
+        resolvedSql?: undefined;
+        parameters?: undefined;
+        requiresApproval?: undefined;
+        rowsAffected?: undefined;
+        recordCount?: undefined;
+        data?: undefined;
+        sqlError?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        message: string;
+        script: string;
+        requiredTier: import("../config/EnvironmentManager.js").TierLevel;
+        environmentTier: import("../config/EnvironmentManager.js").TierLevel | undefined;
+        availableScripts?: undefined;
+        environment?: undefined;
+        hint?: undefined;
+        errors?: undefined;
+        expectedParameters?: undefined;
+        providedParameters?: undefined;
+        preview?: undefined;
+        description?: undefined;
+        resolvedSql?: undefined;
+        parameters?: undefined;
+        requiresApproval?: undefined;
+        rowsAffected?: undefined;
+        recordCount?: undefined;
+        data?: undefined;
+        sqlError?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        message: string;
+        hint: string;
+        availableScripts?: undefined;
+        script?: undefined;
+        environment?: undefined;
+        requiredTier?: undefined;
+        environmentTier?: undefined;
+        errors?: undefined;
+        expectedParameters?: undefined;
+        providedParameters?: undefined;
+        preview?: undefined;
+        description?: undefined;
+        resolvedSql?: undefined;
+        parameters?: undefined;
+        requiresApproval?: undefined;
+        rowsAffected?: undefined;
+        recordCount?: undefined;
+        data?: undefined;
+        sqlError?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        message: string;
+        errors: string[];
+        script: string;
+        expectedParameters: import("../config/ScriptManager.js").ScriptParameter[] | undefined;
+        providedParameters: Record<string, any>;
+        availableScripts?: undefined;
+        environment?: undefined;
+        requiredTier?: undefined;
+        environmentTier?: undefined;
+        hint?: undefined;
+        preview?: undefined;
+        description?: undefined;
+        resolvedSql?: undefined;
+        parameters?: undefined;
+        requiresApproval?: undefined;
+        rowsAffected?: undefined;
+        recordCount?: undefined;
+        data?: undefined;
+        sqlError?: undefined;
+    } | {
+        success: boolean;
+        preview: boolean;
+        script: string;
+        description: string;
+        environment: string;
+        resolvedSql: string;
+        parameters: Record<string, any>;
+        requiresApproval: boolean | undefined;
+        hint: string;
+        error?: undefined;
+        message?: undefined;
+        availableScripts?: undefined;
+        requiredTier?: undefined;
+        environmentTier?: undefined;
+        errors?: undefined;
+        expectedParameters?: undefined;
+        providedParameters?: undefined;
+        rowsAffected?: undefined;
+        recordCount?: undefined;
+        data?: undefined;
+        sqlError?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        requiresApproval: boolean;
+        script: string;
+        environment: string;
+        resolvedSql: string;
+        message: string;
+        availableScripts?: undefined;
+        requiredTier?: undefined;
+        environmentTier?: undefined;
+        hint?: undefined;
+        errors?: undefined;
+        expectedParameters?: undefined;
+        providedParameters?: undefined;
+        preview?: undefined;
+        description?: undefined;
+        parameters?: undefined;
+        rowsAffected?: undefined;
+        recordCount?: undefined;
+        data?: undefined;
+        sqlError?: undefined;
+    } | {
+        success: boolean;
+        script: string;
+        environment: string;
+        rowsAffected: any;
+        recordCount: any;
+        data: any;
+        message: string;
+        error?: undefined;
+        availableScripts?: undefined;
+        requiredTier?: undefined;
+        environmentTier?: undefined;
+        hint?: undefined;
+        errors?: undefined;
+        expectedParameters?: undefined;
+        providedParameters?: undefined;
+        preview?: undefined;
+        description?: undefined;
+        resolvedSql?: undefined;
+        parameters?: undefined;
+        requiresApproval?: undefined;
+        sqlError?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        script: string;
+        environment: string;
+        message: string;
+        sqlError: any;
+        availableScripts?: undefined;
+        requiredTier?: undefined;
+        environmentTier?: undefined;
+        hint?: undefined;
+        errors?: undefined;
+        expectedParameters?: undefined;
+        providedParameters?: undefined;
+        preview?: undefined;
+        description?: undefined;
+        resolvedSql?: undefined;
+        parameters?: undefined;
+        requiresApproval?: undefined;
+        rowsAffected?: undefined;
+        recordCount?: undefined;
+        data?: undefined;
+    }>;
+}
+//# sourceMappingURL=RunScriptTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RunScriptTool.d.ts","sourceRoot":"","sources":["../../src/tools/RunScriptTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,qBAAa,aAAc,YAAW,IAAI;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,SAAgB;IACpB,WAAW,SAAqI;IAEhJ,WAAW,EA0BN,GAAG,CAAC;IAEH,GAAG,CAAC,MAAM,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,GAAG,CAAC;KACzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkKF"}

package/dist/tools/RunScriptTool.js

@@ -0,0 +1,186 @@
+import sql from "mssql";
+import { getScriptManager } from "../config/ScriptManager.js";
+import { getEnvironmentManager } from "../config/EnvironmentManager.js";
+export class RunScriptTool {
+    constructor() {
+        this.name = "run_script";
+        this.description = "Executes a named SQL script with parameters. Scripts are pre-approved SQL templates. Use list_scripts to see available scripts.";
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                scriptName: {
+                    type: "string",
+                    description: "Name of the script to execute (from list_scripts)",
+                },
+                parameters: {
+                    type: "object",
+                    description: "Parameter values for the script (key-value pairs)",
+                    additionalProperties: true,
+                },
+                preview: {
+                    type: "boolean",
+                    description: "If true, shows the resolved SQL without executing. Default: false",
+                },
+                confirm: {
+                    type: "boolean",
+                    description: "Required for scripts with requiresApproval or in environments with requireApproval. Set to true after reviewing preview.",
+                },
+                environment: {
+                    type: "string",
+                    description: "Target environment (optional, uses default if not specified)",
+                },
+            },
+            required: ["scriptName"],
+        };
+    }
+    async run(params) {
+        const { scriptName, parameters = {}, preview = false, confirm = false, environment } = params;
+        const scriptManager = getScriptManager();
+        const envManager = getEnvironmentManager();
+        // Get the script
+        const script = scriptManager.getScript(scriptName);
+        if (!script) {
+            const available = scriptManager.listScripts().map((s) => s.name);
+            return {
+                success: false,
+                error: "SCRIPT_NOT_FOUND",
+                message: `Script '${scriptName}' not found.`,
+                availableScripts: available,
+            };
+        }
+        // Get environment config
+        const envConfig = envManager.getEnvironment(environment);
+        const envName = envConfig.name;
+        // Check if script can run in this environment
+        const envCheck = scriptManager.canRunInEnvironment(scriptName, envName);
+        if (!envCheck.allowed) {
+            return {
+                success: false,
+                error: "SCRIPT_NOT_ALLOWED",
+                message: envCheck.reason,
+                script: scriptName,
+                environment: envName,
+            };
+        }
+        // Check tier compatibility
+        if (script.tier) {
+            const tierOrder = ["reader", "writer", "admin"];
+            const scriptTierIndex = tierOrder.indexOf(script.tier);
+            const envTierIndex = envConfig.tier ? tierOrder.indexOf(envConfig.tier) : 2; // default to admin
+            if (envTierIndex < scriptTierIndex) {
+                return {
+                    success: false,
+                    error: "INSUFFICIENT_TIER",
+                    message: `Script '${scriptName}' requires tier '${script.tier}' but environment '${envName}' is tier '${envConfig.tier}'.`,
+                    script: scriptName,
+                    requiredTier: script.tier,
+                    environmentTier: envConfig.tier,
+                };
+            }
+        }
+        // Check readonly constraints
+        if (envConfig.readonly && !script.readonly) {
+            return {
+                success: false,
+                error: "ENVIRONMENT_READONLY",
+                message: `Environment '${envName}' is read-only. Script '${scriptName}' is not marked as readonly.`,
+                hint: "Mark the script as readonly: true in scripts.json if it only performs SELECT operations.",
+            };
+        }
+        // Resolve parameters
+        const { sql: resolvedSql, errors } = scriptManager.resolveParameters(script, parameters);
+        if (errors.length > 0) {
+            return {
+                success: false,
+                error: "PARAMETER_ERROR",
+                message: "Failed to resolve script parameters.",
+                errors,
+                script: scriptName,
+                expectedParameters: script.parameters,
+                providedParameters: parameters,
+            };
+        }
+        // Preview mode - just return the resolved SQL
+        if (preview) {
+            return {
+                success: true,
+                preview: true,
+                script: scriptName,
+                description: script.description,
+                environment: envName,
+                resolvedSql,
+                parameters: parameters,
+                requiresApproval: script.requiresApproval || envConfig.requireApproval,
+                hint: script.requiresApproval || envConfig.requireApproval
+                    ? "This script requires confirmation. Run again with confirm: true to execute."
+                    : "Run again with preview: false to execute.",
+            };
+        }
+        // Check approval requirements
+        const needsApproval = script.requiresApproval || envConfig.requireApproval;
+        if (needsApproval && !confirm) {
+            return {
+                success: false,
+                error: "APPROVAL_REQUIRED",
+                requiresApproval: true,
+                script: scriptName,
+                environment: envName,
+                resolvedSql,
+                message: `Script '${scriptName}' requires explicit approval. Review the SQL and run again with confirm: true.`,
+            };
+        }
+        // Execute the script
+        try {
+            const pool = params.pool;
+            if (!pool) {
+                return {
+                    success: false,
+                    error: "NO_CONNECTION",
+                    message: "No database connection available.",
+                    script: scriptName,
+                    environment: envName,
+                };
+            }
+            const request = pool.request();
+            // For actual execution, we use parameterized queries for safety
+            // Add parameters to the request
+            for (const param of script.parameters || []) {
+                const value = parameters[param.name] ?? param.default;
+                if (value !== undefined) {
+                    // Map our types to SQL types
+                    switch (param.type) {
+                        case "number":
+                            request.input(param.name, sql.Float, value);
+                            break;
+                        case "boolean":
+                            request.input(param.name, sql.Bit, value);
+                            break;
+                        default:
+                            request.input(param.name, sql.NVarChar(sql.MAX), value);
+                    }
+                }
+            }
+            const result = await request.query(script.sql);
+            return {
+                success: true,
+                script: scriptName,
+                environment: envName,
+                rowsAffected: result.rowsAffected.reduce((a, b) => a + b, 0),
+                recordCount: result.recordset?.length,
+                data: result.recordset,
+                message: `Script '${scriptName}' executed successfully.`,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: "EXECUTION_ERROR",
+                script: scriptName,
+                environment: envName,
+                message: `Script execution failed: ${error.message}`,
+                sqlError: error.message,
+            };
+        }
+    }
+}
+//# sourceMappingURL=RunScriptTool.js.map

package/dist/tools/RunScriptTool.js.map

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

package/dist/tools/SearchSchemaTool.d.ts

@@ -0,0 +1,88 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+type SearchParams = {
+    tablePattern?: string;
+    columnPattern?: string;
+    limit?: number;
+    tableLimit?: number;
+    columnLimit?: number;
+    tableOffset?: number;
+    columnOffset?: number;
+};
+type PaginationInfo = {
+    offset: number;
+    limit: number;
+    total: number;
+    hasMore: boolean;
+};
+type SearchResult = {
+    success: boolean;
+    message?: string;
+    totalTables?: number;
+    totalColumns?: number;
+    tables?: Array<{
+        schemaName: string;
+        tableName: string;
+    }>;
+    columns?: Array<{
+        schemaName: string;
+        tableName: string;
+        columnName: string;
+        dataType: string;
+    }>;
+    fuzzySuggestions?: Array<{
+        schemaName: string;
+        tableName: string;
+        similarity: number;
+    }>;
+    fuzzySearchTerm?: string;
+    tablesPage?: PaginationInfo;
+    columnsPage?: PaginationInfo;
+};
+export declare class SearchSchemaTool implements Tool {
+    [key: string]: any;
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly tablePattern: {
+                readonly type: "string";
+                readonly description: "Wildcard pattern for table names (e.g. 'doc%').";
+            };
+            readonly columnPattern: {
+                readonly type: "string";
+                readonly description: "Wildcard pattern for column names (e.g. '%id').";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Maximum rows to return per section (default 50, max 200).";
+            };
+            readonly tableLimit: {
+                readonly type: "number";
+                readonly description: "Override for table section limit (defaults to limit).";
+            };
+            readonly columnLimit: {
+                readonly type: "number";
+                readonly description: "Override for column section limit (defaults to limit).";
+            };
+            readonly tableOffset: {
+                readonly type: "number";
+                readonly description: "Number of table rows to skip (for pagination).";
+            };
+            readonly columnOffset: {
+                readonly type: "number";
+                readonly description: "Number of column rows to skip (for pagination).";
+            };
+        };
+    };
+    private normalizePattern;
+    private stripWildcards;
+    private normalizeLimit;
+    private normalizeOffset;
+    private levenshteinDistance;
+    private calculateSimilarity;
+    private findSimilarTables;
+    run(params: SearchParams): Promise<SearchResult>;
+}
+export {};
+//# sourceMappingURL=SearchSchemaTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SearchSchemaTool.d.ts","sourceRoot":"","sources":["../../src/tools/SearchSchemaTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAe1D,KAAK,YAAY,GAAG;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjG,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B,CAAC;AAEF,qBAAa,gBAAiB,YAAW,IAAI;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,SAAmB;IACvB,WAAW,SAAmF;IAC9F,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgCA;IAEX,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,mBAAmB;YAWb,iBAAiB;IAwBzB,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CA0HvD"}