@claude-flow/mcp 3.0.0-alpha.1

package/dist/sampling.js

@@ -0,0 +1,268 @@
+/**
+ * @claude-flow/mcp - Sampling (Server-Initiated LLM)
+ *
+ * MCP 2025-11-25 compliant sampling for server-initiated LLM calls
+ */
+import { EventEmitter } from 'events';
+const DEFAULT_CONFIG = {
+    defaultModelPreferences: {
+        intelligencePriority: 0.5,
+        speedPriority: 0.3,
+        costPriority: 0.2,
+    },
+    maxTokensLimit: 4096,
+    defaultTemperature: 0.7,
+    timeout: 30000,
+    enableLogging: true,
+};
+export class SamplingManager extends EventEmitter {
+    logger;
+    config;
+    providers = new Map();
+    defaultProvider;
+    requestCount = 0;
+    totalTokens = 0;
+    constructor(logger, config = {}) {
+        super();
+        this.logger = logger;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Register an LLM provider
+     */
+    registerProvider(provider, isDefault = false) {
+        this.providers.set(provider.name, provider);
+        if (isDefault || !this.defaultProvider) {
+            this.defaultProvider = provider.name;
+        }
+        this.logger.info('LLM provider registered', { name: provider.name, isDefault });
+        this.emit('provider:registered', { name: provider.name });
+    }
+    /**
+     * Unregister a provider
+     */
+    unregisterProvider(name) {
+        const removed = this.providers.delete(name);
+        if (removed && this.defaultProvider === name) {
+            this.defaultProvider = this.providers.keys().next().value;
+        }
+        return removed;
+    }
+    /**
+     * Create a message (sampling/createMessage)
+     */
+    async createMessage(request, context) {
+        const startTime = Date.now();
+        this.requestCount++;
+        // Validate request
+        this.validateRequest(request);
+        // Select provider
+        const provider = this.selectProvider(request.modelPreferences);
+        if (!provider) {
+            throw new Error('No LLM provider available');
+        }
+        // Apply defaults
+        const fullRequest = this.applyDefaults(request);
+        if (this.config.enableLogging) {
+            this.logger.debug('Sampling request', {
+                provider: provider.name,
+                messageCount: request.messages.length,
+                maxTokens: fullRequest.maxTokens,
+                sessionId: context?.sessionId,
+            });
+        }
+        this.emit('sampling:start', { provider: provider.name, context });
+        try {
+            // Call provider with timeout
+            const result = await this.callWithTimeout(provider.createMessage(fullRequest), this.config.timeout);
+            const duration = Date.now() - startTime;
+            if (this.config.enableLogging) {
+                this.logger.info('Sampling complete', {
+                    provider: provider.name,
+                    duration: `${duration}ms`,
+                    stopReason: result.stopReason,
+                });
+            }
+            this.emit('sampling:complete', {
+                provider: provider.name,
+                duration,
+                result,
+                context,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.logger.error('Sampling failed', {
+                provider: provider.name,
+                duration: `${duration}ms`,
+                error,
+            });
+            this.emit('sampling:error', {
+                provider: provider.name,
+                duration,
+                error,
+                context,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Check if sampling is available
+     */
+    async isAvailable() {
+        if (this.providers.size === 0) {
+            return false;
+        }
+        for (const provider of this.providers.values()) {
+            if (await provider.isAvailable()) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get available providers
+     */
+    getProviders() {
+        return Array.from(this.providers.keys());
+    }
+    /**
+     * Get stats
+     */
+    getStats() {
+        return {
+            requestCount: this.requestCount,
+            totalTokens: this.totalTokens,
+            providerCount: this.providers.size,
+            defaultProvider: this.defaultProvider,
+        };
+    }
+    /**
+     * Validate sampling request
+     */
+    validateRequest(request) {
+        if (!request.messages || request.messages.length === 0) {
+            throw new Error('Messages are required');
+        }
+        if (request.maxTokens > this.config.maxTokensLimit) {
+            throw new Error(`maxTokens exceeds limit of ${this.config.maxTokensLimit}`);
+        }
+        if (request.temperature !== undefined && (request.temperature < 0 || request.temperature > 2)) {
+            throw new Error('Temperature must be between 0 and 2');
+        }
+    }
+    /**
+     * Select provider based on preferences
+     */
+    selectProvider(preferences) {
+        // If hints provided, try to find matching provider
+        if (preferences?.hints) {
+            for (const hint of preferences.hints) {
+                if (hint.name && this.providers.has(hint.name)) {
+                    return this.providers.get(hint.name);
+                }
+            }
+        }
+        // Use default provider
+        if (this.defaultProvider) {
+            return this.providers.get(this.defaultProvider);
+        }
+        // Return first available
+        return this.providers.values().next().value;
+    }
+    /**
+     * Apply default values to request
+     */
+    applyDefaults(request) {
+        return {
+            ...request,
+            modelPreferences: request.modelPreferences || this.config.defaultModelPreferences,
+            temperature: request.temperature ?? this.config.defaultTemperature,
+            maxTokens: Math.min(request.maxTokens, this.config.maxTokensLimit),
+        };
+    }
+    /**
+     * Call with timeout
+     */
+    async callWithTimeout(promise, timeout) {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                setTimeout(() => reject(new Error('Sampling timeout')), timeout);
+            }),
+        ]);
+    }
+}
+export function createSamplingManager(logger, config) {
+    return new SamplingManager(logger, config);
+}
+/**
+ * Create a mock LLM provider for testing
+ */
+export function createMockProvider(name = 'mock') {
+    return {
+        name,
+        async createMessage(request) {
+            // Simulate processing time
+            await new Promise((r) => setTimeout(r, 100));
+            return {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: `Mock response to: ${JSON.stringify(request.messages[0]?.content)}`,
+                },
+                model: `${name}-model`,
+                stopReason: 'endTurn',
+            };
+        },
+        async isAvailable() {
+            return true;
+        },
+    };
+}
+/**
+ * Create an Anthropic provider (requires API key)
+ */
+export function createAnthropicProvider(apiKey) {
+    return {
+        name: 'anthropic',
+        async createMessage(request) {
+            const response = await fetch('https://api.anthropic.com/v1/messages', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-api-key': apiKey,
+                    'anthropic-version': '2023-06-01',
+                },
+                body: JSON.stringify({
+                    model: 'claude-3-haiku-20240307',
+                    max_tokens: request.maxTokens,
+                    temperature: request.temperature,
+                    system: request.systemPrompt,
+                    messages: request.messages.map((m) => ({
+                        role: m.role,
+                        content: m.content.type === 'text' ? m.content.text : m.content,
+                    })),
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Anthropic API error: ${response.status}`);
+            }
+            const data = await response.json();
+            return {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: data.content[0]?.text || '',
+                },
+                model: data.model,
+                stopReason: data.stop_reason === 'end_turn' ? 'endTurn' : 'maxTokens',
+            };
+        },
+        async isAvailable() {
+            return !!apiKey;
+        },
+    };
+}
+//# sourceMappingURL=sampling.js.map

package/dist/sampling.js.map

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

package/dist/schema-validator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @claude-flow/mcp - JSON Schema Validator
+ *
+ * Lightweight JSON Schema validation for tool inputs
+ * Implements JSON Schema Draft 2020-12 subset
+ */
+import type { JSONSchema } from './types.js';
+export interface ValidationError {
+    path: string;
+    message: string;
+    keyword: string;
+    params?: Record<string, unknown>;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Validate data against JSON Schema
+ */
+export declare function validateSchema(data: unknown, schema: JSONSchema, path?: string): ValidationResult;
+/**
+ * Format validation errors for display
+ */
+export declare function formatValidationErrors(errors: ValidationError[]): string;
+/**
+ * Create a validator function for a specific schema
+ */
+export declare function createValidator(schema: JSONSchema): (data: unknown) => ValidationResult;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../src/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,UAAU,EAClB,IAAI,GAAE,MAAW,GAChB,gBAAgB,CAuJlB;AAqBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,gBAAgB,CAEvF"}

package/dist/schema-validator.js

@@ -0,0 +1,182 @@
+/**
+ * @claude-flow/mcp - JSON Schema Validator
+ *
+ * Lightweight JSON Schema validation for tool inputs
+ * Implements JSON Schema Draft 2020-12 subset
+ */
+/**
+ * Validate data against JSON Schema
+ */
+export function validateSchema(data, schema, path = '') {
+    const errors = [];
+    // Type validation
+    if (schema.type) {
+        const typeValid = validateType(data, schema.type);
+        if (!typeValid) {
+            errors.push({
+                path: path || 'root',
+                message: `Expected type "${schema.type}", got "${typeof data}"`,
+                keyword: 'type',
+                params: { expected: schema.type, actual: typeof data },
+            });
+            return { valid: false, errors };
+        }
+    }
+    // Null check
+    if (data === null || data === undefined) {
+        if (schema.type && schema.type !== 'null') {
+            errors.push({
+                path: path || 'root',
+                message: 'Value cannot be null or undefined',
+                keyword: 'type',
+            });
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // String validations
+    if (schema.type === 'string' && typeof data === 'string') {
+        if (schema.minLength !== undefined && data.length < schema.minLength) {
+            errors.push({
+                path,
+                message: `String length must be >= ${schema.minLength}`,
+                keyword: 'minLength',
+                params: { limit: schema.minLength, actual: data.length },
+            });
+        }
+        if (schema.maxLength !== undefined && data.length > schema.maxLength) {
+            errors.push({
+                path,
+                message: `String length must be <= ${schema.maxLength}`,
+                keyword: 'maxLength',
+                params: { limit: schema.maxLength, actual: data.length },
+            });
+        }
+        if (schema.pattern) {
+            const regex = new RegExp(schema.pattern);
+            if (!regex.test(data)) {
+                errors.push({
+                    path,
+                    message: `String must match pattern "${schema.pattern}"`,
+                    keyword: 'pattern',
+                    params: { pattern: schema.pattern },
+                });
+            }
+        }
+        if (schema.enum && !schema.enum.includes(data)) {
+            errors.push({
+                path,
+                message: `Value must be one of: ${schema.enum.join(', ')}`,
+                keyword: 'enum',
+                params: { allowedValues: schema.enum },
+            });
+        }
+    }
+    // Number validations
+    if ((schema.type === 'number' || schema.type === 'integer') && typeof data === 'number') {
+        if (schema.type === 'integer' && !Number.isInteger(data)) {
+            errors.push({
+                path,
+                message: 'Value must be an integer',
+                keyword: 'type',
+            });
+        }
+        if (schema.minimum !== undefined && data < schema.minimum) {
+            errors.push({
+                path,
+                message: `Value must be >= ${schema.minimum}`,
+                keyword: 'minimum',
+                params: { limit: schema.minimum, actual: data },
+            });
+        }
+        if (schema.maximum !== undefined && data > schema.maximum) {
+            errors.push({
+                path,
+                message: `Value must be <= ${schema.maximum}`,
+                keyword: 'maximum',
+                params: { limit: schema.maximum, actual: data },
+            });
+        }
+    }
+    // Array validations
+    if (schema.type === 'array' && Array.isArray(data)) {
+        if (schema.items) {
+            for (let i = 0; i < data.length; i++) {
+                const itemResult = validateSchema(data[i], schema.items, `${path}[${i}]`);
+                errors.push(...itemResult.errors);
+            }
+        }
+    }
+    // Object validations
+    if (schema.type === 'object' && typeof data === 'object' && !Array.isArray(data)) {
+        const obj = data;
+        // Required properties
+        if (schema.required) {
+            for (const requiredProp of schema.required) {
+                if (!(requiredProp in obj)) {
+                    errors.push({
+                        path: path ? `${path}.${requiredProp}` : requiredProp,
+                        message: `Required property "${requiredProp}" is missing`,
+                        keyword: 'required',
+                        params: { missingProperty: requiredProp },
+                    });
+                }
+            }
+        }
+        // Property validations
+        if (schema.properties) {
+            for (const [propName, propSchema] of Object.entries(schema.properties)) {
+                if (propName in obj) {
+                    const propPath = path ? `${path}.${propName}` : propName;
+                    const propResult = validateSchema(obj[propName], propSchema, propPath);
+                    errors.push(...propResult.errors);
+                }
+            }
+        }
+        // Additional properties check
+        if (schema.additionalProperties === false && schema.properties) {
+            const allowedProps = new Set(Object.keys(schema.properties));
+            for (const propName of Object.keys(obj)) {
+                if (!allowedProps.has(propName)) {
+                    errors.push({
+                        path: path ? `${path}.${propName}` : propName,
+                        message: `Additional property "${propName}" is not allowed`,
+                        keyword: 'additionalProperties',
+                        params: { additionalProperty: propName },
+                    });
+                }
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validate type
+ */
+function validateType(data, expectedType) {
+    if (expectedType === 'null') {
+        return data === null;
+    }
+    if (expectedType === 'array') {
+        return Array.isArray(data);
+    }
+    if (expectedType === 'integer') {
+        return typeof data === 'number' && Number.isInteger(data);
+    }
+    if (expectedType === 'object') {
+        return typeof data === 'object' && data !== null && !Array.isArray(data);
+    }
+    return typeof data === expectedType;
+}
+/**
+ * Format validation errors for display
+ */
+export function formatValidationErrors(errors) {
+    return errors.map((e) => `${e.path}: ${e.message}`).join('; ');
+}
+/**
+ * Create a validator function for a specific schema
+ */
+export function createValidator(schema) {
+    return (data) => validateSchema(data, schema);
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/schema-validator.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @claude-flow/mcp - MCP Server
+ *
+ * High-performance MCP server implementation
+ */
+import { EventEmitter } from 'events';
+import type { MCPServerConfig, MCPSession, MCPTool, MCPServerMetrics, ILogger } from './types.js';
+import { ResourceRegistry } from './resource-registry.js';
+import { PromptRegistry } from './prompt-registry.js';
+import { TaskManager } from './task-manager.js';
+import { RateLimiter } from './rate-limiter.js';
+import { SamplingManager, type LLMProvider } from './sampling.js';
+export interface IMCPServer {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    registerTool(tool: MCPTool): boolean;
+    registerTools(tools: MCPTool[]): {
+        registered: number;
+        failed: string[];
+    };
+    getHealthStatus(): Promise<{
+        healthy: boolean;
+        error?: string;
+        metrics?: Record<string, number>;
+    }>;
+    getMetrics(): MCPServerMetrics;
+    getSessions(): MCPSession[];
+    getSession(sessionId: string): MCPSession | undefined;
+    terminateSession(sessionId: string): boolean;
+}
+export declare class MCPServer extends EventEmitter implements IMCPServer {
+    private readonly logger;
+    private readonly orchestrator?;
+    private readonly swarmCoordinator?;
+    private readonly config;
+    private readonly toolRegistry;
+    private readonly sessionManager;
+    private readonly resourceRegistry;
+    private readonly promptRegistry;
+    private readonly taskManager;
+    private readonly connectionPool?;
+    private readonly transportManager;
+    private readonly rateLimiter;
+    private readonly samplingManager;
+    private transport?;
+    private running;
+    private startTime?;
+    private startupDuration?;
+    private currentSession?;
+    private resourceSubscriptions;
+    private readonly serverInfo;
+    private readonly protocolVersion;
+    private capabilities;
+    private requestStats;
+    constructor(config: Partial<MCPServerConfig>, logger: ILogger, orchestrator?: unknown | undefined, swarmCoordinator?: unknown | undefined);
+    /**
+     * Get resource registry for external registration
+     */
+    getResourceRegistry(): ResourceRegistry;
+    /**
+     * Get prompt registry for external registration
+     */
+    getPromptRegistry(): PromptRegistry;
+    /**
+     * Get task manager for async operations
+     */
+    getTaskManager(): TaskManager;
+    /**
+     * Get rate limiter for configuration
+     */
+    getRateLimiter(): RateLimiter;
+    /**
+     * Get sampling manager for LLM provider registration
+     */
+    getSamplingManager(): SamplingManager;
+    /**
+     * Register an LLM provider for sampling
+     */
+    registerLLMProvider(provider: LLMProvider, isDefault?: boolean): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    registerTool(tool: MCPTool): boolean;
+    registerTools(tools: MCPTool[]): {
+        registered: number;
+        failed: string[];
+    };
+    unregisterTool(name: string): boolean;
+    getHealthStatus(): Promise<{
+        healthy: boolean;
+        error?: string;
+        metrics?: Record<string, number>;
+    }>;
+    getMetrics(): MCPServerMetrics;
+    getSessions(): MCPSession[];
+    getSession(sessionId: string): MCPSession | undefined;
+    terminateSession(sessionId: string): boolean;
+    private handleRequest;
+    private handleNotification;
+    private handleInitialize;
+    private routeRequest;
+    private handleToolsList;
+    private handleToolsCall;
+    private handleToolExecution;
+    private handleResourcesList;
+    private handleResourcesRead;
+    private handleResourcesSubscribe;
+    private handleResourcesUnsubscribe;
+    private handlePromptsList;
+    private handlePromptsGet;
+    private handleTasksStatus;
+    private handleTasksCancel;
+    private handleCompletion;
+    private handleLoggingSetLevel;
+    private handleSamplingCreateMessage;
+    private sendNotification;
+    private getOrCreateSession;
+    private createErrorResponse;
+    private registerBuiltInTools;
+    private setupEventHandlers;
+}
+export declare function createMCPServer(config: Partial<MCPServerConfig>, logger: ILogger, orchestrator?: unknown, swarmCoordinator?: unknown): MCPServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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