@neverinfamous/mysql-mcp 2.1.0

package/dist/server/McpServer.d.ts

@@ -0,0 +1,86 @@
+/**
+ * mysql-mcp - MCP Server
+ *
+ * Main MCP server implementation with adapter registration,
+ * tool filtering, and transport handling.
+ */
+import { McpServer as SdkMcpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { DatabaseAdapter } from '../adapters/DatabaseAdapter.js';
+import type { McpServerConfig, DatabaseConfig, ToolFilterConfig } from '../types/index.js';
+/**
+ * Default server configuration
+ */
+export declare const DEFAULT_CONFIG: McpServerConfig;
+/**
+ * MySQL MCP Server
+ */
+export declare class McpServer {
+    private server;
+    private adapters;
+    private config;
+    private toolFilter;
+    private started;
+    private activeTransport;
+    constructor(config?: Partial<McpServerConfig>);
+    /**
+     * Register a database adapter
+     */
+    registerAdapter(adapter: DatabaseAdapter, alias?: string): void;
+    /**
+     * Get a registered adapter by key
+     */
+    getAdapter(key: string): DatabaseAdapter | undefined;
+    /**
+     * Get all registered adapters
+     */
+    getAdapters(): Map<string, DatabaseAdapter>;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+    /**
+     * Start the specified transport
+     */
+    private startTransport;
+    /**
+     * Start stdio transport
+     */
+    private startStdioTransport;
+    /**
+     * Stop the MCP server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get server configuration
+     */
+    getConfig(): McpServerConfig;
+    /**
+     * Get tool filter configuration
+     */
+    getToolFilter(): ToolFilterConfig;
+    /**
+     * Check if server is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get the underlying MCP SDK server instance
+     */
+    getSdkServer(): SdkMcpServer;
+    /**
+     * Create OAuth resource server from config
+     */
+    private createOAuthResourceServer;
+    /**
+     * Create token validator from config
+     */
+    private createTokenValidator;
+}
+/**
+ * Create a new MCP server instance
+ */
+export declare function createServer(config?: Partial<McpServerConfig>): McpServer;
+/**
+ * Parse database configuration from connection string
+ */
+export declare function parseMySQLConnectionString(connectionString: string): DatabaseConfig;
+//# sourceMappingURL=McpServer.d.ts.map

package/dist/server/McpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../src/server/McpServer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,IAAI,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAiB,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ1G;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,eAK5B,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAA0C;gBAErD,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IA4CjD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IA8B/D;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpD;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAI3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B;;OAEG;YACW,cAAc;IAiC5B;;OAEG;YACW,mBAAmB;IAKjC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC3B;;OAEG;IACH,SAAS,IAAI,eAAe;IAI5B;;OAEG;IACH,aAAa,IAAI,gBAAgB;IAIjC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,YAAY,IAAI,YAAY;IAI5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAsB/B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,SAAS,CAE7E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAanF"}

package/dist/server/McpServer.js

@@ -0,0 +1,289 @@
+/**
+ * mysql-mcp - MCP Server
+ *
+ * Main MCP server implementation with adapter registration,
+ * tool filtering, and transport handling.
+ */
+import { McpServer as SdkMcpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { generateInstructions } from '../constants/ServerInstructions.js';
+import { parseToolFilter, getFilterSummary } from '../filtering/ToolFilter.js';
+import { logger } from '../utils/logger.js';
+import { mcpLogger } from '../logging/McpLogging.js';
+import { progressFactory } from '../progress/ProgressReporter.js';
+import { OAuthResourceServer } from '../auth/OAuthResourceServer.js';
+import { TokenValidator } from '../auth/TokenValidator.js';
+/**
+ * Default server configuration
+ */
+export const DEFAULT_CONFIG = {
+    name: 'mysql-mcp',
+    version: '0.1.0',
+    transport: 'stdio',
+    databases: []
+};
+/**
+ * MySQL MCP Server
+ */
+export class McpServer {
+    server;
+    adapters = new Map();
+    config;
+    toolFilter;
+    started = false;
+    activeTransport = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.toolFilter = parseToolFilter(this.config.toolFilter);
+        // Generate dynamic instructions based on enabled tools
+        const instructions = generateInstructions(this.toolFilter.enabledTools, [], // Resources will be added when adapter is registered
+        [] // Prompts will be added when adapter is registered
+        );
+        this.server = new SdkMcpServer({
+            name: this.config.name,
+            version: this.config.version
+        }, {
+            capabilities: {
+                logging: {}
+            },
+            instructions
+        });
+        // Initialize MCP protocol logging so clients can receive log messages
+        mcpLogger.setServer(this.server);
+        // Initialize MCP protocol progress reporting for long-running operations
+        progressFactory.setServer(this.server);
+        // Log tool filter summary
+        if (this.toolFilter.rules.length > 0) {
+            logger.info(getFilterSummary(this.toolFilter));
+        }
+        // Log server initialization with capabilities
+        logger.info('MCP Server initialized', {
+            name: this.config.name,
+            version: this.config.version,
+            toolFilter: this.config.toolFilter ?? 'none',
+            capabilities: ['logging']
+        });
+    }
+    /**
+     * Register a database adapter
+     */
+    registerAdapter(adapter, alias) {
+        const key = alias ?? `${adapter.type}:default`;
+        if (this.adapters.has(key)) {
+            logger.warn(`Adapter already registered: ${key}`);
+            return;
+        }
+        this.adapters.set(key, adapter);
+        // Get counts before registration
+        const allTools = adapter.getToolDefinitions();
+        const allResources = adapter.getResourceDefinitions();
+        const allPrompts = adapter.getPromptDefinitions();
+        // Register adapter's tools, resources, and prompts
+        adapter.registerTools(this.server, this.toolFilter.enabledTools);
+        adapter.registerResources(this.server);
+        adapter.registerPrompts(this.server);
+        // Count enabled tools
+        const enabledToolCount = allTools.filter(t => this.toolFilter.enabledTools.has(t.name)).length;
+        logger.info(`Registered adapter: ${adapter.name} (${key})`);
+        logger.info(`  Tools: ${enabledToolCount}/${allTools.length} enabled`);
+        logger.info(`  Resources: ${allResources.length}`);
+        logger.info(`  Prompts: ${allPrompts.length}`);
+        mcpLogger.info(`Database adapter registered: ${adapter.name} (${enabledToolCount} tools, ${allResources.length} resources, ${allPrompts.length} prompts)`);
+    }
+    /**
+     * Get a registered adapter by key
+     */
+    getAdapter(key) {
+        return this.adapters.get(key);
+    }
+    /**
+     * Get all registered adapters
+     */
+    getAdapters() {
+        return this.adapters;
+    }
+    /**
+     * Start the MCP server
+     */
+    async start() {
+        if (this.started) {
+            logger.warn('Server already started');
+            return;
+        }
+        logger.info('Starting MCP server...');
+        try {
+            await this.startTransport(this.config.transport);
+            this.started = true;
+            // Enable MCP protocol logging now that transport is connected
+            mcpLogger.setConnected(true);
+            logger.info('Server started successfully');
+            mcpLogger.info('MySQL MCP server ready', { transport: this.config.transport });
+        }
+        catch (error) {
+            logger.error('Failed to start server', { error: String(error) });
+            throw error;
+        }
+    }
+    /**
+     * Start the specified transport
+     */
+    async startTransport(transport) {
+        switch (transport) {
+            case 'stdio':
+                await this.startStdioTransport();
+                break;
+            case 'http':
+            case 'sse': {
+                const { createHttpTransport } = await import('../transports/http.js');
+                const port = this.config.port ?? 3000;
+                const transport = createHttpTransport({
+                    port,
+                    host: 'localhost', // Default to localhost, could be configurable
+                    corsOrigins: ['*'], // Allow all for now, or make configurable
+                    // Pass OAuth config if enabled
+                    ...(this.config.oauth?.enabled ? {
+                        resourceServer: this.createOAuthResourceServer(),
+                        tokenValidator: this.createTokenValidator()
+                    } : {})
+                }, (sseTransport) => {
+                    logger.info('New SSE connection');
+                    void this.server.connect(sseTransport);
+                });
+                await transport.start();
+                this.activeTransport = transport;
+                break;
+            }
+            default:
+                throw new Error(`Unknown transport: ${String(transport)}`);
+        }
+    }
+    /**
+     * Start stdio transport
+     */
+    async startStdioTransport() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+    }
+    /**
+     * Stop the MCP server
+     */
+    async stop() {
+        if (!this.started) {
+            return;
+        }
+        logger.info('Stopping MCP server...');
+        // Disable MCP logging before disconnecting
+        mcpLogger.setConnected(false);
+        // Disconnect all adapters
+        for (const [key, adapter] of this.adapters) {
+            try {
+                await adapter.disconnect();
+                logger.info(`Disconnected adapter: ${key}`);
+            }
+            catch (error) {
+                logger.error(`Error disconnecting adapter ${key}`, { error: String(error) });
+            }
+        }
+        if (this.activeTransport) {
+            try {
+                await this.activeTransport.stop();
+            }
+            catch (error) {
+                logger.error('Error stopping transport', { error: String(error) });
+            }
+            this.activeTransport = null;
+        }
+        await this.server.close();
+        this.started = false;
+        logger.info('Server stopped');
+    }
+    /**
+     * Get server configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get tool filter configuration
+     */
+    getToolFilter() {
+        return this.toolFilter;
+    }
+    /**
+     * Check if server is running
+     */
+    isRunning() {
+        return this.started;
+    }
+    /**
+     * Get the underlying MCP SDK server instance
+     */
+    getSdkServer() {
+        return this.server;
+    }
+    /**
+     * Create OAuth resource server from config
+     */
+    createOAuthResourceServer() {
+        if (!this.config.oauth?.enabled) {
+            throw new Error('OAuth is not enabled');
+        }
+        // Use audience as resource ID if not explicitly configured in future
+        const resourceId = this.config.oauth.audience ?? 'mysql-mcp';
+        const issuer = this.config.oauth.issuer;
+        if (!issuer) {
+            throw new Error('OAuth issuer is required');
+        }
+        return new OAuthResourceServer({
+            resource: resourceId,
+            authorizationServers: [issuer],
+            scopesSupported: ['read', 'write', 'admin'],
+            bearerMethodsSupported: ['header']
+        });
+    }
+    /**
+     * Create token validator from config
+     */
+    createTokenValidator() {
+        if (!this.config.oauth?.enabled) {
+            throw new Error('OAuth is not enabled');
+        }
+        if (!this.config.oauth.jwksUri) {
+            throw new Error('OAuth JWKS URI is required for validation');
+        }
+        const issuer = this.config.oauth.issuer;
+        const audience = this.config.oauth.audience;
+        if (!issuer || !audience) {
+            throw new Error('OAuth issuer and audience are required');
+        }
+        return new TokenValidator({
+            issuer,
+            audience,
+            jwksUri: this.config.oauth.jwksUri,
+            clockTolerance: this.config.oauth.clockTolerance
+        });
+    }
+}
+/**
+ * Create a new MCP server instance
+ */
+export function createServer(config = {}) {
+    return new McpServer(config);
+}
+/**
+ * Parse database configuration from connection string
+ */
+export function parseMySQLConnectionString(connectionString) {
+    // Parse mysql://user:password@host:port/database
+    const url = new URL(connectionString);
+    return {
+        type: 'mysql',
+        host: url.hostname,
+        port: parseInt(url.port, 10) || 3306,
+        username: decodeURIComponent(url.username),
+        password: decodeURIComponent(url.password),
+        database: url.pathname.slice(1), // Remove leading /
+        options: Object.fromEntries(url.searchParams)
+    };
+}
+//# sourceMappingURL=McpServer.js.map

