@eamonboyle/mssql-mcp 1.1.0 → 1.3.0

package/dist/mcpResults.js

@@ -0,0 +1,246 @@
+import { z } from "zod";
+export const toolResultOutputSchema = {
+    version: z.literal(1),
+    success: z.boolean(),
+    message: z.string(),
+    data: z.unknown().optional(),
+    meta: z.record(z.string(), z.unknown()).optional(),
+    warnings: z.array(z.string()).optional(),
+    error: z
+        .object({
+        code: z.string(),
+        details: z.unknown().optional(),
+    })
+        .optional(),
+    pagination: z
+        .object({
+        returned: z.number().int().nonnegative(),
+        total: z.number().int().nonnegative().optional(),
+        nextCursor: z.string().optional(),
+    })
+        .optional(),
+    truncated: z.boolean().optional(),
+};
+export function classifyToolErrorCode(raw, message, fallback = "TOOL_EXECUTION_FAILED") {
+    const explicit = raw.error;
+    if (typeof explicit === "object" &&
+        explicit !== null &&
+        "code" in explicit &&
+        typeof explicit.code === "string" &&
+        String(explicit.code).trim()) {
+        return String(explicit.code).trim();
+    }
+    if (typeof explicit === "string" && explicit.trim()) {
+        return explicit.trim();
+    }
+    if (/invalid or disallowed database|invalid database/i.test(message)) {
+        return "INVALID_DATABASE";
+    }
+    if (/security validation failed/i.test(message)) {
+        return "SECURITY_VALIDATION_FAILED";
+    }
+    if (/multiple objects named|disambiguate/i.test(message)) {
+        return "AMBIGUOUS_TARGET";
+    }
+    if (/preview required|confirmation canceled\. call preview_/i.test(message)) {
+        return "PREVIEW_REQUIRED";
+    }
+    if (/invalid or expired previewtoken|write preview token/i.test(message)) {
+        return "PREVIEW_TOKEN_INVALID";
+    }
+    if (/confirmation canceled|interactive confirmation is unavailable/i.test(message)) {
+        return "CONFIRMATION_REQUIRED";
+    }
+    if (/ddl .*disabled/i.test(message)) {
+        return "DDL_DISABLED";
+    }
+    if (/exceeds max_write_rows/i.test(message)) {
+        return "WRITE_LIMIT_EXCEEDED";
+    }
+    if (/timeout/i.test(message)) {
+        return "QUERY_TIMEOUT";
+    }
+    return fallback;
+}
+function createTextSummary(payload) {
+    if (!payload.success && payload.error) {
+        return `${payload.message} (${payload.error.code})`;
+    }
+    return payload.message;
+}
+const MAX_INLINE_JSON_CHARS = 120000;
+const MAX_INLINE_ARRAY_ITEMS = 500;
+function isPlainRecord(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const proto = Object.getPrototypeOf(value);
+    return proto === null || proto === Object.prototype;
+}
+function shouldInlineDataInText(data) {
+    if (data === null || data === undefined) {
+        return false;
+    }
+    if (Array.isArray(data)) {
+        return true;
+    }
+    return isPlainRecord(data);
+}
+export function buildInlineDataAttachment(data) {
+    if (!shouldInlineDataInText(data)) {
+        return "";
+    }
+    let toSerialize = data;
+    let note = "";
+    if (Array.isArray(data)) {
+        if (data.length > MAX_INLINE_ARRAY_ITEMS) {
+            toSerialize = data.slice(0, MAX_INLINE_ARRAY_ITEMS);
+            note = `\n… showing ${MAX_INLINE_ARRAY_ITEMS} of ${data.length} items (remainder omitted from this text preview).`;
+        }
+    }
+    let json;
+    try {
+        json = JSON.stringify(toSerialize, null, 2);
+    }
+    catch {
+        return "\n\n(unable to serialize data for inline preview).";
+    }
+    if (json.length > MAX_INLINE_JSON_CHARS) {
+        return `\n\n(inline preview omitted: serialized size ${json.length} chars).`;
+    }
+    return `\n\n${json}${note}`;
+}
+export function createResourceLink(uri, name, title, description, mimeType = "application/json") {
+    return {
+        type: "resource_link",
+        uri,
+        name,
+        title,
+        description,
+        mimeType,
+    };
+}
+/**
+ * JSON-serializable copy of the tool payload for MCP `structuredContent`.
+ * Required when tools declare `outputSchema` — the SDK rejects missing structured output on success.
+ */
+export function toToolStructuredContent(payload) {
+    try {
+        const json = JSON.stringify(payload, (_key, value) => {
+            if (typeof value === "bigint") {
+                return value.toString();
+            }
+            if (typeof Buffer !== "undefined" && Buffer.isBuffer(value)) {
+                return value.toString("base64");
+            }
+            return value;
+        });
+        return JSON.parse(json);
+    }
+    catch {
+        const fallback = {
+            version: payload.version,
+            success: payload.success,
+            message: payload.message,
+        };
+        if (payload.error !== undefined) {
+            fallback.error = payload.error;
+        }
+        return fallback;
+    }
+}
+export function createToolResult(payload, extraContent = []) {
+    const summary = createTextSummary(payload);
+    const dataAttachment = payload.success && payload.data !== undefined
+        ? buildInlineDataAttachment(payload.data)
+        : "";
+    return {
+        content: [
+            {
+                type: "text",
+                text: summary + dataAttachment,
+            },
+            ...extraContent,
+        ],
+        isError: !payload.success,
+        structuredContent: toToolStructuredContent(payload),
+    };
+}
+export function normalizeToolResult(rawResult, fallbackMessage) {
+    if (typeof rawResult !== "object" || rawResult === null) {
+        return {
+            version: 1,
+            success: true,
+            message: fallbackMessage,
+            data: rawResult,
+        };
+    }
+    const raw = rawResult;
+    const success = raw.success !== false;
+    const message = typeof raw.message === "string" && raw.message.trim()
+        ? raw.message
+        : fallbackMessage;
+    const knownKeys = new Set([
+        "success",
+        "message",
+        "error",
+        "data",
+        "meta",
+        "warnings",
+        "pagination",
+        "truncated",
+    ]);
+    const passthrough = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (!knownKeys.has(key)) {
+            passthrough[key] = value;
+        }
+    }
+    let meta = raw.meta && typeof raw.meta === "object" && !Array.isArray(raw.meta)
+        ? { ...raw.meta }
+        : undefined;
+    if (Object.keys(passthrough).length > 0) {
+        if ("data" in raw) {
+            meta ?? (meta = {});
+            meta.raw = passthrough;
+        }
+    }
+    const payload = {
+        version: 1,
+        success,
+        message,
+    };
+    if ("data" in raw) {
+        payload.data = raw.data;
+    }
+    else if (Object.keys(passthrough).length > 0) {
+        if (Object.keys(passthrough).length === 1) {
+            payload.data = Object.values(passthrough)[0];
+        }
+        else {
+            payload.data = passthrough;
+        }
+    }
+    if (meta && Object.keys(meta).length > 0) {
+        payload.meta = meta;
+    }
+    if (Array.isArray(raw.warnings)) {
+        payload.warnings = raw.warnings.filter((warning) => typeof warning === "string");
+    }
+    if (typeof raw.truncated === "boolean") {
+        payload.truncated = raw.truncated;
+    }
+    if (raw.pagination &&
+        typeof raw.pagination === "object" &&
+        !Array.isArray(raw.pagination)) {
+        payload.pagination = raw.pagination;
+    }
+    if (!success) {
+        payload.error = {
+            code: classifyToolErrorCode(raw, message),
+            details: raw.error && typeof raw.error !== "string" ? raw.error : undefined,
+        };
+    }
+    return payload;
+}
+//# sourceMappingURL=mcpResults.js.map

