@1mcp/agent 0.16.0 → 0.18.0

package/build/server.js

@@ -4,30 +4,103 @@ import { createTransports } from './transport/transportFactory.js';
 import { ClientManager } from './core/client/clientManager.js';
 import { ServerManager } from './core/server/serverManager.js';
 import { McpConfigManager } from './config/mcpConfigManager.js';
+import { AgentConfigManager } from './core/server/agentConfig.js';
 import configReloadService from './services/configReloadService.js';
+import { McpLoadingManager } from './core/loading/mcpLoadingManager.js';
+import { AsyncLoadingOrchestrator } from './core/capabilities/asyncLoadingOrchestrator.js';
 /**
  * Main function to set up the MCP server
+ * Conditionally uses async or legacy loading based on configuration
  */
 async function setupServer() {
     try {
         const mcpConfig = McpConfigManager.getInstance().getTransportConfig();
+        const agentConfig = AgentConfigManager.getInstance();
+        const asyncLoadingEnabled = agentConfig.isAsyncLoadingEnabled();
         // Create transports from configuration
         const transports = createTransports(mcpConfig);
         logger.info(`Created ${Object.keys(transports).length} transports`);
-        // Create clients for each transport
-        const clientManager = ClientManager.getOrCreateInstance();
-        const clients = await clientManager.createClients(transports);
-        logger.info(`Created ${clients.size} clients`);
-        const serverManager = ServerManager.getOrCreateInstance({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION }, { capabilities: MCP_SERVER_CAPABILITIES }, clients, transports);
-        // Initialize config reload service at server startup
-        configReloadService.initialize(transports);
-        logger.info('Server setup completed successfully');
-        return serverManager;
+        if (asyncLoadingEnabled) {
+            logger.info('Using async loading mode - HTTP server will start immediately, MCP servers load in background');
+            return setupServerAsync(transports);
+        }
+        else {
+            logger.info('Using legacy synchronous loading mode - waiting for all MCP servers before starting HTTP server');
+            return setupServerSync(transports);
+        }
     }
     catch (error) {
         logger.error(`Failed to set up server: ${error}`);
         throw error;
     }
 }