package/dist/server/McpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.js","sourceRoot":"","sources":["../../src/server/McpServer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,IAAI,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC3C,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,OAAO;IAClB,SAAS,EAAE,EAAE;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,SAAS;IACV,MAAM,CAAe;IACrB,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC9C,MAAM,CAAkB;IACxB,UAAU,CAAmB;IAC7B,OAAO,GAAG,KAAK,CAAC;IAChB,eAAe,GAAqC,IAAI,CAAC;IAEjE,YAAY,SAAmC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE1D,uDAAuD;QACvD,MAAM,YAAY,GAAG,oBAAoB,CACrC,IAAI,CAAC,UAAU,CAAC,YAAY,EAC5B,EAAE,EAAE,qDAAqD;QACzD,EAAE,CAAE,mDAAmD;SAC1D,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAC1B;YACI,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAC/B,EACD;YACI,YAAY,EAAE;gBACV,OAAO,EAAE,EAAE;aACd;YACD,YAAY;SACf,CACJ,CAAC;QAEF,sEAAsE;QACtE,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjC,yEAAyE;QACzE,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEvC,0BAA0B;QAC1B,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,8CAA8C;QAC9C,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE;YAClC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM;YAC5C,YAAY,EAAE,CAAC,SAAS,CAAC;SAC5B,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAwB,EAAE,KAAc;QACpD,MAAM,GAAG,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,UAAU,CAAC;QAE/C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;YAClD,OAAO;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEhC,iCAAiC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAElD,mDAAmD;QACnD,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QACjE,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErC,sBAAsB;QACtB,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAE/F,MAAM,CAAC,IAAI,CAAC,uBAAuB,OAAO,CAAC,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,YAAY,gBAAgB,IAAI,QAAQ,CAAC,MAAM,UAAU,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,gBAAgB,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,SAAS,CAAC,IAAI,CAAC,gCAAgC,OAAO,CAAC,IAAI,KAAK,gBAAgB,WAAW,YAAY,CAAC,MAAM,eAAe,UAAU,CAAC,MAAM,WAAW,CAAC,CAAC;IAC/J,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,WAAW;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACP,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACtC,OAAO;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAEtC,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YAEpB,8DAA8D;YAC9D,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAE7B,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAC3C,SAAS,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjE,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,SAAwB;QACjD,QAAQ,SAAS,EAAE,CAAC;YAChB,KAAK,OAAO;gBACR,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACjC,MAAM;YACV,KAAK,MAAM,CAAC;YACZ,KAAK,KAAK,CAAC,CAAC,CAAC;gBACT,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;gBACtE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;gBAEtC,MAAM,SAAS,GAAG,mBAAmB,CAAC;oBAClC,IAAI;oBACJ,IAAI,EAAE,WAAW,EAAE,8CAA8C;oBACjE,WAAW,EAAE,CAAC,GAAG,CAAC,EAAE,0CAA0C;oBAC9D,+BAA+B;oBAC/B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;wBAC7B,cAAc,EAAE,IAAI,CAAC,yBAAyB,EAAE;wBAChD,cAAc,EAAE,IAAI,CAAC,oBAAoB,EAAE;qBAC9C,CAAC,CAAC,CAAC,EAAE,CAAC;iBACV,EAAE,CAAC,YAAY,EAAE,EAAE;oBAChB,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;oBAClC,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBAC3C,CAAC,CAAC,CAAC;gBAEH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;gBACxB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;gBACjC,MAAM;YACV,CAAC;YACD;gBACI,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB;QAC7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACN,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAEtC,2CAA2C;QAC3C,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAE9B,0BAA0B;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzC,IAAI,CAAC;gBACD,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAChC,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,SAAS;QACL,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,aAAa;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS;QACL,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,YAAY;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,yBAAyB;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC5C,CAAC;QAED,qEAAqE;QACrE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,WAAW,CAAC;QAE7D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,IAAI,mBAAmB,CAAC;YAC3B,QAAQ,EAAE,UAAU;YACpB,oBAAoB,EAAE,CAAC,MAAM,CAAC;YAC9B,eAAe,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;YAC3C,sBAAsB,EAAE,CAAC,QAAQ,CAAC;SACrC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACK,oBAAoB;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC5C,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,cAAc,CAAC;YACtB,MAAM;YACN,QAAQ;YACR,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;YAClC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc;SACnD,CAAC,CAAC;IACP,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAmC,EAAE;IAC9D,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,gBAAwB;IAC/D,iDAAiD;IACjD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEtC,OAAO;QACH,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI;QACpC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC1C,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC1C,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,mBAAmB;QACpD,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC;KAChD,CAAC;AACN,CAAC"}

