@eamonboyle/mssql-mcp 1.1.0 → 1.3.0

package/dist/resourceRegistry.js

@@ -0,0 +1,311 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { describeObjectDependencies, describeDatabaseObject, describeTableSchema, getDatabaseSchemaSummary, listForeignKeys, listDatabaseObjects, listDatabaseTables, } from "./schema.js";
+import { promptDefinitions } from "./promptRegistry.js";
+const resourceTemplates = [
+    {
+        name: "table_schema",
+        uriTemplate: "mssql://table/{databaseName}/{schemaName}/{tableName}",
+        description: "Detailed schema for a single table resource.",
+        mimeType: "application/json",
+    },
+    {
+        name: "object_definition",
+        uriTemplate: "mssql://object/{databaseName}/{schemaName}/{objectName}",
+        description: "Definition and metadata for a single table, view, procedure, function, or trigger.",
+        mimeType: "application/json",
+    },
+    {
+        name: "object_dependencies",
+        uriTemplate: "mssql://database/{databaseName}/object/{schemaName}/{objectName}/dependencies",
+        description: "Dependencies for a single object.",
+        mimeType: "application/json",
+    },
+];
+const RESOURCE_LIST_TTL_MS = 30000;
+function buildResourceText(payload) {
+    return JSON.stringify(payload, null, 2);
+}
+function parseResourceUri(uri) {
+    const parsed = new URL(uri);
+    const segments = parsed.pathname
+        .split("/")
+        .filter(Boolean)
+        .map((segment) => decodeURIComponent(segment));
+    return {
+        resourceType: parsed.hostname,
+        segments,
+    };
+}
+function createListingCache(ttlMs) {
+    const cache = new Map();
+    return async function getCachedValue(key, loader) {
+        const now = Date.now();
+        const cached = cache.get(key);
+        if (cached && cached.expiresAt > now) {
+            return cached.value;
+        }
+        const value = await loader();
+        cache.set(key, {
+            value,
+            expiresAt: now + ttlMs,
+        });
+        return value;
+    };
+}
+async function readResourcePayload(uri, context, getCachedValue) {
+    const parsed = parseResourceUri(uri);
+    if (parsed.resourceType === "config") {
+        if (parsed.segments[0] === "server") {
+            return {
+                server: {
+                    name: context.serverName,
+                    version: context.serverVersion,
+                    readOnly: context.isReadOnly,
+                    allowedDatabases: context.allowedDatabases,
+                    maxRows: context.maxRows,
+                    queryTimeoutMs: context.queryTimeoutMs,
+                },
+                tools: context.toolNames,
+            };
+        }
+        if (parsed.segments[0] === "prompts") {
+            return {
+                prompts: promptDefinitions,
+            };
+        }
+    }
+    if (parsed.resourceType === "database") {
+        const [databaseName, resourceName] = parsed.segments;
+        if (resourceName === "tables") {
+            return {
+                databaseName,
+                tables: await getCachedValue(`tables:${databaseName}`, () => listDatabaseTables(databaseName)),
+            };
+        }
+        if (resourceName === "objects") {
+            return {
+                databaseName,
+                objects: await getCachedValue(`objects:${databaseName}`, () => listDatabaseObjects(databaseName)),
+            };
+        }
+        if (resourceName === "schema-summary") {
+            return {
+                databaseName,
+                summary: await getCachedValue(`schema-summary:${databaseName}`, () => getDatabaseSchemaSummary(databaseName)),
+            };
+        }
+        if (resourceName === "foreign-keys") {
+            return {
+                databaseName,
+                foreignKeys: await getCachedValue(`foreign-keys:${databaseName}`, () => listForeignKeys(databaseName)),
+            };
+        }
+    }
+    if (parsed.resourceType === "table") {
+        const [databaseName, schemaName, tableName] = parsed.segments;
+        return {
+            databaseName,
+            schemaName,
+            tableName,
+            columns: await describeTableSchema(tableName, databaseName, schemaName),
+        };
+    }
+    if (parsed.resourceType === "object") {
+        const [databaseName, schemaName, objectName] = parsed.segments;
+        const object = await describeDatabaseObject(objectName, databaseName, schemaName);
+        if (!object) {
+            throw new Error(`No object named '${objectName}' was found.`);
+        }
+        return object;
+    }
+    if (parsed.resourceType === "query-plan") {
+        const [planId] = parsed.segments;
+        const plan = context.state.getQueryPlan(planId);
+        if (!plan) {
+            throw new Error(`Unknown query plan resource '${planId}'.`);
+        }
+        return plan;
+    }
+    if (parsed.resourceType === "query-result") {
+        const [resultId] = parsed.segments;
+        const result = context.state.getQueryResult(resultId);
+        if (!result) {
+            throw new Error(`Unknown query result resource '${resultId}'.`);
+        }
+        return result;
+    }
+    if (parsed.resourceType === "database" &&
+        parsed.segments[1] === "object" &&
+        parsed.segments[4] === "dependencies") {
+        const [databaseName, _objectKeyword, schemaName, objectName] = parsed.segments;
+        return {
+            databaseName,
+            schemaName,
+            objectName,
+            dependencies: await describeObjectDependencies(objectName, databaseName, schemaName),
+        };
+    }
+    throw new Error(`Unknown resource URI: ${uri}`);
+}
+function buildReadHandler(context, getCachedValue) {
+    return async (uri) => {
+        const payload = await readResourcePayload(uri.href, context, getCachedValue);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: buildResourceText(payload),
+                },
+            ],
+        };
+    };
+}
+export function registerResources(server, context) {
+    const getCachedValue = createListingCache(RESOURCE_LIST_TTL_MS);
+    const readHandler = buildReadHandler(context, getCachedValue);
+    server.registerResource("server_config", "mssql://config/server", {
+        title: "Server Config",
+        description: "Server configuration, limits, and enabled tools.",
+        mimeType: "application/json",
+    }, readHandler);
+    server.registerResource("prompt_catalog", "mssql://config/prompts", {
+        title: "Prompt Catalog",
+        description: "Available prompt templates exposed by this server.",
+        mimeType: "application/json",
+    }, readHandler);
+    for (const databaseName of context.allowedDatabases) {
+        server.registerResource(`${databaseName}_tables`, `mssql://database/${encodeURIComponent(databaseName)}/tables`, {
+            title: `${databaseName} Tables`,
+            description: `Base tables available in database ${databaseName}.`,
+            mimeType: "application/json",
+        }, readHandler);
+        server.registerResource(`${databaseName}_objects`, `mssql://database/${encodeURIComponent(databaseName)}/objects`, {
+            title: `${databaseName} Objects`,
+            description: `Tables, views, procedures, functions, and triggers available in database ${databaseName}.`,
+            mimeType: "application/json",
+        }, readHandler);
+        server.registerResource(`${databaseName}_schema_summary`, `mssql://database/${encodeURIComponent(databaseName)}/schema-summary`, {
+            title: `${databaseName} Schema Summary`,
+            description: `Schema-level summary for database ${databaseName}.`,
+            mimeType: "application/json",
+        }, readHandler);
+        server.registerResource(`${databaseName}_foreign_keys`, `mssql://database/${encodeURIComponent(databaseName)}/foreign-keys`, {
+            title: `${databaseName} Foreign Keys`,
+            description: `Foreign key relationships for database ${databaseName}.`,
+            mimeType: "application/json",
+        }, readHandler);
+    }
+    server.registerResource("table_schema", new ResourceTemplate(resourceTemplates[0].uriTemplate, {
+        list: async () => ({
+            resources: (await Promise.all(context.allowedDatabases.map(async (databaseName) => {
+                const tables = await getCachedValue(`tables:${databaseName}`, () => listDatabaseTables(databaseName));
+                return tables.map((table) => ({
+                    uri: `mssql://table/${encodeURIComponent(databaseName)}/${encodeURIComponent(table.schemaName)}/${encodeURIComponent(table.tableName)}`,
+                    name: `${databaseName}.${table.schemaName}.${table.tableName}`,
+                }));
+            }))).flat(),
+        }),
+        complete: {
+            databaseName: (value) => context.allowedDatabases.filter((databaseName) => databaseName
+                .toLowerCase()
+                .startsWith(String(value ?? "").toLowerCase())),
+            schemaName: async (_value, variables) => {
+                const databaseName = variables?.arguments?.databaseName;
+                if (!databaseName) {
+                    return [];
+                }
+                const tables = await getCachedValue(`tables:${databaseName}`, () => listDatabaseTables(databaseName));
+                return [...new Set(tables.map((table) => table.schemaName))];
+            },
+            tableName: async (value, variables) => {
+                const databaseName = variables?.arguments?.databaseName;
+                const schemaName = variables?.arguments?.schemaName;
+                if (!databaseName) {
+                    return [];
+                }
+                const tables = await getCachedValue(`tables:${databaseName}`, () => listDatabaseTables(databaseName, schemaName));
+                return tables
+                    .map((table) => table.tableName)
+                    .filter((tableName) => tableName
+                    .toLowerCase()
+                    .startsWith(String(value ?? "").toLowerCase()));
+            },
+        },
+    }), {
+        title: "Table Schema",
+        description: resourceTemplates[0].description,
+        mimeType: resourceTemplates[0].mimeType,
+    }, readHandler);
+    server.registerResource("object_definition", new ResourceTemplate(resourceTemplates[1].uriTemplate, {
+        list: async () => ({
+            resources: (await Promise.all(context.allowedDatabases.map(async (databaseName) => {
+                const objects = await getCachedValue(`objects:${databaseName}`, () => listDatabaseObjects(databaseName));
+                return objects.map((object) => ({
+                    uri: `mssql://object/${encodeURIComponent(databaseName)}/${encodeURIComponent(object.schemaName)}/${encodeURIComponent(object.name)}`,
+                    name: `${databaseName}.${object.schemaName}.${object.name}`,
+                }));
+            }))).flat(),
+        }),
+        complete: {
+            databaseName: (value) => context.allowedDatabases.filter((databaseName) => databaseName
+                .toLowerCase()
+                .startsWith(String(value ?? "").toLowerCase())),
+            schemaName: async (_value, variables) => {
+                const databaseName = variables?.arguments?.databaseName;
+                if (!databaseName) {
+                    return [];
+                }
+                const objects = await getCachedValue(`objects:${databaseName}`, () => listDatabaseObjects(databaseName));
+                return [...new Set(objects.map((object) => object.schemaName))];
+            },
+            objectName: async (value, variables) => {
+                const databaseName = variables?.arguments?.databaseName;
+                const schemaName = variables?.arguments?.schemaName;
+                if (!databaseName) {
+                    return [];
+                }
+                const objects = await getCachedValue(`objects:${databaseName}`, () => listDatabaseObjects(databaseName, undefined, schemaName));
+                return objects
+                    .map((object) => object.name)
+                    .filter((name) => name.toLowerCase().startsWith(String(value ?? "").toLowerCase()));
+            },
+        },
+    }), {
+        title: "Object Definition",
+        description: resourceTemplates[1].description,
+        mimeType: resourceTemplates[1].mimeType,
+    }, readHandler);
+    server.registerResource("object_dependencies", new ResourceTemplate(resourceTemplates[2].uriTemplate, {
+        list: undefined,
+    }), {
+        title: "Object Dependencies",
+        description: resourceTemplates[2].description,
+        mimeType: resourceTemplates[2].mimeType,
+    }, readHandler);
+    server.registerResource("query_plan_resource", new ResourceTemplate("mssql://query-plan/{planId}", {
+        list: async () => ({
+            resources: context.state.listQueryPlans().map((plan) => ({
+                uri: `mssql://query-plan/${plan.id}`,
+                name: plan.id,
+            })),
+        }),
+    }), {
+        title: "Query Plans",
+        description: "Stored query plan results generated by explain_query.",
+        mimeType: "application/json",
+    }, readHandler);
+    server.registerResource("query_result_resource", new ResourceTemplate("mssql://query-result/{resultId}", {
+        list: async () => ({
+            resources: context.state.listQueryResults().map((result) => ({
+                uri: `mssql://query-result/${result.id}`,
+                name: result.label,
+            })),
+        }),
+    }), {
+        title: "Query Results",
+        description: "Stored large query results generated by read/search tools.",
+        mimeType: "application/json",
+    }, readHandler);
+}
+//# sourceMappingURL=resourceRegistry.js.map