-export { setupServer };
+/**
+ * Set up server with async loading (new mode)
+ * HTTP server starts immediately, MCP servers load in background
+ */
+async function setupServerAsync(transports) {
+    // Initialize client manager without connecting (for async loading)
+    const clientManager = ClientManager.getOrCreateInstance();
+    const clients = clientManager.initializeClientsAsync(transports);
+    logger.info(`Initialized storage for ${Object.keys(transports).length} MCP servers`);
+    // Create server manager with empty clients initially
+    const serverManager = ServerManager.getOrCreateInstance({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION }, { capabilities: MCP_SERVER_CAPABILITIES }, clients, transports);
+    // Initialize config reload service
+    configReloadService.initialize(transports);
+    // Create loading manager for async MCP server initialization
+    const loadingManager = new McpLoadingManager(clientManager);
+    // Create async loading orchestrator for capability tracking and notifications
+    const asyncOrchestrator = new AsyncLoadingOrchestrator(clients, serverManager, loadingManager);
+    asyncOrchestrator.initialize();
+    // Start async loading (non-blocking)
+    const loadingPromise = loadingManager
+        .startAsyncLoading(transports)
+        .then(() => {
+        logger.info('All MCP servers finished loading (successfully or failed)');
+    })
+        .catch((error) => {
+        logger.error('MCP loading process encountered an error:', error);
+    });
+    logger.info('Async server setup completed - HTTP server ready, MCP servers loading in background');
+    return {
+        serverManager,
+        loadingManager,
+        loadingPromise,
+        asyncOrchestrator,
+    };
+}
+/**
+ * Set up server with legacy synchronous loading
+ * Waits for all MCP servers to load before returning
+ */
+async function setupServerSync(transports) {
+    // Use the standard synchronous client creation
+    const clientManager = ClientManager.getOrCreateInstance();
+    const clients = await clientManager.createClients(transports);
+    logger.info(`Connected to ${clients.size} MCP servers synchronously`);
+    // Create server manager with connected clients
+    const serverManager = ServerManager.getOrCreateInstance({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION }, { capabilities: MCP_SERVER_CAPABILITIES }, clients, transports);
+    // Initialize config reload service
+    configReloadService.initialize(transports);
+    // Create a dummy loading manager for compatibility
+    const loadingManager = new McpLoadingManager(clientManager);
+    const loadingPromise = Promise.resolve(); // Already loaded
+    logger.info('Synchronous server setup completed - all MCP servers connected');
+    return {
+        serverManager,
+        loadingManager,
+        loadingPromise,
+    };
+}
+/**
+ * Legacy function for backward compatibility
+ * @deprecated Use setupServer() which returns ServerSetupResult
+ */
+async function setupServerLegacy() {
+    const result = await setupServer();
+    // Wait for loading to complete for legacy behavior
+    await result.loadingPromise;
+    return result.serverManager;
+}
+export { setupServer, setupServerLegacy };
 //# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,mBAAmB,MAAM,mCAAmC,CAAC;AAEpE;;GAEG;AACH,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC,kBAAkB,EAAE,CAAC;QACtE,uCAAuC;QACvC,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC;QAEpE,oCAAoC;QACpC,MAAM,aAAa,GAAG,aAAa,CAAC,mBAAmB,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC;QAE/C,MAAM,aAAa,GAAG,aAAa,CAAC,mBAAmB,CACrD,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,EAAE,EACtD,EAAE,YAAY,EAAE,uBAAuB,EAAE,EACzC,OAAO,EACP,UAAU,CACX,CAAC;QAEF,qDAAqD;QACrD,mBAAmB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAE3C,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACnD,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/build/services/configReloadService.d.ts