package/dist/transports/http.d.ts

@@ -0,0 +1,74 @@
+/**
+ * mysql-mcp - HTTP Transport
+ *
+ * HTTP/SSE transport with OAuth 2.0 support.
+ */
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import type { OAuthResourceServer } from '../auth/OAuthResourceServer.js';
+import type { TokenValidator } from '../auth/TokenValidator.js';
+/**
+ * HTTP transport configuration
+ */
+export interface HttpTransportConfig {
+    /** Port to listen on */
+    port: number;
+    /** Host to bind to (default: localhost) */
+    host?: string;
+    /** OAuth resource server (optional) */
+    resourceServer?: OAuthResourceServer;
+    /** Token validator (optional, required if resourceServer is provided) */
+    tokenValidator?: TokenValidator;
+    /** CORS allowed origins (default: none) */
+    corsOrigins?: string[];
+}
+/**
+ * HTTP Transport for MCP
+ */
+export declare class HttpTransport {
+    private server;
+    private readonly config;
+    private transport;
+    private readonly onConnect?;
+    constructor(config: HttpTransportConfig, onConnect?: (transport: StreamableHTTPServerTransport) => void);
+    /**
+     * Start the HTTP server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the HTTP server
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle incoming HTTP request
+     */
+    private handleRequest;
+    /**
+     * Handle SSE connection request
+     */
+    private handleSSERequest;
+    /**
+     * Handle MCP message request
+     */
+    private handleMessageRequest;
+    /**
+     * Handle protected resource metadata endpoint
+     */
+    private handleProtectedResourceMetadata;
+    /**
+     * Handle health check endpoint
+     */
+    private handleHealthCheck;
+    /**
+     * Set security headers for all responses
+     */
+    private setSecurityHeaders;
+    /**
+     * Set CORS headers
+     */
+    private setCorsHeaders;
+}
+/**
+ * Create an HTTP transport instance
+ */
+export declare function createHttpTransport(config: HttpTransportConfig, onConnect?: (transport: StreamableHTTPServerTransport) => void): HttpTransport;
+//# sourceMappingURL=http.d.ts.map