package/dist/mcpResults.js.map

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

package/dist/promptRegistry.d.ts

@@ -0,0 +1,16 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+export declare const promptDefinitions: PromptDefinition[];
+export interface RegisterPromptsOptions {
+    isReadOnly: boolean;
+}
+export declare function registerPrompts(server: McpServer, options: RegisterPromptsOptions): void;
+//# sourceMappingURL=promptRegistry.d.ts.map

package/dist/promptRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptRegistry.d.ts","sourceRoot":"","sources":["../src/promptRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAiD/C,CAAC;AAoBF,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,OAAO,CAAC;CACrB;AAkDD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CA4BN"}

package/dist/promptRegistry.js

@@ -0,0 +1,112 @@
+import { completable } from "@modelcontextprotocol/sdk/server/completable.js";
+import { z } from "zod";
+import { getAllowedDatabases } from "./db.js";
+export const promptDefinitions = [
+    {
+        name: "explore_schema",
+        description: "Guide the assistant to inspect SQL Server schema before answering a database question.",
+        arguments: [
+            {
+                name: "goal",
+                description: "What you want to understand or build from the schema.",
+                required: true,
+            },
+            {
+                name: "databaseName",
+                description: "Configured database to inspect first.",
+            },
+        ],
+    },
+    {
+        name: "draft_safe_select",
+        description: "Draft a safe read-only SQL workflow using schema inspection before running a SELECT.",
+        arguments: [
+            {
+                name: "question",
+                description: "Business question to answer with SQL.",
+                required: true,
+            },
+            {
+                name: "databaseName",
+                description: "Configured database to inspect first.",
+            },
+        ],
+    },
+    {
+        name: "review_write_operation",
+        description: "Review a proposed INSERT, UPDATE, DELETE, or DDL change before execution. When the server is read-only, directs the assistant to stop and avoid terminal or external SQL clients.",
+        arguments: [
+            {
+                name: "operation",
+                description: "The change you want to make.",
+                required: true,
+            },
+            {
+                name: "databaseName",
+                description: "Configured database the change targets.",
+            },
+        ],
+    },
+];
+function buildPromptMessage(text) {
+    return {
+        role: "user",
+        content: {
+            type: "text",
+            text,
+        },
+    };
+}
+const databaseNameArgumentSchema = completable(z.string().describe("Configured database to inspect first."), async (value) => getAllowedDatabases().filter((database) => database.toLowerCase().startsWith(String(value ?? "").toLowerCase())));
+function createPromptMessageBuilders(isReadOnly) {
+    return {
+        explore_schema: (args) => ({
+            description: "Inspect the schema before answering or generating SQL.",
+            messages: [
+                buildPromptMessage(`Inspect the SQL Server schema before answering the request.\nGoal: ${args.goal ?? "Understand the database shape"}\nDatabase: ${args.databaseName ?? "default configured database"}\nUse list_objects or list_table first, then describe_object or describe_table before writing SQL.`),
+            ],
+        }),
+        draft_safe_select: (args) => ({
+            description: "Draft a read-only SQL workflow that inspects schema before querying data.",
+            messages: [
+                buildPromptMessage(`Answer this database question safely: ${args.question ?? "No question provided"}\nDatabase: ${args.databaseName ?? "default configured database"}\nInspect relevant schema first, then use read_data or search_data. Keep the final SQL read-only and explain assumptions.`),
+            ],
+        }),
+        review_write_operation: (args) => {
+            const operation = args.operation ?? "No operation provided";
+            const database = args.databaseName ?? "default configured database";
+            const body = isReadOnly
+                ? `Review this proposed change: ${operation}\nDatabase: ${database}
+
+This MCP SQL Server connection is read-only (confirm with resource mssql://config/server — readOnly should be true). Write tools such as delete_data, update_data, insert_data, and DDL tools are not available.
+
+STOP: Do not execute this change through the assistant. Do not open a terminal or use sqlcmd, SSMS, Azure Data Studio, PowerShell SQL cmdlets, ODBC/JDBC one-off scripts, or any other database client to apply INSERT, UPDATE, DELETE, or DDL as a workaround. Tell the user their MCP server is read-only and they must turn off READONLY (or run the change themselves manually outside this assistant) if they want execution here.
+
+You may still: outline risks, confirm keys and scope, and suggest read-only preview SELECTs for discussion only.`
+                : `Review this proposed change before execution: ${operation}\nDatabase: ${database}\nConfirm the target objects, verify WHERE clauses where applicable, and suggest preview queries before any write tool is used.`;
+            return {
+                description: "Review a proposed change and identify safety checks before running it.",
+                messages: [buildPromptMessage(body)],
+            };
+        },
+    };
+}
+export function registerPrompts(server, options) {
+    const promptMessageBuilders = createPromptMessageBuilders(options.isReadOnly);
+    for (const prompt of promptDefinitions) {
+        const argsShape = Object.fromEntries((prompt.arguments ?? []).map((argument) => [
+            argument.name,
+            argument.required
+                ? z.string().describe(argument.description)
+                : argument.name === "databaseName"
+                    ? databaseNameArgumentSchema.optional()
+                    : z.string().describe(argument.description).optional(),
+        ]));
+        server.registerPrompt(prompt.name, {
+            title: prompt.name,
+            description: prompt.description,
+            argsSchema: argsShape,
+        }, (args) => promptMessageBuilders[prompt.name](args));
+    }
+}
+//# sourceMappingURL=promptRegistry.js.map

package/dist/promptRegistry.js.map

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

package/dist/resourceRegistry.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ServerState } from "./serverState.js";
+export interface ResourceRegistryContext {
+    serverName: string;
+    serverVersion: string;
+    isReadOnly: boolean;
+    allowedDatabases: string[];
+    toolNames: string[];
+    maxRows: number;
+    queryTimeoutMs: number;
+    state: ServerState;
+}
+export declare function registerResources(server: McpServer, context: ResourceRegistryContext): void;
+//# sourceMappingURL=resourceRegistry.d.ts.map

package/dist/resourceRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceRegistry.d.ts","sourceRoot":"","sources":["../src/resourceRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAWtF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAc/C,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;CACpB;AA2ND,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAqPN"}