db-mcp 1.0.1

package/dist/server/McpServer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * db-mcp - Main MCP Server
+ *
+ * SQLite MCP server with OAuth 2.1 authentication,
+ * HTTP/SSE transport, and dynamic tool filtering.
+ */
+import type { McpServerConfig, DatabaseConfig } from "../types/index.js";
+import { type DatabaseAdapter } from "../adapters/DatabaseAdapter.js";
+/**
+ * Main db-mcp server class
+ *
+ * Manages database adapters, tool registration, and MCP protocol handling.
+ */
+export declare class DbMcpServer {
+    private server;
+    private adapters;
+    private toolFilter;
+    private config;
+    constructor(config: McpServerConfig);
+    /**
+     * Register a database adapter
+     */
+    registerAdapter(adapter: DatabaseAdapter, config: DatabaseConfig): Promise<void>;
+    /**
+     * Get an adapter by ID
+     */
+    getAdapter(adapterId: string): DatabaseAdapter | undefined;
+    /**
+     * Get all registered adapters
+     */
+    getAdapters(): Map<string, DatabaseAdapter>;
+    /**
+     * Register built-in server tools (health, info, etc.)
+     */
+    private registerBuiltInTools;
+    /**
+     * Start the server with the configured transport
+     */
+    start(): Promise<void>;
+    /**
+     * Start server with stdio transport
+     */
+    private startStdio;
+    /**
+     * Start server with HTTP transport (Streamable HTTP with SSE support)
+     */
+    private startHttp;
+    /**
+     * Gracefully shut down the server
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create and configure a db-mcp server instance
+ */
+export declare function createServer(config: McpServerConfig): DbMcpServer;
+/**
+ * Default server configuration
+ */
+export declare const DEFAULT_CONFIG: Partial<McpServerConfig>;
+//# 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;AAIH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAStE;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IA8CnC;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC;IAmBhB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI1D;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAI3C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuG5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;YACW,UAAU;IAQxB;;OAEG;YACW,SAAS;IAmDvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAoBhC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAEjE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,eAAe,CAKnD,CAAC"}

package/dist/server/McpServer.js

@@ -0,0 +1,270 @@
+/**
+ * db-mcp - Main MCP Server
+ *
+ * SQLite MCP server with OAuth 2.1 authentication,
+ * HTTP/SSE transport, and dynamic tool filtering.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { parseToolFilter, getFilterSummary, getToolFilterFromEnv, } from "../filtering/ToolFilter.js";
+import { generateInstructions } from "../constants/ServerInstructions.js";
+import { logger } from "../utils/logger.js";
+/**
+ * Main db-mcp server class
+ *
+ * Manages database adapters, tool registration, and MCP protocol handling.
+ */
+export class DbMcpServer {
+    server;
+    adapters = new Map();
+    toolFilter;
+    config;
+    constructor(config) {
+        this.config = config;
+        // Initialize tool filter from config or environment (needed for instructions)
+        this.toolFilter = config.toolFilter
+            ? parseToolFilter(config.toolFilter)
+            : getToolFilterFromEnv();
+        // Generate server instructions based on enabled tools
+        const enabledTools = new Set();
+        for (const group of this.toolFilter.enabledGroups) {
+            // Add all tools from enabled groups to the set
+            enabledTools.add(group);
+        }
+        const instructions = generateInstructions(enabledTools, [], []);
+        // Initialize MCP server with logging capability and instructions
+        this.server = new McpServer({
+            name: config.name,
+            version: config.version,
+        }, {
+            capabilities: {
+                logging: {},
+            },
+            instructions,
+        });
+        // Log filter summary
+        logger.info(getFilterSummary(this.toolFilter), { module: "FILTER" });
+        // Log server initialization with capabilities
+        logger.info("MCP Server initialized", {
+            module: "SERVER",
+            name: config.name,
+            version: config.version,
+            toolFilter: config.toolFilter ?? "none",
+            capabilities: ["logging"],
+        });
+        // Register built-in tools
+        this.registerBuiltInTools();
+    }
+    /**
+     * Register a database adapter
+     */
+    async registerAdapter(adapter, config) {
+        const adapterId = `${adapter.type}:${config.database ?? "default"}`;
+        // Connect to database
+        await adapter.connect(config);
+        // Store adapter
+        this.adapters.set(adapterId, adapter);
+        // Register adapter's tools with filtering
+        adapter.registerTools(this.server, this.toolFilter);
+        adapter.registerResources(this.server);
+        adapter.registerPrompts(this.server);
+        logger.info(`Registered adapter: ${adapter.name} (${adapterId})`, {
+            module: "SERVER",
+        });
+    }
+    /**
+     * Get an adapter by ID
+     */
+    getAdapter(adapterId) {
+        return this.adapters.get(adapterId);
+    }
+    /**
+     * Get all registered adapters
+     */
+    getAdapters() {
+        return this.adapters;
+    }
+    /**
+     * Register built-in server tools (health, info, etc.)
+     */
+    registerBuiltInTools() {
+        // Server info tool
+        this.server.registerTool("server_info", {
+            description: "Get information about the db-mcp server and registered adapters",
+        }, () => {
+            const adapterInfo = [];
+            for (const [id, adapter] of this.adapters) {
+                adapterInfo.push({
+                    id,
+                    ...adapter.getInfo(),
+                });
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            name: this.config.name,
+                            version: this.config.version,
+                            transport: this.config.transport,
+                            adapters: adapterInfo,
+                            toolFilter: {
+                                raw: this.toolFilter.raw,
+                                enabledGroups: [...this.toolFilter.enabledGroups],
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        });
+        // Health check tool
+        this.server.registerTool("server_health", { description: "Check health status of all database connections" }, async () => {
+            const health = {
+                server: "healthy",
+                timestamp: new Date().toISOString(),
+                adapters: {},
+            };
+            for (const [id, adapter] of this.adapters) {
+                try {
+                    const adapterHealth = await adapter.getHealth();
+                    health["adapters"][id] = adapterHealth;
+                }
+                catch (error) {
+                    health["adapters"][id] = {
+                        connected: false,
+                        error: error instanceof Error ? error.message : "Unknown error",
+                    };
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(health, null, 2),
+                    },
+                ],
+            };
+        });
+        // List adapters tool
+        this.server.registerTool("list_adapters", { description: "List all registered database adapters" }, () => {
+            const adapters = [];
+            for (const [id, adapter] of this.adapters) {
+                adapters.push({
+                    id,
+                    type: adapter.type,
+                    name: adapter.name,
+                    version: adapter.version,
+                    connected: adapter.isConnected(),
+                });
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(adapters, null, 2),
+                    },
+                ],
+            };
+        });
+    }
+    /**
+     * Start the server with the configured transport
+     */
+    async start() {
+        switch (this.config.transport) {
+            case "stdio":
+                await this.startStdio();
+                break;
+            case "http":
+                await this.startHttp();
+                break;
+            default:
+                throw new Error(`Unsupported transport: ${this.config.transport}`);
+        }
+    }
+    /**
+     * Start server with stdio transport
+     */
+    async startStdio() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        logger.info(`db-mcp server started (stdio transport)`, {
+            module: "SERVER",
+        });
+    }
+    /**
+     * Start server with HTTP transport (Streamable HTTP with SSE support)
+     */
+    async startHttp() {
+        const { HttpTransport } = await import("../transports/http.js");
+        // Build OAuth config, only including defined optional properties
+        const oauthConfig = {
+            enabled: this.config.oauth?.enabled ?? false,
+            authorizationServerUrl: this.config.oauth?.authorizationServerUrl ?? "",
+            audience: this.config.oauth?.audience ?? this.config.name,
+        };
+        // Only add optional properties if they are defined
+        if (this.config.oauth?.issuer !== undefined) {
+            oauthConfig.issuer = this.config.oauth.issuer;
+        }
+        if (this.config.oauth?.jwksUri !== undefined) {
+            oauthConfig.jwksUri = this.config.oauth.jwksUri;
+        }
+        if (this.config.oauth?.clockTolerance !== undefined) {
+            oauthConfig.clockTolerance = this.config.oauth.clockTolerance;
+        }
+        if (this.config.oauth?.publicPaths !== undefined) {
+            oauthConfig.publicPaths = this.config.oauth.publicPaths;
+        }
+        const transport = new HttpTransport({
+            port: this.config.port ?? 3000,
+            oauth: oauthConfig,
+            stateless: this.config.statelessHttp ?? false,
+        });
+        // Initialize transport with the MCP server reference
+        // In stateful mode, transport manages sessions internally
+        // In stateless mode, transport creates a single shared connection
+        await transport.initialize(this.server);
+        await transport.start();
+        const mode = this.config.statelessHttp ? "stateless" : "stateful";
+        logger.info(`db-mcp server started (HTTP transport on port ${String(this.config.port ?? 3000)}, ${mode} mode)`, { module: "TRANSPORT", mode });
+    }
+    /**
+     * Gracefully shut down the server
+     */
+    async shutdown() {
+        logger.info("Shutting down db-mcp server...", { module: "SERVER" });
+        // Disconnect all adapters
+        for (const [id, adapter] of this.adapters) {
+            try {
+                await adapter.disconnect();
+                logger.info(`Disconnected adapter: ${id}`, { module: "SERVER" });
+            }
+            catch (error) {
+                logger.error(`Error disconnecting adapter ${id}`, {
+                    module: "SERVER",
+                    error: error instanceof Error ? error : undefined,
+                });
+            }
+        }
+        // Close MCP server
+        await this.server.close();
+        logger.info("Server shutdown complete", { module: "SERVER" });
+    }
+}
+/**
+ * Create and configure a db-mcp server instance
+ */
+export function createServer(config) {
+    return new DbMcpServer(config);
+}
+/**
+ * Default server configuration
+ */
+export const DEFAULT_CONFIG = {
+    name: "db-mcp",
+    version: "0.1.0",
+    transport: "stdio",
+    databases: [],
+};
+//# 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":"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"}