@@ -37,6 +37,14 @@ export declare class ConfigReloadService {
      * @param sessionId The session ID to remove
      */
     removeServerInfo(sessionId: string): void;
+    /**
+     * Send listChanged notifications to clients after config reload
+     */
+    private sendListChangedNotifications;
+    /**
+     * Trigger capability notifications for a specific inbound connection
+     */
+    private triggerCapabilityNotifications;
     /**
      * Stop the service and clean up resources
      */

package/build/services/configReloadService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configReloadService.d.ts","sourceRoot":"","sources":["../../src/services/configReloadService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM/F;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,WAAW,CAAS;IAE5B;;OAEG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,mBAAmB;IAOhD;;;OAGG;IACI,UAAU,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAoB7E;;;OAGG;YACW,kBAAkB;IAiDhC;;;;OAIG;IACI,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAK/E;;;OAGG;IACI,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKhD;;OAEG;IACI,IAAI,IAAI,IAAI;CAMpB;;AAED,wBAAiD"}
+{"version":3,"file":"configReloadService.d.ts","sourceRoot":"","sources":["../../src/services/configReloadService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM/F;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,WAAW,CAAS;IAE5B;;OAEG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,mBAAmB;IAOhD;;;OAGG;IACI,UAAU,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAoB7E;;;OAGG;YACW,kBAAkB;IAoDhC;;;;OAIG;IACI,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAK/E;;;OAGG;IACI,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKhD;;OAEG;YACW,4BAA4B;IAuB1C;;OAEG;YACW,8BAA8B;IAgD5C;;OAEG;IACI,IAAI,IAAI,IAAI;CAMpB;;AAED,wBAAiD"}

package/build/services/configReloadService.js

@@ -80,6 +80,8 @@ export class ConfigReloadService {
             }
             // Update current transports
             this.currentTransports = newTransports;
+            // Trigger listChanged notifications after successful config reload
+            await this.sendListChangedNotifications();
             logger.info('Configuration reload completed successfully');
         }
         catch (error) {
@@ -106,6 +108,72 @@ export class ConfigReloadService {
         this.serverInstances.delete(sessionId);
         logger.debug(`Removed server info for session ${sessionId} from config reload service`);
     }
+    /**
+     * Send listChanged notifications to clients after config reload
+     */
+    async sendListChangedNotifications() {
+        try {
+            const serverManager = ServerManager.current;
+            const inboundConnections = serverManager.getInboundConnections();
+            // For each connected client, get their AsyncLoadingOrchestrator and refresh capabilities
+            for (const [sessionId, inboundConnection] of inboundConnections) {
+                try {
+                    // Try to get the AsyncLoadingOrchestrator from the server context
+                    // Note: This requires the orchestrator to be accessible
+                    // We'll use a more direct approach to trigger listChanged notifications
+                    await this.triggerCapabilityNotifications(inboundConnection);
+                }
+                catch (error) {
+                    logger.error(`Failed to send listChanged notification for session ${sessionId}: ${error}`);
+                }
+            }
+            logger.info(`Sent listChanged notifications to ${inboundConnections.size} connected clients after config reload`);
+        }
+        catch (error) {
+            logger.error(`Failed to send listChanged notifications: ${error}`);
+        }
+    }
+    /**
+     * Trigger capability notifications for a specific inbound connection
+     */
+    async triggerCapabilityNotifications(inboundConnection) {
+        try {
+            // Get the current outbound connections (MCP servers)
+            const serverManager = ServerManager.current;
+            const outboundConnections = serverManager.getClients();
+            // Create a temporary capability aggregator to detect changes
+            const { CapabilityAggregator } = await import('../core/capabilities/capabilityAggregator.js');
+            const capabilityAggregator = new CapabilityAggregator(outboundConnections);
+            // Get the current capabilities
+            const changes = await capabilityAggregator.updateCapabilities();
+            // If there are capabilities to notify about, create notification manager and send
+            if (changes.hasChanges ||
+                changes.current.tools.length > 0 ||
+                changes.current.resources.length > 0 ||
+                changes.current.prompts.length > 0) {
+                const { NotificationManager } = await import('../core/notifications/notificationManager.js');
+                const notificationManager = new NotificationManager(inboundConnection);
+                // Force send notifications for all capability types that exist
+                const forcedChanges = {
+                    toolsChanged: changes.current.tools.length > 0,
+                    resourcesChanged: changes.current.resources.length > 0,
+                    promptsChanged: changes.current.prompts.length > 0,
+                    hasChanges: changes.current.tools.length > 0 ||
+                        changes.current.resources.length > 0 ||
+                        changes.current.prompts.length > 0,
+                    addedServers: changes.addedServers,
+                    removedServers: changes.removedServers,
+                    current: changes.current,
+                    previous: changes.previous,
+                };
+                notificationManager.handleCapabilityChanges(forcedChanges);
+                logger.debug(`Triggered listChanged notifications for capabilities: tools=${forcedChanges.toolsChanged}, resources=${forcedChanges.resourcesChanged}, prompts=${forcedChanges.promptsChanged}`);
+            }
+        }
+        catch (error) {
+            logger.error(`Error triggering capability notifications: ${error}`);
+        }
+    }
     /**
      * Stop the service and clean up resources
      */

package/build/services/configReloadService.js.map

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

package/build/transport/http/middlewares/mcpAvailabilityMiddleware.d.ts

@@ -0,0 +1,79 @@
+import { Request, Response, NextFunction } from 'express';
+import { McpLoadingManager } from '../../../core/loading/mcpLoadingManager.js';
+/**
+ * Extended request interface to include MCP loading information
+ */
+export interface McpRequest extends Request {
+    mcpAvailability?: {
+        availableServers: string[];
+        unavailableServers: string[];
+        loadingServers: string[];
+        oauthRequiredServers: string[];
+        hasPartialAvailability: boolean;
+        allServersReady: boolean;
+        requestedTags?: string[];
+        totalServersBeforeFiltering?: number;
+    };
+}
+/**
+ * Middleware options for MCP availability checking
+ */
+export interface McpAvailabilityOptions {
+    /** Whether to allow requests when some servers are still loading */
+    allowPartialAvailability?: boolean;
+    /** Whether to include OAuth-required servers as available */
+    includeOAuthServers?: boolean;
+    /** Custom error message for unavailable servers */
+    unavailableMessage?: string;
+    /** Custom error message for loading servers */
+    loadingMessage?: string;
+}
+/**
+ * Creates middleware that checks MCP server availability before processing requests
+ *
+ * This middleware examines the loading state of MCP servers and provides different
+ * behaviors based on server availability and configuration options.
+ *
+ * @param loadingManager - The MCP loading manager instance
+ * @param options - Configuration options for availability checking
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * const availabilityMiddleware = createMcpAvailabilityMiddleware(loadingManager, {
+ *   allowPartialAvailability: true,
+ *   includeOAuthServers: false,
+ * });
+ *
+ * router.post('/mcp', availabilityMiddleware, (req, res) => {
+ *   // Handle MCP request with availability info in req.mcpAvailability
+ * });
+ * ```
+ */
+export declare function createMcpAvailabilityMiddleware(loadingManager?: McpLoadingManager, options?: McpAvailabilityOptions): (req: McpRequest, res: Response, next: NextFunction) => void;
+/**
+ * Utility function to get MCP availability info from request
+ */
+export declare function getMcpAvailability(req: Request): {
+    availableServers: string[];
+    unavailableServers: string[];
+    loadingServers: string[];
+    oauthRequiredServers: string[];
+    hasPartialAvailability: boolean;
+    allServersReady: boolean;
+    requestedTags?: string[];
+    totalServersBeforeFiltering?: number;
+} | undefined;
+/**
+ * Utility function to check if all MCP servers are ready
+ */
+export declare function areAllMcpServersReady(req: Request): boolean;
+/**
+ * Utility function to get list of available MCP servers
+ */
+export declare function getAvailableMcpServers(req: Request): string[];
+/**
+ * Utility function to get list of loading MCP servers
+ */
+export declare function getLoadingMcpServers(req: Request): string[];
+//# sourceMappingURL=mcpAvailabilityMiddleware.d.ts.map

package/build/transport/http/middlewares/mcpAvailabilityMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpAvailabilityMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/middlewares/mcpAvailabilityMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAM/E;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,eAAe,CAAC,EAAE;QAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,sBAAsB,EAAE,OAAO,CAAC;QAChC,eAAe,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,2BAA2B,CAAC,EAAE,MAAM,CAAC;KACtC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAYD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,+BAA+B,CAC7C,cAAc,CAAC,EAAE,iBAAiB,EAClC,OAAO,GAAE,sBAA2B,IAI5B,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UA0R3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO;sBA9VzB,MAAM,EAAE;wBACN,MAAM,EAAE;oBACZ,MAAM,EAAE;0BACF,MAAM,EAAE;4BACN,OAAO;qBACd,OAAO;oBACR,MAAM,EAAE;kCACM,MAAM;cAyVvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAG7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAG3D"}

package/build/transport/http/middlewares/mcpAvailabilityMiddleware.js

@@ -0,0 +1,306 @@
+import logger from '../../../logger/logger.js';
+import { secureLogger } from '../../../logger/secureLogger.js';
+import { LoadingState } from '../../../core/loading/loadingStateTracker.js';
+import { getValidatedTags } from './scopeAuthMiddleware.js';
+import { McpConfigManager } from '../../../config/mcpConfigManager.js';
+import { sanitizeOAuthServerList } from '../../../logger/secureLogger.js';
+/**
+ * Default options for MCP availability middleware
+ */
+const DEFAULT_OPTIONS = {
+    allowPartialAvailability: true,
+    includeOAuthServers: false,
+    unavailableMessage: 'Some requested MCP servers are not available',
+    loadingMessage: 'Some requested MCP servers are still loading',
+};
+/**
+ * Creates middleware that checks MCP server availability before processing requests
+ *
+ * This middleware examines the loading state of MCP servers and provides different
+ * behaviors based on server availability and configuration options.
+ *
+ * @param loadingManager - The MCP loading manager instance
+ * @param options - Configuration options for availability checking
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * const availabilityMiddleware = createMcpAvailabilityMiddleware(loadingManager, {
+ *   allowPartialAvailability: true,
+ *   includeOAuthServers: false,
+ * });
+ *
+ * router.post('/mcp', availabilityMiddleware, (req, res) => {
+ *   // Handle MCP request with availability info in req.mcpAvailability
+ * });
+ * ```
+ */
+export function createMcpAvailabilityMiddleware(loadingManager, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    return (req, res, next) => {
+        try {
+            // If no loading manager, assume all servers are available (legacy mode)
+            if (!loadingManager) {
+                logger.debug('No loading manager - assuming all servers available');
+                next();
+                return;
+            }
+            // Get requested tags from scope auth middleware
+            const requestedTags = getValidatedTags(res);
+            // If no specific tags requested, get all servers
+            const stateTracker = loadingManager.getStateTracker();
+            const allStates = stateTracker.getAllServerStates();
+            // Filter servers based on requested tags
+            // Tags are used to control which MCP servers are available for requests.
+            // When tags are specified, only servers that have ALL the requested tags will be included.
+            const allServers = Array.from(allStates.keys());
+            let relevantServers;
+            if (requestedTags && requestedTags.length > 0) {
+                // Get server configurations to access tags
+                const configManager = McpConfigManager.getInstance();
+                const transportConfig = configManager.getTransportConfig();
+                // Filter servers that have ALL requested tags
+                // This implements the "AND" logic: servers must have every requested tag
+                relevantServers = allServers.filter((serverName) => {
+                    const serverConfig = transportConfig[serverName];
+                    if (!serverConfig || !serverConfig.tags) {
+                        // Server has no tags, so it doesn't match any tag request
+                        return false;
+                    }
+                    // Check if server has ALL requested tags (case-insensitive matching)
+                    const serverTags = serverConfig.tags.map((tag) => tag.toLowerCase());
+                    const requestedTagsLower = requestedTags.map((tag) => tag.toLowerCase());
+                    return requestedTagsLower.every((requestedTag) => serverTags.includes(requestedTag));
+                });
+                logger.debug(`Filtered ${relevantServers.length}/${allServers.length} servers ` + `with tags: ${requestedTags.join(', ')}`);
+            }
+            else {
+                relevantServers = allServers;
+                logger.debug(`Checking availability for all ${relevantServers.length} servers`);
+            }
+            // Categorize servers by state with detailed error information
+            const availableServers = [];
+            const unavailableServers = [];
+            const loadingServers = [];
+            const oauthRequiredServers = [];
+            // Collect detailed server information for error responses
+            const serverDetails = {};
+            for (const serverName of relevantServers) {
+                const serverInfo = stateTracker.getServerState(serverName);
+                if (!serverInfo) {
+                    unavailableServers.push(serverName);
+                    serverDetails[serverName] = {
+                        state: 'unknown',
+                        error: 'Server not found in loading state tracker',
+                    };
+                    continue;
+                }
+                // Store detailed information for this server
+                serverDetails[serverName] = {
+                    state: serverInfo.state,
+                    error: serverInfo.error?.message,
+                    duration: serverInfo.duration,
+                    retryCount: serverInfo.retryCount,
+                    authUrl: serverInfo.authorizationUrl,
+                };
+                switch (serverInfo.state) {
+                    case LoadingState.Ready:
+                        availableServers.push(serverName);
+                        break;
+                    case LoadingState.Loading:
+                    case LoadingState.Pending:
+                        loadingServers.push(serverName);
+                        break;
+                    case LoadingState.AwaitingOAuth:
+                        if (opts.includeOAuthServers) {
+                            availableServers.push(serverName);
+                        }
+                        else {
+                            oauthRequiredServers.push(serverName);
+                        }
+                        break;
+                    case LoadingState.Failed:
+                    case LoadingState.Cancelled:
+                    default:
+                        unavailableServers.push(serverName);
+                        break;
+                }
+            }
+            // Calculate availability metrics
+            const hasPartialAvailability = availableServers.length > 0;
+            const allServersReady = relevantServers.length > 0 && availableServers.length === relevantServers.length;
+            // Add availability info to request
+            req.mcpAvailability = {
+                availableServers,
+                unavailableServers,
+                loadingServers,
+                oauthRequiredServers,
+                hasPartialAvailability,
+                allServersReady,
+                requestedTags: requestedTags && requestedTags.length > 0 ? requestedTags : undefined,
+                totalServersBeforeFiltering: requestedTags && requestedTags.length > 0 ? allServers.length : undefined,
+            };
+            // Log availability status
+            const tagInfo = requestedTags && requestedTags.length > 0
+                ? ` (filtered by tags: ${requestedTags.join(', ')}, ${allServers.length} total)`
+                : '';
+            const oauthCount = oauthRequiredServers.length;
+            secureLogger.debug(`MCP Availability: ${availableServers.length}/${relevantServers.length} ready, ` +
+                `${loadingServers.length} loading, ${unavailableServers.length} failed, ` +
+                `${oauthCount} OAuth required${tagInfo}`);
+            // Decide whether to proceed based on availability
+            if (relevantServers.length === 0) {
+                // No servers configured - proceed normally
+                next();
+                return;
+            }
+            if (allServersReady) {
+                // All servers ready - proceed normally
+                next();
+                return;
+            }
+            if (!hasPartialAvailability) {
+                // No servers available - return error with detailed information
+                logger.warn('No MCP servers available for request');
+                // Create detailed error message including specific server failures
+                const failureDetails = unavailableServers
+                    .map((name) => {
+                    const detail = serverDetails[name];
+                    if (detail.error) {
+                        return `${name}: ${detail.error} (retries: ${detail.retryCount || 0})`;
+                    }
+                    return `${name}: ${detail.state}`;
+                })
+                    .join(', ');
+                const detailedMessage = unavailableServers.length > 0
+                    ? `No MCP servers are currently available. Failed servers: ${failureDetails}`
+                    : 'No MCP servers are currently available';
+                res.status(503).json({
+                    error: 'service_unavailable',
+                    message: detailedMessage,
+                    details: {
+                        total: relevantServers.length,
+                        available: availableServers.length,
+                        loading: loadingServers.length,
+                        failed: unavailableServers.length,
+                        oauthRequired: oauthRequiredServers.length,
+                        availableList: availableServers,
+                        loadingList: loadingServers,
+                        failedList: unavailableServers,
+                        oauthRequiredList: sanitizeOAuthServerList(oauthRequiredServers),
+                    },
+                    serverDetails,
+                    loading: {
+                        isComplete: stateTracker.isLoadingComplete(),
+                        summary: loadingManager.getSummary(),
+                    },
+                    timestamp: new Date().toISOString(),
+                });
+                return;
+            }
+            if (opts.allowPartialAvailability) {
+                // Some servers available - proceed with warning
+                logger.info(`Proceeding with partial MCP availability: ${availableServers.length}/${relevantServers.length} servers ready`);
+                // Add warning headers
+                res.setHeader('X-MCP-Partial-Availability', 'true');
+                res.setHeader('X-MCP-Available-Count', availableServers.length.toString());
+                res.setHeader('X-MCP-Total-Count', relevantServers.length.toString());
+                if (loadingServers.length > 0) {
+                    res.setHeader('X-MCP-Loading-Count', loadingServers.length.toString());
+                }
+                next();
+                return;
+            }
+            else {
+                // Partial availability not allowed - return error with detailed information
+                logger.warn('Partial MCP availability not allowed - blocking request');
+                const primaryReason = loadingServers.length > 0 ? 'loading' : 'unavailable';
+                let detailedMessage = primaryReason === 'loading' ? opts.loadingMessage : opts.unavailableMessage;
+                // Add specific error details for unavailable servers
+                if (unavailableServers.length > 0) {
+                    const failureDetails = unavailableServers
+                        .map((name) => {
+                        const detail = serverDetails[name];
+                        if (detail.error) {
+                            return `${name}: ${detail.error} (retries: ${detail.retryCount || 0})`;
+                        }
+                        return `${name}: ${detail.state}`;
+                    })
+                        .join(', ');
+                    detailedMessage += `. Failed servers: ${failureDetails}`;
+                }
+                // Add loading server details
+                if (loadingServers.length > 0) {
+                    const loadingDetails = loadingServers
+                        .map((name) => {
+                        const detail = serverDetails[name];
+                        const retryInfo = detail.retryCount && detail.retryCount > 0 ? ` (retry ${detail.retryCount})` : '';
+                        return `${name}: ${detail.state}${retryInfo}`;
+                    })
+                        .join(', ');
+                    detailedMessage +=
+                        primaryReason === 'loading'
+                            ? `. Loading servers: ${loadingDetails}`
+                            : ` Currently loading: ${loadingDetails}`;
+                }
+                res.status(primaryReason === 'loading' ? 202 : 503).json({
+                    error: primaryReason === 'loading' ? 'servers_loading' : 'servers_unavailable',
+                    message: detailedMessage,
+                    details: {
+                        total: relevantServers.length,
+                        available: availableServers.length,
+                        loading: loadingServers.length,
+                        failed: unavailableServers.length,
+                        oauthRequired: oauthRequiredServers.length,
+                        availableList: availableServers,
+                        loadingList: loadingServers,
+                        failedList: unavailableServers,
+                        oauthRequiredList: sanitizeOAuthServerList(oauthRequiredServers),
+                    },
+                    serverDetails,
+                    loading: {
+                        isComplete: stateTracker.isLoadingComplete(),
+                        summary: loadingManager.getSummary(),
+                    },
+                    retryAfter: primaryReason === 'loading' ? 30 : undefined, // Suggest retry in 30 seconds for loading
+                    timestamp: new Date().toISOString(),
+                });
+                return;
+            }
+        }
+        catch (error) {
+            logger.error('MCP availability check failed:', error);
+            // On error, proceed normally to avoid blocking requests
+            // This ensures the system remains functional even if availability checking fails
+            next();
+        }
+    };
+}
+/**
+ * Utility function to get MCP availability info from request
+ */
+export function getMcpAvailability(req) {
+    return req.mcpAvailability;
+}
+/**
+ * Utility function to check if all MCP servers are ready
+ */
+export function areAllMcpServersReady(req) {
+    const availability = getMcpAvailability(req);
+    return availability?.allServersReady ?? true; // Assume ready if no availability info
+}
+/**
+ * Utility function to get list of available MCP servers
+ */
+export function getAvailableMcpServers(req) {
+    const availability = getMcpAvailability(req);
+    return availability?.availableServers ?? [];
+}
+/**
+ * Utility function to get list of loading MCP servers
+ */
+export function getLoadingMcpServers(req) {
+    const availability = getMcpAvailability(req);
+    return availability?.loadingServers ?? [];
+}
+//# sourceMappingURL=mcpAvailabilityMiddleware.js.map