@darkiceinteractive/mcp-conductor 1.0.0

package/dist/hub/mcp-hub.d.ts

@@ -0,0 +1,176 @@
+/**
+ * MCP Hub - Connects to and manages real MCP servers
+ *
+ * This component:
+ * - Reads Claude config files to discover MCP servers
+ * - Spawns and connects to each server via stdio transport
+ * - Maintains connection pool with health monitoring
+ * - Caches tool schemas for efficient discovery
+ * - Supports hot-reload of server configurations
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { EventEmitter } from 'node:events';
+import { RateLimiter } from '../utils/index.js';
+import type { ServersConfig, RateLimitConfig } from '../config/schema.js';
+export type ServerStatus = 'connecting' | 'connected' | 'disconnected' | 'error';
+export interface ServerConnection {
+    name: string;
+    client: Client;
+    transport: StdioClientTransport;
+    status: ServerStatus;
+    tools: Tool[];
+    connectedAt?: Date;
+    lastError?: string;
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    rateLimiter?: RateLimiter;
+    rateLimitConfig?: RateLimitConfig;
+}
+export interface HubConfig {
+    /** Path to Claude config file (auto-detect if not specified) */
+    claudeConfigPath?: string;
+    /** Path to conductor config file (auto-detect if not specified) */
+    conductorConfigPath?: string;
+    /** Server allow/deny lists */
+    servers?: ServersConfig;
+    /** Connection timeout in milliseconds */
+    connectionTimeoutMs?: number;
+    /** Whether to auto-reconnect failed connections */
+    autoReconnect?: boolean;
+    /** Reconnect delay in milliseconds */
+    reconnectDelayMs?: number;
+    /** Maximum reconnect attempts */
+    maxReconnectAttempts?: number;
+}
+export interface HubEvents {
+    serverConnected: (serverName: string) => void;
+    serverDisconnected: (serverName: string, error?: Error) => void;
+    serverError: (serverName: string, error: Error) => void;
+    serversChanged: (added: string[], removed: string[]) => void;
+    toolsCached: (serverName: string, toolCount: number) => void;
+}
+export declare class MCPHub extends EventEmitter {
+    private config;
+    private connections;
+    private toolCache;
+    private reconnectAttempts;
+    private isShuttingDown;
+    constructor(config?: HubConfig);
+    /**
+     * Initialise the hub and connect to all configured servers
+     */
+    initialise(): Promise<void>;
+    /**
+     * Discover servers from conductor config and/or Claude config
+     * Returns a merged map of server configurations
+     */
+    private discoverServers;
+    /**
+     * Filter servers based on allow/deny lists
+     */
+    private filterServers;
+    /**
+     * Connect to a single MCP server
+     */
+    connectServer(name: string, serverConfig: {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+        rateLimit?: RateLimitConfig;
+    }): Promise<boolean>;
+    /**
+     * Handle server disconnection with optional reconnection
+     */
+    private handleDisconnection;
+    /**
+     * Cache tools from a connected server
+     */
+    private cacheServerTools;
+    /**
+     * Disconnect from a specific server
+     */
+    disconnectServer(name: string): Promise<void>;
+    /**
+     * Reload server configurations
+     */
+    reload(): Promise<{
+        added: string[];
+        removed: string[];
+    }>;
+    /**
+     * Shutdown all connections
+     */
+    shutdown(): Promise<void>;
+    /**
+     * List all connected servers
+     */
+    listServers(): Array<{
+        name: string;
+        status: ServerStatus;
+        toolCount: number;
+        connectedAt?: Date;
+        lastError?: string;
+    }>;
+    /**
+     * Get tools for a specific server
+     */
+    getServerTools(serverName: string): Tool[];
+    /**
+     * Get all tools from all servers
+     */
+    getAllTools(): Array<{
+        server: string;
+        tool: Tool;
+    }>;
+    /**
+     * Search for tools across all servers
+     */
+    searchTools(query: string): Array<{
+        server: string;
+        tool: string;
+        description: string;
+    }>;
+    /**
+     * Call a tool on a specific server
+     */
+    callTool(serverName: string, toolName: string, params: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Check if a server is connected
+     */
+    isServerConnected(serverName: string): boolean;
+    /**
+     * Get server count by status
+     */
+    getStats(): {
+        total: number;
+        connected: number;
+        error: number;
+        disconnected: number;
+    };
+    /**
+     * Get the Claude config file path being used
+     */
+    getConfigPath(): string | null;
+    /**
+     * Get the conductor config file path being used
+     */
+    getConductorConfigPath(): string | null;
+    /**
+     * Check if running in exclusive mode (conductor config only)
+     */
+    isExclusiveMode(): boolean;
+    /**
+     * Get configuration info for status display
+     */
+    getConfigInfo(): {
+        mode: 'exclusive' | 'shared' | 'claude-only';
+        conductorConfigPath: string | null;
+        claudeConfigPath: string | null;
+        conductorServerCount: number;
+        claudeServerCount: number;
+    };
+}
+//# sourceMappingURL=mcp-hub.d.ts.map

package/dist/hub/mcp-hub.d.ts.map

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