package/dist/transports/http.d.ts

@@ -0,0 +1,134 @@
+/**
+ * db-mcp - HTTP Transport
+ *
+ * Streamable HTTP transport with OAuth 2.0 integration and SSE support.
+ * Provides secure HTTP endpoints for MCP communication with optional
+ * session management and server-sent events for notifications.
+ *
+ * Modes:
+ * - Stateful (default): Multi-session management with SSE streaming
+ * - Stateless (opt-in): Lightweight serverless-compatible mode
+ */
+import { type Express } from "express";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { OAuthResourceServer } from "../auth/OAuthResourceServer.js";
+/**
+ * HTTP transport configuration
+ */
+export interface HttpTransportConfig {
+    /** Port to listen on */
+    port: number;
+    /** Host to bind to (default: '0.0.0.0') */
+    host?: string;
+    /**
+     * Enable stateless HTTP mode (no session management, no SSE streaming).
+     * Ideal for serverless deployments (Lambda, Workers, Vercel).
+     * Default: false (stateful mode with session management and SSE support)
+     */
+    stateless?: boolean;
+    /** OAuth configuration */
+    oauth: {
+        /** Enable OAuth authentication */
+        enabled: boolean;
+        /** Authorization server URL */
+        authorizationServerUrl: string;
+        /** Expected audience in tokens */
+        audience: string;
+        /** Expected issuer (defaults to authorizationServerUrl) */
+        issuer?: string;
+        /** JWKS URI (auto-discovered if not provided) */
+        jwksUri?: string;
+        /** Clock tolerance in seconds (default: 60) */
+        clockTolerance?: number;
+        /** Paths that bypass authentication */
+        publicPaths?: string[];
+    };
+    /** CORS configuration */
+    cors?: {
+        /** Allowed origins */
+        origin?: string | string[] | boolean;
+        /** Allowed methods */
+        methods?: string[];
+        /** Allowed headers */
+        allowedHeaders?: string[];
+        /** Exposed headers */
+        exposedHeaders?: string[];
+        /** Allow credentials */
+        credentials?: boolean;
+    };
+    /** Resource URI (defaults to http://localhost:{port}) */
+    resourceUri?: string;
+}
+/**
+ * HTTP Transport for MCP with OAuth 2.0 integration and SSE support.
+ *
+ * Supports two modes:
+ * - Stateful (default): Multi-session management with SSE streaming for notifications
+ * - Stateless: Single transport, no session management - ideal for serverless
+ */
+export declare class HttpTransport {
+    private readonly config;
+    private app;
+    private httpServer;
+    private transports;
+    private statelessTransport;
+    private resourceServer;
+    private authServerDiscovery;
+    private tokenValidator;
+    private mcpServer;
+    constructor(config: HttpTransportConfig);
+    /**
+     * Initialize the transport with the MCP server.
+     *
+     * For stateful mode, the server reference is stored to connect new sessions.
+     * For stateless mode, a single transport is created and connected.
+     *
+     * @param server - The MCP server instance
+     */
+    initialize(server: McpServer): Promise<void>;
+    /**
+     * Configure CORS with SSE-compatible headers
+     */
+    private setupCors;
+    /**
+     * Set up stateless mode endpoints (serverless-compatible)
+     */
+    private setupStatelessEndpoints;
+    /**
+     * Set up stateful mode endpoints with session management and SSE
+     */
+    private setupStatefulEndpoints;
+    /**
+     * Apply OAuth authentication middleware if enabled
+     */
+    private applyAuthMiddleware;
+    /**
+     * Set up OAuth 2.0 components
+     */
+    private setupOAuth;
+    /**
+     * Start listening on the configured port
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the server and close all active sessions
+     */
+    stop(): Promise<void>;
+    /**
+     * Get the underlying Express app
+     */
+    getApp(): Express | null;
+    /**
+     * Get the number of active sessions (stateful mode only)
+     */
+    getActiveSessionCount(): number;
+    /**
+     * Get the OAuth Resource Server
+     */
+    getResourceServer(): OAuthResourceServer | null;
+}
+/**
+ * Create an HTTP transport instance
+ */
+export declare function createHttpTransport(config: HttpTransportConfig): 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;;;;;;;;;;GAUG;AAEH,OAAgB,EAAE,KAAK,OAAO,EAAuB,MAAM,SAAS,CAAC;AAMrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAcrE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,0BAA0B;IAC1B,KAAK,EAAE;QACL,kCAAkC;QAClC,OAAO,EAAE,OAAO,CAAC;QAEjB,+BAA+B;QAC/B,sBAAsB,EAAE,MAAM,CAAC;QAE/B,kCAAkC;QAClC,QAAQ,EAAE,MAAM,CAAC;QAEjB,2DAA2D;QAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,iDAAiD;QACjD,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,+CAA+C;QAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB,uCAAuC;QACvC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IAEF,yBAAyB;IACzB,IAAI,CAAC,EAAE;QACL,sBAAsB;QACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;QAErC,sBAAsB;QACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAEnB,sBAAsB;QACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAE1B,sBAAsB;QACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAE1B,wBAAwB;QACxB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAEF,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,UAAU,CAA4B;IAG9C,OAAO,CAAC,UAAU,CAAoD;IAGtE,OAAO,CAAC,kBAAkB,CAA8C;IAGxE,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,cAAc,CAA+B;IAGrD,OAAO,CAAC,SAAS,CAA0B;gBAE/B,MAAM,EAAE,mBAAmB;IAQvC;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA2ElD;;OAEG;IACH,OAAO,CAAC,SAAS;IAwDjB;;OAEG;YACW,uBAAuB;IA2DrC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA8J9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;YACW,UAAU;IA6DxB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD3B;;OAEG;IACH,MAAM,IAAI,OAAO,GAAG,IAAI;IAIxB;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,iBAAiB,IAAI,mBAAmB,GAAG,IAAI;CAGhD;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAEf"}