@wundr.io/mcp-registry 1.0.3

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @wundr.io/mcp-registry - MCP Server Registry and Discovery
+ *
+ * Implements MCP server registry, discovery, and the Super MCP aggregator
+ * pattern for unified tool routing across multiple MCP servers.
+ *
+ * Features:
+ * - Server registration and lifecycle management
+ * - Capability-based server discovery
+ * - Health monitoring and automatic recovery
+ * - Circuit breaker pattern for fault tolerance
+ * - Multiple routing strategies (priority, round-robin, least-latency, etc.)
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   MCPServerRegistry,
+ *   MCPAggregator,
+ *   ServerHealthMonitor,
+ *   createServerDiscoveryService,
+ * } from '@wundr.io/mcp-registry';
+ *
+ * // Create registry
+ * const registry = new MCPServerRegistry();
+ *
+ * // Register servers
+ * await registry.register({
+ *   name: 'wundr-mcp',
+ *   version: '1.0.0',
+ *   transport: { type: 'stdio', command: 'npx', args: ['@wundr.io/mcp-server'] },
+ * });
+ *
+ * // Create aggregator
+ * const aggregator = new MCPAggregator(registry, {
+ *   defaultStrategy: 'health-aware',
+ *   enableRetries: true,
+ * });
+ *
+ * // Start health monitoring
+ * const monitor = new ServerHealthMonitor(registry);
+ * await monitor.start();
+ *
+ * // Invoke tools
+ * const response = await aggregator.invoke({
+ *   name: 'drift_detection',
+ *   arguments: { action: 'detect' },
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { MCPAggregator } from './aggregator';
+import type { ServerDiscoveryService } from './discovery';
+import type { ServerHealthMonitor } from './health-monitor';
+import type { MCPServerRegistry } from './registry';
+import type { AggregatorConfig, HealthMonitorConfig } from './types';
+export { TransportType, CapabilityCategory, MCPCapability, ToolDefinition, ToolInputSchema, JsonSchemaProperty, ResourceDefinition, PromptDefinition, PromptArgument, TransportConfig, MCPServerRegistration, ServerRegistrationOptions, HealthLevel, HealthCheckResult, HealthStatus, HealthMonitorConfig, TextContent, ImageContent, EmbeddedResourceContent, ToolContentItem, ToolResult, ToolInvocationRequest, ToolInvocationResponse, CapabilityQuery, DiscoveryResult, RoutingStrategy, AggregatorConfig, CircuitBreakerState, CircuitBreakerStatus, RegistryEventType, RegistryEvent, TransportTypeSchema, TransportConfigSchema, ServerRegistrationOptionsSchema, ToolInvocationRequestSchema, CapabilityQuerySchema, AggregatorConfigSchema, HealthMonitorConfigSchema, } from './types';
+export { MCPServerRegistry, createMCPServerRegistry, RegistryStats, RegistryExport, RegistryEvents, ServerNotFoundError, ServerAlreadyExistsError, RegistrationValidationError, } from './registry';
+export { ServerDiscoveryService, createServerDiscoveryService, CapabilityQueryBuilder, DiscoveryOptions, RecommendationContext, UsageHistoryEntry, ServerRecommendation, NoServersFoundError, InvalidQueryError, } from './discovery';
+export { MCPAggregator, createMCPAggregator, AggregatorEvents, AggregatorStats, RequestEvent, CircuitEvent, ToolHandler, NoServerAvailableError, ToolInvocationTimeoutError, CircuitBreakerOpenError, RetryExhaustedError, } from './aggregator';
+export { ServerHealthMonitor, createServerHealthMonitor, HealthMonitorEvents, HealthMonitorStats, HealthCheckEvent, HealthChangeEvent, ConnectionEvent, HealthCheckFn, RegisteredHealthCheck, HealthCheckError, } from './health-monitor';
+/**
+ * Create a complete MCP registry system with all components
+ *
+ * @param config - Optional configuration for all components
+ * @returns Object containing all registry components
+ *
+ * @example
+ * ```typescript
+ * const { registry, discovery, aggregator, monitor } = createMCPRegistrySystem({
+ *   aggregator: { defaultStrategy: 'health-aware' },
+ *   monitor: { checkInterval: 10000 },
+ * });
+ *
+ * await monitor.start();
+ * ```
+ */
+export declare function createMCPRegistrySystem(config?: MCPRegistrySystemConfig): Promise<MCPRegistrySystem>;
+/**
+ * Configuration for the complete MCP registry system
+ */
+export interface MCPRegistrySystemConfig {
+    /** Aggregator configuration */
+    aggregator?: AggregatorConfig;
+    /** Health monitor configuration */
+    monitor?: HealthMonitorConfig;
+}
+/**
+ * Complete MCP registry system with all components
+ */
+export interface MCPRegistrySystem {
+    /** Server registry */
+    registry: MCPServerRegistry;
+    /** Discovery service */
+    discovery: ServerDiscoveryService;
+    /** Request aggregator */
+    aggregator: MCPAggregator;
+    /** Health monitor */
+    monitor: ServerHealthMonitor;
+}
+/**
+ * Package version
+ */
+export declare const VERSION = "1.0.3";
+/**
+ * Default export - the createMCPRegistrySystem function
+ */
+export default createMCPRegistrySystem;
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMrE,OAAO,EAEL,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,yBAAyB,EAGzB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EAGnB,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,sBAAsB,EAGtB,eAAe,EACf,eAAe,EAGf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EAGpB,iBAAiB,EACjB,aAAa,EAGb,mBAAmB,EACnB,qBAAqB,EACrB,+BAA+B,EAC/B,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAM1B;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAiB5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,mCAAmC;IACnC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,wBAAwB;IACxB,SAAS,EAAE,sBAAsB,CAAC;IAClC,yBAAyB;IACzB,UAAU,EAAE,aAAa,CAAC;IAC1B,qBAAqB;IACrB,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAMD;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAM/B;;GAEG;AACH,eAAe,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * @wundr.io/mcp-registry - MCP Server Registry and Discovery
+ *
+ * Implements MCP server registry, discovery, and the Super MCP aggregator
+ * pattern for unified tool routing across multiple MCP servers.
+ *
+ * Features:
+ * - Server registration and lifecycle management
+ * - Capability-based server discovery
+ * - Health monitoring and automatic recovery
+ * - Circuit breaker pattern for fault tolerance
+ * - Multiple routing strategies (priority, round-robin, least-latency, etc.)
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   MCPServerRegistry,
+ *   MCPAggregator,
+ *   ServerHealthMonitor,
+ *   createServerDiscoveryService,
+ * } from '@wundr.io/mcp-registry';
+ *
+ * // Create registry
+ * const registry = new MCPServerRegistry();
+ *
+ * // Register servers
+ * await registry.register({
+ *   name: 'wundr-mcp',
+ *   version: '1.0.0',
+ *   transport: { type: 'stdio', command: 'npx', args: ['@wundr.io/mcp-server'] },
+ * });
+ *
+ * // Create aggregator
+ * const aggregator = new MCPAggregator(registry, {
+ *   defaultStrategy: 'health-aware',
+ *   enableRetries: true,
+ * });
+ *
+ * // Start health monitoring
+ * const monitor = new ServerHealthMonitor(registry);
+ * await monitor.start();
+ *
+ * // Invoke tools
+ * const response = await aggregator.invoke({
+ *   name: 'drift_detection',
+ *   arguments: { action: 'detect' },
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = exports.HealthCheckError = exports.createServerHealthMonitor = exports.ServerHealthMonitor = exports.RetryExhaustedError = exports.CircuitBreakerOpenError = exports.ToolInvocationTimeoutError = exports.NoServerAvailableError = exports.createMCPAggregator = exports.MCPAggregator = exports.InvalidQueryError = exports.NoServersFoundError = exports.CapabilityQueryBuilder = exports.createServerDiscoveryService = exports.ServerDiscoveryService = exports.RegistrationValidationError = exports.ServerAlreadyExistsError = exports.ServerNotFoundError = exports.createMCPServerRegistry = exports.MCPServerRegistry = exports.HealthMonitorConfigSchema = exports.AggregatorConfigSchema = exports.CapabilityQuerySchema = exports.ToolInvocationRequestSchema = exports.ServerRegistrationOptionsSchema = exports.TransportConfigSchema = exports.TransportTypeSchema = void 0;
+exports.createMCPRegistrySystem = createMCPRegistrySystem;
+// =============================================================================
+// Type Exports
+// =============================================================================
+var types_1 = require("./types");
+// Zod schemas for runtime validation
+Object.defineProperty(exports, "TransportTypeSchema", { enumerable: true, get: function () { return types_1.TransportTypeSchema; } });
+Object.defineProperty(exports, "TransportConfigSchema", { enumerable: true, get: function () { return types_1.TransportConfigSchema; } });
+Object.defineProperty(exports, "ServerRegistrationOptionsSchema", { enumerable: true, get: function () { return types_1.ServerRegistrationOptionsSchema; } });
+Object.defineProperty(exports, "ToolInvocationRequestSchema", { enumerable: true, get: function () { return types_1.ToolInvocationRequestSchema; } });
+Object.defineProperty(exports, "CapabilityQuerySchema", { enumerable: true, get: function () { return types_1.CapabilityQuerySchema; } });
+Object.defineProperty(exports, "AggregatorConfigSchema", { enumerable: true, get: function () { return types_1.AggregatorConfigSchema; } });
+Object.defineProperty(exports, "HealthMonitorConfigSchema", { enumerable: true, get: function () { return types_1.HealthMonitorConfigSchema; } });
+// =============================================================================
+// Registry Exports
+// =============================================================================
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "MCPServerRegistry", { enumerable: true, get: function () { return registry_1.MCPServerRegistry; } });
+Object.defineProperty(exports, "createMCPServerRegistry", { enumerable: true, get: function () { return registry_1.createMCPServerRegistry; } });
+Object.defineProperty(exports, "ServerNotFoundError", { enumerable: true, get: function () { return registry_1.ServerNotFoundError; } });
+Object.defineProperty(exports, "ServerAlreadyExistsError", { enumerable: true, get: function () { return registry_1.ServerAlreadyExistsError; } });
+Object.defineProperty(exports, "RegistrationValidationError", { enumerable: true, get: function () { return registry_1.RegistrationValidationError; } });
+// =============================================================================
+// Discovery Exports
+// =============================================================================
+var discovery_1 = require("./discovery");
+Object.defineProperty(exports, "ServerDiscoveryService", { enumerable: true, get: function () { return discovery_1.ServerDiscoveryService; } });
+Object.defineProperty(exports, "createServerDiscoveryService", { enumerable: true, get: function () { return discovery_1.createServerDiscoveryService; } });
+Object.defineProperty(exports, "CapabilityQueryBuilder", { enumerable: true, get: function () { return discovery_1.CapabilityQueryBuilder; } });
+Object.defineProperty(exports, "NoServersFoundError", { enumerable: true, get: function () { return discovery_1.NoServersFoundError; } });
+Object.defineProperty(exports, "InvalidQueryError", { enumerable: true, get: function () { return discovery_1.InvalidQueryError; } });
+// =============================================================================
+// Aggregator Exports
+// =============================================================================
+var aggregator_1 = require("./aggregator");
+Object.defineProperty(exports, "MCPAggregator", { enumerable: true, get: function () { return aggregator_1.MCPAggregator; } });
+Object.defineProperty(exports, "createMCPAggregator", { enumerable: true, get: function () { return aggregator_1.createMCPAggregator; } });
+Object.defineProperty(exports, "NoServerAvailableError", { enumerable: true, get: function () { return aggregator_1.NoServerAvailableError; } });
+Object.defineProperty(exports, "ToolInvocationTimeoutError", { enumerable: true, get: function () { return aggregator_1.ToolInvocationTimeoutError; } });
+Object.defineProperty(exports, "CircuitBreakerOpenError", { enumerable: true, get: function () { return aggregator_1.CircuitBreakerOpenError; } });
+Object.defineProperty(exports, "RetryExhaustedError", { enumerable: true, get: function () { return aggregator_1.RetryExhaustedError; } });
+// =============================================================================
+// Health Monitor Exports
+// =============================================================================
+var health_monitor_1 = require("./health-monitor");
+Object.defineProperty(exports, "ServerHealthMonitor", { enumerable: true, get: function () { return health_monitor_1.ServerHealthMonitor; } });
+Object.defineProperty(exports, "createServerHealthMonitor", { enumerable: true, get: function () { return health_monitor_1.createServerHealthMonitor; } });
+Object.defineProperty(exports, "HealthCheckError", { enumerable: true, get: function () { return health_monitor_1.HealthCheckError; } });
+// =============================================================================
+// Convenience Factory Functions
+// =============================================================================
+/**
+ * Create a complete MCP registry system with all components
+ *
+ * @param config - Optional configuration for all components
+ * @returns Object containing all registry components
+ *
+ * @example
+ * ```typescript
+ * const { registry, discovery, aggregator, monitor } = createMCPRegistrySystem({
+ *   aggregator: { defaultStrategy: 'health-aware' },
+ *   monitor: { checkInterval: 10000 },
+ * });
+ *
+ * await monitor.start();
+ * ```
+ */
+async function createMCPRegistrySystem(config) {
+    const { MCPServerRegistry } = await Promise.resolve().then(() => __importStar(require('./registry')));
+    const { ServerDiscoveryService } = await Promise.resolve().then(() => __importStar(require('./discovery')));
+    const { MCPAggregator } = await Promise.resolve().then(() => __importStar(require('./aggregator')));
+    const { ServerHealthMonitor } = await Promise.resolve().then(() => __importStar(require('./health-monitor')));
+    const registry = new MCPServerRegistry();
+    const discovery = new ServerDiscoveryService(registry);
+    const aggregator = new MCPAggregator(registry, config?.aggregator);
+    const monitor = new ServerHealthMonitor(registry, config?.monitor);
+    return {
+        registry,
+        discovery,
+        aggregator,
+        monitor,
+    };
+}
+// =============================================================================
+// Version Export
+// =============================================================================
+/**
+ * Package version
+ */
+exports.VERSION = '1.0.3';
+// =============================================================================
+// Default Export
+// =============================================================================
+/**
+ * Default export - the createMCPRegistrySystem function
+ */
+exports.default = createMCPRegistrySystem;
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4JH,0DAmBC;AAnKD,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,iCAoDiB;AARf,qCAAqC;AACrC,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,wHAAA,+BAA+B,OAAA;AAC/B,oHAAA,2BAA2B,OAAA;AAC3B,8GAAA,qBAAqB,OAAA;AACrB,+GAAA,sBAAsB,OAAA;AACtB,kHAAA,yBAAyB,OAAA;AAG3B,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,uCASoB;AARlB,6GAAA,iBAAiB,OAAA;AACjB,mHAAA,uBAAuB,OAAA;AAIvB,+GAAA,mBAAmB,OAAA;AACnB,oHAAA,wBAAwB,OAAA;AACxB,uHAAA,2BAA2B,OAAA;AAG7B,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,yCAUqB;AATnB,mHAAA,sBAAsB,OAAA;AACtB,yHAAA,4BAA4B,OAAA;AAC5B,mHAAA,sBAAsB,OAAA;AAKtB,gHAAA,mBAAmB,OAAA;AACnB,8GAAA,iBAAiB,OAAA;AAGnB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,2CAYsB;AAXpB,2GAAA,aAAa,OAAA;AACb,iHAAA,mBAAmB,OAAA;AAMnB,oHAAA,sBAAsB,OAAA;AACtB,wHAAA,0BAA0B,OAAA;AAC1B,qHAAA,uBAAuB,OAAA;AACvB,iHAAA,mBAAmB,OAAA;AAGrB,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,mDAW0B;AAVxB,qHAAA,mBAAmB,OAAA;AACnB,2HAAA,yBAAyB,OAAA;AAQzB,kHAAA,gBAAgB,OAAA;AAGlB,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,uBAAuB,CAC3C,MAAgC;IAEhC,MAAM,EAAE,iBAAiB,EAAE,GAAG,wDAAa,YAAY,GAAC,CAAC;IACzD,MAAM,EAAE,sBAAsB,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;IAC/D,MAAM,EAAE,aAAa,EAAE,GAAG,wDAAa,cAAc,GAAC,CAAC;IACvD,MAAM,EAAE,mBAAmB,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnE,OAAO;QACL,QAAQ;QACR,SAAS;QACT,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC;AA0BD,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;GAEG;AACU,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;GAEG;AACH,kBAAe,uBAAuB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,323 @@
+/**
+ * @wundr.io/mcp-registry - MCP Server Registry
+ *
+ * Core registry class for managing MCP server registrations,
+ * capability tracking, and server lifecycle management.
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { MCPServerRegistration, ServerRegistrationOptions, MCPCapability, ToolDefinition, ResourceDefinition, PromptDefinition, HealthStatus, HealthLevel, RegistryEvent, CapabilityCategory } from './types';
+/**
+ * Error thrown when a server is not found in the registry
+ */
+export declare class ServerNotFoundError extends Error {
+    readonly serverId: string;
+    constructor(serverId: string, message?: string);
+}
+/**
+ * Error thrown when a server is already registered
+ */
+export declare class ServerAlreadyExistsError extends Error {
+    readonly serverName: string;
+    constructor(serverName: string, message?: string);
+}
+/**
+ * Error thrown when registration validation fails
+ */
+export declare class RegistrationValidationError extends Error {
+    readonly validationErrors: readonly string[];
+    constructor(validationErrors: readonly string[], message?: string);
+}
+/**
+ * Event map for registry events
+ */
+export interface RegistryEvents {
+    'server:registered': (event: RegistryEvent) => void;
+    'server:unregistered': (event: RegistryEvent) => void;
+    'server:updated': (event: RegistryEvent) => void;
+    'server:connected': (event: RegistryEvent) => void;
+    'server:disconnected': (event: RegistryEvent) => void;
+    'server:health-changed': (event: RegistryEvent) => void;
+    'tool:added': (event: RegistryEvent) => void;
+    'tool:removed': (event: RegistryEvent) => void;
+    'capability:changed': (event: RegistryEvent) => void;
+}
+/**
+ * MCP Server Registry
+ *
+ * Manages registration, discovery, and lifecycle of MCP servers.
+ * Provides event-driven notifications for registry changes.
+ *
+ * @example
+ * ```typescript
+ * const registry = new MCPServerRegistry();
+ *
+ * // Register a server
+ * const server = await registry.register({
+ *   name: 'my-mcp-server',
+ *   version: '1.0.0',
+ *   transport: { type: 'stdio', command: 'node', args: ['server.js'] },
+ * });
+ *
+ * // Listen for events
+ * registry.on('server:registered', (event) => {
+ *   console.log('Server registered:', event.serverId);
+ * });
+ *
+ * // Find servers by capability
+ * const servers = registry.findByCapability('tools');
+ * ```
+ */
+export declare class MCPServerRegistry extends EventEmitter<RegistryEvents> {
+    /** Registered servers by ID */
+    private readonly servers;
+    /** Server name to ID mapping for uniqueness */
+    private readonly nameToId;
+    /** Tool name to server IDs mapping */
+    private readonly toolIndex;
+    /** Tag to server IDs mapping */
+    private readonly tagIndex;
+    /** Health status by server ID */
+    private readonly healthStatuses;
+    /**
+     * Creates a new MCPServerRegistry instance
+     */
+    constructor();
+    /**
+     * Register a new MCP server
+     *
+     * @param options - Server registration options
+     * @returns The registered server
+     * @throws {ServerAlreadyExistsError} If server name is already registered
+     * @throws {RegistrationValidationError} If options are invalid
+     */
+    register(options: ServerRegistrationOptions): Promise<MCPServerRegistration>;
+    /**
+     * Unregister an MCP server
+     *
+     * @param serverId - Server ID to unregister
+     * @throws {ServerNotFoundError} If server is not found
+     */
+    unregister(serverId: string): Promise<void>;
+    /**
+     * Get a server by ID
+     *
+     * @param serverId - Server ID
+     * @returns The server registration or undefined
+     */
+    get(serverId: string): MCPServerRegistration | undefined;
+    /**
+     * Get a server by name
+     *
+     * @param name - Server name
+     * @returns The server registration or undefined
+     */
+    getByName(name: string): MCPServerRegistration | undefined;
+    /**
+     * Check if a server is registered
+     *
+     * @param serverId - Server ID
+     * @returns True if server is registered
+     */
+    has(serverId: string): boolean;
+    /**
+     * Check if a server name is registered
+     *
+     * @param name - Server name
+     * @returns True if server name is registered
+     */
+    hasName(name: string): boolean;
+    /**
+     * Get all registered servers
+     *
+     * @returns Array of all registered servers
+     */
+    getAll(): readonly MCPServerRegistration[];
+    /**
+     * Get the number of registered servers
+     *
+     * @returns Server count
+     */
+    get size(): number;
+    /**
+     * Update server capabilities
+     *
+     * @param serverId - Server ID
+     * @param capabilities - New capabilities
+     * @throws {ServerNotFoundError} If server is not found
+     */
+    updateCapabilities(serverId: string, capabilities: readonly MCPCapability[]): Promise<MCPServerRegistration>;
+    /**
+     * Update server tools
+     *
+     * @param serverId - Server ID
+     * @param tools - New tools
+     * @throws {ServerNotFoundError} If server is not found
+     */
+    updateTools(serverId: string, tools: readonly ToolDefinition[]): Promise<MCPServerRegistration>;
+    /**
+     * Update server resources
+     *
+     * @param serverId - Server ID
+     * @param resources - New resources
+     * @throws {ServerNotFoundError} If server is not found
+     */
+    updateResources(serverId: string, resources: readonly ResourceDefinition[]): Promise<MCPServerRegistration>;
+    /**
+     * Update server prompts
+     *
+     * @param serverId - Server ID
+     * @param prompts - New prompts
+     * @throws {ServerNotFoundError} If server is not found
+     */
+    updatePrompts(serverId: string, prompts: readonly PromptDefinition[]): Promise<MCPServerRegistration>;
+    /**
+     * Find servers by capability category
+     *
+     * @param category - Capability category
+     * @returns Matching servers
+     */
+    findByCapability(category: CapabilityCategory): readonly MCPServerRegistration[];
+    /**
+     * Find servers that provide a specific tool
+     *
+     * @param toolName - Tool name
+     * @returns Matching servers
+     */
+    findByTool(toolName: string): readonly MCPServerRegistration[];
+    /**
+     * Find servers by tag
+     *
+     * @param tag - Tag to search for
+     * @returns Matching servers
+     */
+    findByTag(tag: string): readonly MCPServerRegistration[];
+    /**
+     * Find servers by health status
+     *
+     * @param status - Health status level
+     * @returns Matching servers
+     */
+    findByHealthStatus(status: HealthLevel): readonly MCPServerRegistration[];
+    /**
+     * Get all available tool names across all servers
+     *
+     * @returns Set of tool names
+     */
+    getAllToolNames(): ReadonlySet<string>;
+    /**
+     * Get all available tags across all servers
+     *
+     * @returns Set of tags
+     */
+    getAllTags(): ReadonlySet<string>;
+    /**
+     * Get health status for a server
+     *
+     * @param serverId - Server ID
+     * @returns Health status or undefined
+     */
+    getHealthStatus(serverId: string): HealthStatus | undefined;
+    /**
+     * Update health status for a server
+     *
+     * @param serverId - Server ID
+     * @param status - New health status
+     * @throws {ServerNotFoundError} If server is not found
+     */
+    updateHealthStatus(serverId: string, status: Partial<HealthStatus>): void;
+    /**
+     * Get all healthy servers
+     *
+     * @returns Array of healthy servers
+     */
+    getHealthyServers(): readonly MCPServerRegistration[];
+    /**
+     * Index a tool name to a server ID
+     */
+    private indexTool;
+    /**
+     * Index a tag to a server ID
+     */
+    private indexTag;
+    /**
+     * Create initial health status for a server
+     */
+    private createInitialHealthStatus;
+    /**
+     * Emit a registry event
+     */
+    private emitEvent;
+    /**
+     * Clear all registered servers
+     */
+    clear(): void;
+    /**
+     * Get registry statistics
+     *
+     * @returns Registry statistics
+     */
+    getStats(): RegistryStats;
+    /**
+     * Group servers by priority
+     */
+    private groupByPriority;
+    /**
+     * Export registry data for persistence
+     *
+     * @returns Exportable registry data
+     */
+    export(): RegistryExport;
+    /**
+     * Import registry data from persistence
+     *
+     * @param data - Registry data to import
+     */
+    import(data: RegistryExport): Promise<void>;
+}
+/**
+ * Registry statistics
+ */
+export interface RegistryStats {
+    /** Total number of registered servers */
+    readonly totalServers: number;
+    /** Total number of unique tools */
+    readonly totalTools: number;
+    /** Total number of unique tags */
+    readonly totalTags: number;
+    /** Number of healthy servers */
+    readonly healthyServers: number;
+    /** Number of degraded servers */
+    readonly degradedServers: number;
+    /** Number of unhealthy servers */
+    readonly unhealthyServers: number;
+    /** Number of servers with unknown health */
+    readonly unknownServers: number;
+    /** Server count by priority */
+    readonly serversByPriority: Record<number, number>;
+}
+/**
+ * Registry export format
+ */
+export interface RegistryExport {
+    /** All registered servers */
+    readonly servers: readonly MCPServerRegistration[];
+    /** All health statuses */
+    readonly healthStatuses: readonly HealthStatus[];
+    /** Export timestamp */
+    readonly exportedAt: Date;
+}
+/**
+ * Create a new MCPServerRegistry instance
+ *
+ * @returns New registry instance
+ *
+ * @example
+ * ```typescript
+ * const registry = createMCPServerRegistry();
+ * await registry.register({ ... });
+ * ```
+ */
+export declare function createMCPServerRegistry(): MCPServerRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

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