package/dist/resourceRegistry.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,57 @@
+import sql from "mssql";
+export interface DatabaseObjectSummary {
+    name: string;
+    schemaName: string;
+    objectType: string;
+    typeCode: string;
+    typeDescription: string;
+    createdAt: Date;
+    modifiedAt: Date;
+}
+export interface DatabaseObjectDescription {
+    name: string;
+    schemaName: string;
+    objectType: string;
+    typeCode: string;
+    typeDescription: string;
+    createdAt: Date;
+    modifiedAt: Date;
+    definition?: string | null;
+    columns: Array<{
+        name: string;
+        dataType: string;
+        maxLength: number;
+        precision: number;
+        scale: number;
+        isNullable: boolean;
+        isIdentity: boolean;
+        defaultValue: string | null;
+    }>;
+    indexes: Array<{
+        name: string;
+        type: string;
+        isUnique: boolean;
+        columns: string[];
+    }>;
+}
+export declare function listDatabaseTables(databaseName?: string, schemaName?: string): Promise<sql.IRecordSet<any>>;
+export declare function describeTableSchema(tableName: string, databaseName?: string, schemaName?: string): Promise<sql.IRecordSet<any>>;
+export declare function listDatabaseObjects(databaseName?: string, objectTypes?: string[], schemaName?: string): Promise<DatabaseObjectSummary[]>;
+export declare function describeDatabaseObject(objectName: string, databaseName?: string, schemaName?: string, objectTypes?: string[]): Promise<DatabaseObjectDescription | null>;
+export declare function listConfiguredDatabases(): {
+    name: string;
+    isDefault: boolean;
+}[];
+export declare function getDatabaseSchemaSummary(databaseName?: string): Promise<{
+    objectCounts: sql.IRecordSet<any>;
+    schemaCounts: sql.IRecordSet<any>;
+}>;
+export declare function listForeignKeys(databaseName?: string, schemaName?: string): Promise<sql.IRecordSet<any>>;
+export declare function describeRelationships(tableName: string, databaseName?: string, schemaName?: string): Promise<any[]>;
+export declare function describeObjectDependencies(objectName: string, databaseName?: string, schemaName?: string): Promise<sql.IRecordSet<any>>;
+export interface AnalyzeTableResult {
+    summary: Record<string, unknown> | null;
+    indexes: Array<Record<string, unknown>>;
+}
+export declare function analyzeTable(tableName: string, databaseName?: string, schemaName?: string): Promise<AnalyzeTableResult>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

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