package/dist/transports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC,yEAAyE;IACzE,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAqD;gBAEpE,MAAM,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,6BAA6B,KAAK,IAAI;IAQvG;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;OAEG;YACW,aAAa;IA+D3B;;OAEG;YACW,gBAAgB;IAe9B;;OAEG;YACW,oBAAoB;IAUlC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAYvC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,cAAc;CAWzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,6BAA6B,KAAK,IAAI,GAAG,aAAa,CAE9I"}

package/dist/transports/http.js

@@ -0,0 +1,199 @@
+/**
+ * mysql-mcp - HTTP Transport
+ *
+ * HTTP/SSE transport with OAuth 2.0 support.
+ */
+import { createServer } from 'node:http';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { validateAuth, formatOAuthError } from '../auth/middleware.js';
+import { logger } from '../utils/logger.js';
+/**
+ * HTTP Transport for MCP
+ */
+export class HttpTransport {
+    server = null;
+    config;
+    transport = null;
+    onConnect;
+    constructor(config, onConnect) {
+        this.config = {
+            ...config,
+            host: config.host ?? 'localhost'
+        };
+        this.onConnect = onConnect;
+    }
+    /**
+     * Start the HTTP server
+     */
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server = createServer((req, res) => {
+                this.handleRequest(req, res).catch((error) => {
+                    logger.error('HTTP request handler error', { error: String(error) });
+                    if (!res.headersSent) {
+                        res.writeHead(500);
+                        res.end(JSON.stringify({ error: 'Internal server error' }));
+                    }
+                });
+            });
+            this.server.on('error', reject);
+            this.server.listen(this.config.port, this.config.host, () => {
+                logger.info(`HTTP transport listening on ${this.config.host}:${this.config.port}`);
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stop the HTTP server
+     */
+    async stop() {
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => {
+                    logger.info('HTTP transport stopped');
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    /**
+     * Handle incoming HTTP request
+     */
+    async handleRequest(req, res) {
+        // Set security headers for all responses
+        this.setSecurityHeaders(res);
+        // Set CORS headers
+        this.setCorsHeaders(req, res);
+        // Handle preflight
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = new URL(req.url ?? '/', `http://${req.headers.host}`);
+        // Handle well-known endpoints
+        if (url.pathname === '/.well-known/oauth-protected-resource') {
+            this.handleProtectedResourceMetadata(res);
+            return;
+        }
+        // Health check
+        if (url.pathname === '/health') {
+            this.handleHealthCheck(res);
+            return;
+        }
+        // Authenticate if OAuth is configured
+        // Note: For SSE connection (/sse), we authenticate via query param or header
+        if (this.config.resourceServer && this.config.tokenValidator) {
+            try {
+                // For regular requests
+                await validateAuth(req.headers.authorization, {
+                    tokenValidator: this.config.tokenValidator,
+                    required: true
+                });
+            }
+            catch (error) {
+                const { status, body } = formatOAuthError(error);
+                res.writeHead(status, {
+                    'Content-Type': 'application/json',
+                    'WWW-Authenticate': 'Bearer'
+                });
+                res.end(JSON.stringify(body));
+                return;
+            }
+        }
+        // Handle MCP requests
+        if (url.pathname === '/sse') {
+            await this.handleSSERequest(req, res);
+            return;
+        }
+        if (url.pathname === '/messages') {
+            await this.handleMessageRequest(req, res);
+            return;
+        }
+        res.writeHead(404);
+        res.end(JSON.stringify({ error: 'Not found' }));
+    }
+    /**
+     * Handle SSE connection request
+     */
+    async handleSSERequest(req, res) {
+        // StreamableHTTPServerTransport usage guided by type feedback and introspection
+        const transport = new StreamableHTTPServerTransport();
+        this.transport = transport;
+        await transport.start();
+        if (this.onConnect) {
+            this.onConnect(transport);
+        }
+        // Handle the request (keeps connection open for SSE)
+        await transport.handleRequest(req, res);
+    }
+    /**
+     * Handle MCP message request
+     */
+    async handleMessageRequest(req, res) {
+        if (!this.transport) {
+            res.writeHead(400);
+            res.end(JSON.stringify({ error: 'No active connection' }));
+            return;
+        }
+        await this.transport.handleRequest(req, res);
+    }
+    /**
+     * Handle protected resource metadata endpoint
+     */
+    handleProtectedResourceMetadata(res) {
+        if (!this.config.resourceServer) {
+            res.writeHead(404);
+            res.end(JSON.stringify({ error: 'OAuth not configured' }));
+            return;
+        }
+        const metadata = this.config.resourceServer.getMetadata();
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(metadata));
+    }
+    /**
+     * Handle health check endpoint
+     */
+    handleHealthCheck(res) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ status: 'healthy', timestamp: new Date().toISOString() }));
+    }
+    /**
+     * Set security headers for all responses
+     */
+    setSecurityHeaders(res) {
+        // Prevent MIME type sniffing
+        res.setHeader('X-Content-Type-Options', 'nosniff');
+        // Prevent clickjacking
+        res.setHeader('X-Frame-Options', 'DENY');
+        // Enable XSS filtering
+        res.setHeader('X-XSS-Protection', '1; mode=block');
+        // Prevent caching of API responses
+        res.setHeader('Cache-Control', 'no-store, no-cache, must-revalidate');
+        // Content Security Policy - API server has no content to load
+        res.setHeader('Content-Security-Policy', "default-src 'none'; frame-ancestors 'none'");
+    }
+    /**
+     * Set CORS headers
+     */
+    setCorsHeaders(req, res) {
+        const origin = req.headers.origin;
+        // Only allow configured origins
+        if (origin && this.config.corsOrigins?.includes(origin)) {
+            res.setHeader('Access-Control-Allow-Origin', origin);
+            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+            res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+            res.setHeader('Access-Control-Max-Age', '86400');
+        }
+    }
+}
+/**
+ * Create an HTTP transport instance
+ */
+export function createHttpTransport(config, onConnect) {
+    return new HttpTransport(config, onConnect);
+}
+//# sourceMappingURL=http.js.map