@neverinfamous/mysql-mcp 2.1.0

package/dist/filtering/ToolFilter.d.ts

@@ -0,0 +1,82 @@
+/**
+ * mysql-mcp - Tool Filtering System
+ *
+ * Parses and applies tool filter rules from environment variables.
+ * Compatible with db-mcp filtering syntax.
+ *
+ * Syntax:
+ *   -group    → Disable all tools in a group
+ *   +group    → Enable all tools in a group
+ *   -tool     → Disable a specific tool
+ *   +tool     → Enable a specific tool (after group disable)
+ */
+import type { ToolGroup, MetaGroup, ToolFilterConfig, ToolDefinition } from '../types/index.js';
+/**
+ * Default tool groups and their member tools.
+ * This serves as the canonical mapping of tools to groups.
+ */
+export { TOOL_GROUPS, META_GROUPS } from './ToolConstants.js';
+/**
+ * Get all tool names from all groups (cached)
+ */
+export declare function getAllToolNames(): string[];
+/**
+ * Get the group for a specific tool (O(1) lookup)
+ */
+export declare function getToolGroup(toolName: string): ToolGroup | undefined;
+/**
+ * Clear all caches - useful for testing
+ */
+export declare function clearToolFilterCaches(): void;
+/**
+ * Get all tool names from a meta-group
+ */
+export declare function getMetaGroupTools(metaGroup: MetaGroup): string[];
+/**
+ * Parse a tool filter string into structured rules
+ *
+ * @param filterString - The filter string (e.g., "-base,-ecosystem,+starter")
+ * @returns Parsed filter configuration
+ */
+export declare function parseToolFilter(filterString: string | undefined): ToolFilterConfig;
+/**
+ * Check if a tool is enabled based on filter configuration
+ */
+export declare function isToolEnabled(toolName: string, config: ToolFilterConfig): boolean;
+/**
+ * Filter a list of tool definitions based on filter configuration
+ */
+export declare function filterTools(tools: ToolDefinition[], config: ToolFilterConfig): ToolDefinition[];
+/**
+ * Get the tool filter from environment variable
+ */
+export declare function getToolFilterFromEnv(): ToolFilterConfig;
+/**
+ * Calculate token savings from tool filtering
+ * Assumes ~200 tokens per tool definition (description + parameters)
+ */
+export declare function calculateTokenSavings(totalTools: number, enabledTools: number, tokensPerTool?: number): {
+    tokensSaved: number;
+    percentSaved: number;
+};
+/**
+ * Generate a summary of the current filter configuration
+ */
+export declare function getFilterSummary(config: ToolFilterConfig): string;
+/**
+ * Get a list of all tool groups with their tool counts
+ */
+export declare function getToolGroupInfo(): {
+    group: ToolGroup;
+    count: number;
+    tools: string[];
+}[];
+/**
+ * Get a list of all meta-groups with their expanded tool counts
+ */
+export declare function getMetaGroupInfo(): {
+    metaGroup: MetaGroup;
+    groups: ToolGroup[];
+    count: number;
+}[];
+//# sourceMappingURL=ToolFilter.d.ts.map

package/dist/filtering/ToolFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolFilter.d.ts","sourceRoot":"","sources":["../../src/filtering/ToolFilter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACR,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,cAAc,EACjB,MAAM,mBAAmB,CAAC;AAc3B;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG9D;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAO1C;AAoBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAgBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAMhE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAqHlF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CACvB,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,gBAAgB,GACzB,cAAc,EAAE,CAElB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAKvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,SAAM,GACpB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAQ/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyDjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAOzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAMjG"}

package/dist/filtering/ToolFilter.js

