@wundr.io/mcp-registry 1.0.3

package/dist/types.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * @wundr.io/mcp-registry - Type Definitions
+ *
+ * TypeScript interfaces for MCP server registration, health status,
+ * tool results, and the Super MCP aggregator pattern.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthMonitorConfigSchema = exports.AggregatorConfigSchema = exports.CapabilityQuerySchema = exports.ToolInvocationRequestSchema = exports.ServerRegistrationOptionsSchema = exports.TransportConfigSchema = exports.TransportTypeSchema = void 0;
+const zod_1 = require("zod");
+// =============================================================================
+// Zod Schemas for Runtime Validation
+// =============================================================================
+/**
+ * Transport type schema
+ */
+exports.TransportTypeSchema = zod_1.z.enum([
+    'stdio',
+    'http',
+    'websocket',
+    'ipc',
+]);
+/**
+ * Transport configuration schema
+ */
+exports.TransportConfigSchema = zod_1.z.object({
+    type: exports.TransportTypeSchema,
+    command: zod_1.z.string().optional(),
+    args: zod_1.z.array(zod_1.z.string()).optional(),
+    env: zod_1.z.record(zod_1.z.string()).optional(),
+    cwd: zod_1.z.string().optional(),
+    url: zod_1.z.string().url().optional(),
+    timeout: zod_1.z.number().positive().optional(),
+    autoReconnect: zod_1.z.boolean().optional(),
+    reconnectDelay: zod_1.z.number().positive().optional(),
+    maxReconnectAttempts: zod_1.z.number().positive().optional(),
+});
+/**
+ * Server registration options schema
+ */
+exports.ServerRegistrationOptionsSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1),
+    version: zod_1.z.string().min(1),
+    description: zod_1.z.string().optional(),
+    transport: exports.TransportConfigSchema,
+    priority: zod_1.z.number().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional(),
+});
+/**
+ * Tool invocation request schema
+ */
+exports.ToolInvocationRequestSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1),
+    arguments: zod_1.z.record(zod_1.z.unknown()).optional(),
+    timeout: zod_1.z.number().positive().optional(),
+    preferredServer: zod_1.z.string().optional(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional(),
+});
+/**
+ * Capability query schema
+ */
+exports.CapabilityQuerySchema = zod_1.z.object({
+    category: zod_1.z
+        .enum([
+        'tools',
+        'resources',
+        'prompts',
+        'logging',
+        'sampling',
+        'experimental',
+    ])
+        .optional(),
+    capabilities: zod_1.z.array(zod_1.z.string()).optional(),
+    tools: zod_1.z.array(zod_1.z.string()).optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    minPriority: zod_1.z.number().optional(),
+    healthStatus: zod_1.z
+        .union([
+        zod_1.z.enum(['healthy', 'degraded', 'unhealthy', 'unknown']),
+        zod_1.z.array(zod_1.z.enum(['healthy', 'degraded', 'unhealthy', 'unknown'])),
+    ])
+        .optional(),
+});
+/**
+ * Aggregator configuration schema
+ */
+exports.AggregatorConfigSchema = zod_1.z.object({
+    defaultStrategy: zod_1.z
+        .enum([
+        'priority',
+        'round-robin',
+        'least-latency',
+        'random',
+        'health-aware',
+    ])
+        .optional(),
+    requestTimeout: zod_1.z.number().positive().optional(),
+    enableRetries: zod_1.z.boolean().optional(),
+    maxRetries: zod_1.z.number().positive().optional(),
+    retryDelay: zod_1.z.number().positive().optional(),
+    enableCircuitBreaker: zod_1.z.boolean().optional(),
+    circuitBreakerThreshold: zod_1.z.number().positive().optional(),
+    circuitBreakerResetTimeout: zod_1.z.number().positive().optional(),
+});
+/**
+ * Health monitor configuration schema
+ */
+exports.HealthMonitorConfigSchema = zod_1.z.object({
+    checkInterval: zod_1.z.number().positive().optional(),
+    pingTimeout: zod_1.z.number().positive().optional(),
+    failureThreshold: zod_1.z.number().positive().optional(),
+    recoveryThreshold: zod_1.z.number().positive().optional(),
+    degradedLatencyThreshold: zod_1.z.number().positive().optional(),
+    autoReconnect: zod_1.z.boolean().optional(),
+    maxReconnectAttempts: zod_1.z.number().positive().optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@wundr.io/mcp-registry",
+  "version": "1.0.3",
+  "description": "MCP Server registry and discovery with Super MCP aggregator pattern for unified tool routing",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "eventemitter3": "^5.0.1",
+    "uuid": "^11.0.3",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0",
+    "@types/uuid": "^10.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.1",
+    "typescript": "^5.2.2",
+    "eslint": "^8.57.1",
+    "prettier": "^3.3.3"
+  },
+  "peerDependencies": {
+    "@wundr.io/mcp-server": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@wundr.io/mcp-server": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "registry",
+    "discovery",
+    "aggregator",
+    "super-mcp",
+    "claude-code",
+    "wundr"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adapticai/wundr.git",
+    "directory": "packages/@wundr/mcp-registry"
+  },
+  "bugs": {
+    "url": "https://github.com/adapticai/wundr/issues"
+  },
+  "homepage": "https://wundr.io",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": ["dist", "README.md"],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}