@@ -0,0 +1,319 @@
+/**
+ * mysql-mcp - Tool Filtering System
+ *
+ * Parses and applies tool filter rules from environment variables.
+ * Compatible with db-mcp filtering syntax.
+ *
+ * Syntax:
+ *   -group    → Disable all tools in a group
+ *   +group    → Enable all tools in a group
+ *   -tool     → Disable a specific tool
+ *   +tool     → Enable a specific tool (after group disable)
+ */
+/**
+ * Cached list of all tool names
+ * Lazy-initialized since TOOL_GROUPS is immutable
+ */
+let cachedAllToolNames = null;
+/**
+ * Reverse lookup map: tool name -> group
+ * Lazy-initialized for O(1) tool group lookups
+ */
+let toolToGroupMap = null;
+/**
+ * Default tool groups and their member tools.
+ * This serves as the canonical mapping of tools to groups.
+ */
+export { TOOL_GROUPS, META_GROUPS } from './ToolConstants.js';
+import { TOOL_GROUPS, META_GROUPS } from './ToolConstants.js';
+/**
+ * Get all tool names from all groups (cached)
+ */
+export function getAllToolNames() {
+    if (cachedAllToolNames) {
+        return cachedAllToolNames;
+    }
+    const groups = Object.keys(TOOL_GROUPS);
+    cachedAllToolNames = groups.flatMap(group => TOOL_GROUPS[group]);
+    return cachedAllToolNames;
+}
+/**
+ * Get or initialize the tool-to-group reverse lookup map
+ */
+function getToolToGroupMap() {
+    if (toolToGroupMap) {
+        return toolToGroupMap;
+    }
+    toolToGroupMap = new Map();
+    const groups = Object.keys(TOOL_GROUPS);
+    for (const group of groups) {
+        for (const tool of TOOL_GROUPS[group]) {
+            toolToGroupMap.set(tool, group);
+        }
+    }
+    return toolToGroupMap;
+}
+/**
+ * Get the group for a specific tool (O(1) lookup)
+ */
+export function getToolGroup(toolName) {
+    return getToolToGroupMap().get(toolName);
+}
+/**
+ * Clear all caches - useful for testing
+ */
+export function clearToolFilterCaches() {
+    cachedAllToolNames = null;
+    toolToGroupMap = null;
+}
+/**
+ * Check if a name is a valid tool group
+ */
+function isToolGroup(name) {
+    return name in TOOL_GROUPS;
+}
+/**
+ * Check if a name is a valid meta-group
+ */
+function isMetaGroup(name) {
+    return name in META_GROUPS;
+}
+/**
+ * Get all tool names from a meta-group
+ */
+export function getMetaGroupTools(metaGroup) {
+    const tools = [];
+    for (const group of META_GROUPS[metaGroup]) {
+        tools.push(...TOOL_GROUPS[group]);
+    }
+    return tools;
+}
+/**
+ * Parse a tool filter string into structured rules
+ *
+ * @param filterString - The filter string (e.g., "-base,-ecosystem,+starter")
+ * @returns Parsed filter configuration
+ */
+export function parseToolFilter(filterString) {
+    const allTools = getAllToolNames();
+    const enabledTools = new Set(allTools);
+    if (!filterString || filterString.trim() === '') {
+        // Default to 'starter' group if no filter key is provided
+        const starterTools = new Set(getMetaGroupTools('starter'));
+        return {
+            raw: '',
+            rules: [],
+            enabledTools: starterTools
+        };
+    }
+    const rules = [];
+    const parts = filterString.split(',').map(p => p.trim()).filter(p => p);
+    if (parts.length === 0) {
+        return {
+            raw: filterString,
+            rules: [],
+            enabledTools
+        };
+    }
+    // If first rule is exclusion (-), start with ALL tools
+    // If first rule is inclusion (+) or no prefix, start with NO tools (whitelist mode)
+    const firstPart = parts[0];
+    if (!firstPart) {
+        // Should be unreachable due to parts.length check above
+        return {
+            raw: filterString,
+            rules: [],
+            enabledTools
+        };
+    }
+    const startsWithExclude = firstPart.startsWith('-');
+    if (!startsWithExclude) {
+        enabledTools.clear();
+    }
+    for (const part of parts) {
+        if (!part)
+            continue;
+        let isInclude = true; // Default to include
+        let isExclude = false;
+        let target = part;
+        if (part.startsWith('+')) {
+            isInclude = true;
+            target = part.substring(1);
+        }
+        else if (part.startsWith('-')) {
+            isInclude = false;
+            isExclude = true;
+            target = part.substring(1);
+        }
+        // Special case: 'all'
+        if (target === 'all') {
+            if (isExclude) {
+                enabledTools.clear();
+            }
+            else {
+                for (const tool of allTools) {
+                    enabledTools.add(tool);
+                }
+            }
+            continue;
+        }
+        const targetIsMetaGroup = isMetaGroup(target);
+        const targetIsGroup = isToolGroup(target);
+        rules.push({
+            type: isInclude ? 'include' : 'exclude',
+            target,
+            isGroup: targetIsGroup || targetIsMetaGroup
+        });
+        if (targetIsMetaGroup) {
+            // Expand meta-group to all its underlying groups' tools
+            const metaGroupTools = getMetaGroupTools(target);
+            if (isExclude) {
+                for (const tool of metaGroupTools) {
+                    enabledTools.delete(tool);
+                }
+            }
+            else {
+                for (const tool of metaGroupTools) {
+                    enabledTools.add(tool);
+                }
+            }
+        }
+        else if (targetIsGroup) {
+            const groupTools = TOOL_GROUPS[target];
+            if (isExclude) {
+                for (const tool of groupTools) {
+                    enabledTools.delete(tool);
+                }
+            }
+            else {
+                for (const tool of groupTools) {
+                    enabledTools.add(tool);
+                }
+            }
+        }
+        else {
+            // Individual tool
+            if (isExclude) {
+                enabledTools.delete(target);
+            }
+            else {
+                enabledTools.add(target);
+            }
+        }
+    }
+    return {
+        raw: filterString,
+        rules,
+        enabledTools
+    };
+}
+/**
+ * Check if a tool is enabled based on filter configuration
+ */
+export function isToolEnabled(toolName, config) {
+    return config.enabledTools.has(toolName);
+}
+/**
+ * Filter a list of tool definitions based on filter configuration
+ */
+export function filterTools(tools, config) {
+    return tools.filter(tool => config.enabledTools.has(tool.name));
+}
+/**
+ * Get the tool filter from environment variable
+ */
+export function getToolFilterFromEnv() {
+    const filterString = process.env['MYSQL_MCP_TOOL_FILTER'] ??
+        process.env['TOOL_FILTER'] ??
+        '';
+    return parseToolFilter(filterString);
+}
+/**
+ * Calculate token savings from tool filtering
+ * Assumes ~200 tokens per tool definition (description + parameters)
+ */
+export function calculateTokenSavings(totalTools, enabledTools, tokensPerTool = 200) {
+    const disabledTools = totalTools - enabledTools;
+    const tokensSaved = disabledTools * tokensPerTool;
+    const percentSaved = totalTools > 0
+        ? Math.round((disabledTools / totalTools) * 100)
+        : 0;
+    return { tokensSaved, percentSaved };
+}
+/**
+ * Generate a summary of the current filter configuration
+ */
+export function getFilterSummary(config) {
+    const allTools = getAllToolNames();
+    const enabledCount = config.enabledTools.size;
+    const totalCount = allTools.length;
+    const lines = [
+        `Tool Filter Summary:`,
+        `  Enabled: ${enabledCount}/${totalCount} tools`
+    ];
+    if (config.rules.length > 0) {
+        lines.push(`  Rules applied:`);
+        for (const rule of config.rules) {
+            const prefix = rule.type === 'include' ? '+' : '-';
+            // Determine type: meta-group, group, or tool
+            let type;
+            if (isMetaGroup(rule.target)) {
+                type = 'meta-group';
+            }
+            else if (rule.isGroup) {
+                type = 'group';
+            }
+            else {
+                type = 'tool';
+            }
+            lines.push(`    ${prefix}${rule.target} (${type})`);
+        }
+    }
+    // Show disabled groups
+    const disabledGroups = [];
+    const partialGroups = [];
+    const groups = Object.keys(TOOL_GROUPS);
+    for (const group of groups) {
+        const groupTools = TOOL_GROUPS[group];
+        const enabledInGroup = groupTools.filter(t => config.enabledTools.has(t)).length;
+        if (enabledInGroup === 0) {
+            disabledGroups.push(group);
+        }
+        else if (enabledInGroup < groupTools.length) {
+            partialGroups.push(`${group} (${enabledInGroup}/${groupTools.length})`);
+        }
+    }
+    if (disabledGroups.length > 0) {
+        lines.push(`  Disabled groups: ${disabledGroups.join(', ')}`);
+    }
+    if (partialGroups.length > 0) {
+        lines.push(`  Partial groups: ${partialGroups.join(', ')}`);
+    }
+    const { tokensSaved, percentSaved } = calculateTokenSavings(totalCount, enabledCount);
+    if (tokensSaved > 0) {
+        lines.push(`  Token savings: ~${tokensSaved} tokens (${percentSaved}%)`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Get a list of all tool groups with their tool counts
+ */
+export function getToolGroupInfo() {
+    const groups = Object.keys(TOOL_GROUPS);
+    return groups.map(group => ({
+        group,
+        count: TOOL_GROUPS[group].length,
+        tools: [...TOOL_GROUPS[group]]
+    }));
+}
+/**
+ * Get a list of all meta-groups with their expanded tool counts
+ */
+export function getMetaGroupInfo() {
+    return Object.entries(META_GROUPS).map(([metaGroup, groups]) => ({
+        metaGroup: metaGroup,
+        groups,
+        count: getMetaGroupTools(metaGroup).length
+    }));
+}
+//# sourceMappingURL=ToolFilter.js.map

package/dist/filtering/ToolFilter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * mysql-mcp - Public API
+ *
+ * Exports the main components for programmatic use.
+ */
+export { McpServer, createServer, DEFAULT_CONFIG, parseMySQLConnectionString } from './server/McpServer.js';
+export { DatabaseAdapter } from './adapters/DatabaseAdapter.js';
+export { MySQLAdapter } from './adapters/mysql/MySQLAdapter.js';
+export { ConnectionPool } from './pool/ConnectionPool.js';
+export type { ConnectionPoolConfig } from './pool/ConnectionPool.js';
+export { TOOL_GROUPS, getAllToolNames, getToolGroup, parseToolFilter, isToolEnabled, filterTools, getToolFilterFromEnv, calculateTokenSavings, getFilterSummary, getToolGroupInfo, clearToolFilterCaches } from './filtering/ToolFilter.js';
+export type { DatabaseType, DatabaseConfig, MySQLOptions, PoolConfig, PoolStats, HealthStatus, QueryResult, ColumnInfo, FieldInfo, TableInfo, SchemaInfo, IndexInfo, ConstraintInfo, RoutineInfo, TriggerInfo, TransportType, McpServerConfig, OAuthConfig, OAuthScope, TokenClaims, RequestContext, ToolGroup, ToolFilterRule, ToolFilterConfig, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition } from './types/index.js';
+export { MySQLMcpError, ConnectionError, PoolError, QueryError, AuthenticationError, AuthorizationError, ValidationError, TransactionError } from './types/index.js';
+export { logger } from './utils/logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAG5G,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EACH,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACH,aAAa,EACb,eAAe,EACf,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * mysql-mcp - Public API
+ *
+ * Exports the main components for programmatic use.
+ */
+// Server
+export { McpServer, createServer, DEFAULT_CONFIG, parseMySQLConnectionString } from './server/McpServer.js';
+// Adapters
+export { DatabaseAdapter } from './adapters/DatabaseAdapter.js';
+export { MySQLAdapter } from './adapters/mysql/MySQLAdapter.js';
+// Pool
+export { ConnectionPool } from './pool/ConnectionPool.js';
+// Filtering
+export { TOOL_GROUPS, getAllToolNames, getToolGroup, parseToolFilter, isToolEnabled, filterTools, getToolFilterFromEnv, calculateTokenSavings, getFilterSummary, getToolGroupInfo, clearToolFilterCaches } from './filtering/ToolFilter.js';
+// Errors
+export { MySQLMcpError, ConnectionError, PoolError, QueryError, AuthenticationError, AuthorizationError, ValidationError, TransactionError } from './types/index.js';
+// Logger
+export { logger } from './utils/logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAE5G,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO;AACP,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,YAAY;AACZ,OAAO,EACH,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACxB,MAAM,2BAA2B,CAAC;AAkCnC,SAAS;AACT,OAAO,EACH,aAAa,EACb,eAAe,EACf,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/logging/McpLogging.d.ts

@@ -0,0 +1,81 @@
+/**
+ * MCP Protocol Logging
+ *
+ * Bridges application logging to MCP protocol log notifications.
+ * This allows MCP clients to receive log messages from the server.
+ *
+ * MCP Spec Reference:
+ * https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/logging
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * MCP log levels as defined in the specification
+ * Maps to syslog severity levels (RFC 5424)
+ */
+export type McpLogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
+/**
+ * MCP Logger class that sends log messages to connected clients
+ */
+declare class McpLogger {
+    private server;
+    private loggerName;
+    private enabled;
+    private minLevel;
+    private isConnected;
+    /**
+     * Level priority for filtering
+     */
+    private readonly levelPriority;
+    /**
+     * Initialize the MCP logger with the SDK server instance
+     */
+    setServer(server: McpServer): void;
+    /**
+     * Mark the logger as connected (call after transport is established)
+     */
+    setConnected(connected: boolean): void;
+    /**
+     * Set the logger name (appears in log messages)
+     */
+    setLoggerName(name: string): void;
+    /**
+     * Enable or disable MCP logging
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Set minimum log level
+     */
+    setMinLevel(level: McpLogLevel): void;
+    /**
+     * Check if a level should be logged
+     */
+    private shouldLog;
+    /**
+     * Send a log message to connected MCP clients
+     */
+    log(level: McpLogLevel, message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    notice(message: string, data?: Record<string, unknown>): void;
+    warning(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    critical(message: string, data?: Record<string, unknown>): void;
+    alert(message: string, data?: Record<string, unknown>): void;
+    emergency(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Singleton MCP logger instance
+ *
+ * Usage:
+ *   import { mcpLogger } from './logging/McpLogging.js';
+ *
+ *   // In server startup:
+ *   mcpLogger.setServer(sdkServer);
+ *
+ *   // In application code:
+ *   mcpLogger.info('Query executed', { rowCount: 100 });
+ *   mcpLogger.error('Connection failed', { host: 'localhost' });
+ */
+export declare const mcpLogger: McpLogger;
+export {};
+//# sourceMappingURL=McpLogging.d.ts.map

package/dist/logging/McpLogging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpLogging.d.ts","sourceRoot":"","sources":["../../src/logging/McpLogging.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,WAAW,GACjB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAElB;;GAEG;AACH,cAAM,SAAS;IACX,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,WAAW,CAAS;IAE5B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAS5B;IAEF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIlC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIrC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqB9E,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGnE;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/logging/McpLogging.js

@@ -0,0 +1,129 @@
+/**
+ * MCP Protocol Logging
+ *
+ * Bridges application logging to MCP protocol log notifications.
+ * This allows MCP clients to receive log messages from the server.
+ *
+ * MCP Spec Reference:
+ * https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/logging
+ */
+/**
+ * MCP Logger class that sends log messages to connected clients
+ */
+class McpLogger {
+    server = null;
+    loggerName = 'mysql-mcp';
+    enabled = true;
+    minLevel = 'info';
+    isConnected = false;
+    /**
+     * Level priority for filtering
+     */
+    levelPriority = {
+        debug: 0,
+        info: 1,
+        notice: 2,
+        warning: 3,
+        error: 4,
+        critical: 5,
+        alert: 6,
+        emergency: 7
+    };
+    /**
+     * Initialize the MCP logger with the SDK server instance
+     */
+    setServer(server) {
+        this.server = server;
+    }
+    /**
+     * Mark the logger as connected (call after transport is established)
+     */
+    setConnected(connected) {
+        this.isConnected = connected;
+    }
+    /**
+     * Set the logger name (appears in log messages)
+     */
+    setLoggerName(name) {
+        this.loggerName = name;
+    }
+    /**
+     * Enable or disable MCP logging
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Set minimum log level
+     */
+    setMinLevel(level) {
+        this.minLevel = level;
+    }
+    /**
+     * Check if a level should be logged
+     */
+    shouldLog(level) {
+        return this.levelPriority[level] >= this.levelPriority[this.minLevel];
+    }
+    /**
+     * Send a log message to connected MCP clients
+     */
+    log(level, message, data) {
+        // Only send logs if connected - prevents "Not connected" errors
+        if (!this.enabled || !this.server || !this.isConnected || !this.shouldLog(level)) {
+            return;
+        }
+        try {
+            // Use the SDK's sendLoggingMessage method
+            void this.server.sendLoggingMessage({
+                level,
+                logger: this.loggerName,
+                data: data ? { message, ...data } : message
+            });
+        }
+        catch {
+            // Silently fail if logging fails - don't crash the server
+            // The MCP transport might not be connected yet
+        }
+    }
+    // Convenience methods for each log level
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    notice(message, data) {
+        this.log('notice', message, data);
+    }
+    warning(message, data) {
+        this.log('warning', message, data);
+    }
+    error(message, data) {
+        this.log('error', message, data);
+    }
+    critical(message, data) {
+        this.log('critical', message, data);
+    }
+    alert(message, data) {
+        this.log('alert', message, data);
+    }
+    emergency(message, data) {
+        this.log('emergency', message, data);
+    }
+}
+/**
+ * Singleton MCP logger instance
+ *
+ * Usage:
+ *   import { mcpLogger } from './logging/McpLogging.js';
+ *
+ *   // In server startup:
+ *   mcpLogger.setServer(sdkServer);
+ *
+ *   // In application code:
+ *   mcpLogger.info('Query executed', { rowCount: 100 });
+ *   mcpLogger.error('Connection failed', { host: 'localhost' });
+ */
+export const mcpLogger = new McpLogger();
+//# sourceMappingURL=McpLogging.js.map