easy-mcp-nest 0.3.0 → 0.5.0

package/dist/core/batch/batch-executor.service.js

@@ -0,0 +1,101 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var BatchExecutorService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchExecutorService = void 0;
+const common_1 = require("@nestjs/common");
+const tool_registry_service_1 = require("../../tooling/tool-registry/tool-registry.service");
+const logger_util_1 = require("../utils/logger.util");
+const sanitize_util_1 = require("../utils/sanitize.util");
+let BatchExecutorService = class BatchExecutorService {
+    static { BatchExecutorService_1 = this; }
+    toolRegistry;
+    static MAX_BATCH_SIZE = 100;
+    static MAX_CONCURRENCY = 10;
+    constructor(toolRegistry) {
+        this.toolRegistry = toolRegistry;
+    }
+    async executeBatch(requests, cancellationToken, context, progress) {
+        if (requests.length === 0) {
+            return [];
+        }
+        if (requests.length > BatchExecutorService_1.MAX_BATCH_SIZE) {
+            logger_util_1.logger.warn("BatchExecutorService", `Batch size ${requests.length} exceeds maximum ${BatchExecutorService_1.MAX_BATCH_SIZE}`, {
+                component: "Batch",
+                batchSize: requests.length,
+                maxBatchSize: BatchExecutorService_1.MAX_BATCH_SIZE,
+            });
+            return requests.slice(0, BatchExecutorService_1.MAX_BATCH_SIZE).map((request) => ({
+                tool: request.tool,
+                success: false,
+                error: "Batch size limit exceeded",
+            }));
+        }
+        progress?.({ progress: 0, message: `Executing ${requests.length} tools...` });
+        const results = [];
+        const concurrency = Math.min(BatchExecutorService_1.MAX_CONCURRENCY, requests.length);
+        for (let i = 0; i < requests.length; i += concurrency) {
+            const batch = requests.slice(i, i + concurrency);
+            const batchPromises = batch.map(async (request, batchIndex) => {
+                const index = i + batchIndex;
+                if (cancellationToken?.isCancelled) {
+                    return {
+                        tool: request.tool,
+                        success: false,
+                        error: "Batch cancelled",
+                    };
+                }
+                try {
+                    const result = await this.toolRegistry.executeTool(request.tool, request.args, cancellationToken, context, progress
+                        ? (p) => {
+                            const baseProgress = index / requests.length;
+                            const toolProgress = p.progress / requests.length;
+                            progress({
+                                progress: baseProgress + toolProgress,
+                                message: p.message || `Executing ${request.tool}...`,
+                            });
+                        }
+                        : undefined);
+                    return {
+                        tool: request.tool,
+                        success: true,
+                        result,
+                    };
+                }
+                catch (error) {
+                    const sanitizedError = (0, sanitize_util_1.sanitizeErrorMessage)(error);
+                    logger_util_1.logger.error("BatchExecutorService", `Batch tool execution failed: ${request.tool}`, {
+                        component: "Batch",
+                        tool: request.tool,
+                        error: sanitizedError,
+                    });
+                    return {
+                        tool: request.tool,
+                        success: false,
+                        error: "Tool execution failed",
+                    };
+                }
+            });
+            const batchResults = await Promise.all(batchPromises);
+            results.push(...batchResults);
+            const currentProgress = Math.min((i + batch.length) / requests.length, 1);
+            progress?.({ progress: currentProgress, message: `Executing ${requests.length} tools...` });
+        }
+        progress?.({ progress: 1, message: `Completed ${requests.length} tools` });
+        return results;
+    }
+};
+exports.BatchExecutorService = BatchExecutorService;
+exports.BatchExecutorService = BatchExecutorService = BatchExecutorService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [tool_registry_service_1.ToolRegistryService])
+], BatchExecutorService);
+//# sourceMappingURL=batch-executor.service.js.map

package/dist/core/batch/batch-executor.service.js.map

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

package/dist/core/documentation/openapi-generator.service.d.ts

@@ -0,0 +1,13 @@
+import { ToolRegistryService } from "../../tooling/tool-registry/tool-registry.service";
+export declare class OpenApiGeneratorService {
+    private readonly toolRegistry;
+    constructor(toolRegistry: ToolRegistryService);
+    generateOpenApiSpec(info: {
+        title: string;
+        version: string;
+    }): any;
+    generateMarkdownDocs(info: {
+        title: string;
+        version: string;
+    }): string;
+}

package/dist/core/documentation/openapi-generator.service.js

@@ -0,0 +1,116 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenApiGeneratorService = void 0;
+const common_1 = require("@nestjs/common");
+const tool_registry_service_1 = require("../../tooling/tool-registry/tool-registry.service");
+let OpenApiGeneratorService = class OpenApiGeneratorService {
+    toolRegistry;
+    constructor(toolRegistry) {
+        this.toolRegistry = toolRegistry;
+    }
+    generateOpenApiSpec(info) {
+        const tools = this.toolRegistry.getToolSchemasForLLM();
+        const spec = {
+            openapi: "3.0.0",
+            info: {
+                title: info.title,
+                version: info.version,
+                description: "MCP Server API - Auto-generated from tool definitions",
+            },
+            paths: {},
+            components: {
+                schemas: {},
+            },
+        };
+        for (const tool of tools) {
+            const path = `/tools/${encodeURIComponent(tool.function.name)}`;
+            spec.paths[path] = {
+                post: {
+                    summary: tool.function.description,
+                    operationId: tool.function.name,
+                    requestBody: {
+                        required: true,
+                        content: {
+                            "application/json": {
+                                schema: tool.function.parameters,
+                            },
+                        },
+                    },
+                    responses: {
+                        "200": {
+                            description: "Tool execution result",
+                            content: {
+                                "application/json": {
+                                    schema: {
+                                        type: "object",
+                                        properties: {
+                                            content: {
+                                                type: "array",
+                                                items: {
+                                                    type: "object",
+                                                    properties: {
+                                                        type: { type: "string" },
+                                                        text: { type: "string" },
+                                                    },
+                                                },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        "400": {
+                            description: "Invalid request",
+                        },
+                        "500": {
+                            description: "Tool execution error",
+                        },
+                    },
+                },
+            };
+        }
+        return spec;
+    }
+    generateMarkdownDocs(info) {
+        const tools = this.toolRegistry.getToolSchemasForLLM();
+        const escapeMarkdown = (text) => {
+            if (!text)
+                return "";
+            return text.replace(/([\\`*_{}[\]()#+-.!])/g, "\\$1");
+        };
+        let markdown = `# ${escapeMarkdown(info.title)} API Documentation\n\n`;
+        markdown += `Version: ${escapeMarkdown(info.version)}\n\n`;
+        markdown += `## Tools\n\n`;
+        for (const tool of tools) {
+            markdown += `### ${escapeMarkdown(tool.function.name)}\n\n`;
+            markdown += `${escapeMarkdown(tool.function.description)}\n\n`;
+            if (tool.function.parameters.properties) {
+                markdown += `#### Parameters\n\n`;
+                for (const [paramName, paramDef] of Object.entries(tool.function.parameters.properties)) {
+                    markdown += `- **${escapeMarkdown(paramName)}** (${escapeMarkdown(String(paramDef.type || "any"))})`;
+                    if (paramDef.description) {
+                        markdown += `: ${escapeMarkdown(paramDef.description)}`;
+                    }
+                    markdown += `\n`;
+                }
+                markdown += `\n`;
+            }
+        }
+        return markdown;
+    }
+};
+exports.OpenApiGeneratorService = OpenApiGeneratorService;
+exports.OpenApiGeneratorService = OpenApiGeneratorService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [tool_registry_service_1.ToolRegistryService])
+], OpenApiGeneratorService);
+//# sourceMappingURL=openapi-generator.service.js.map

package/dist/core/documentation/openapi-generator.service.js.map

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

package/dist/core/errors/error-handler.interface.d.ts

@@ -0,0 +1,11 @@
+import { McpContext } from "../context/mcp-context.interface";
+import { JsonRpcError } from "../../interface/jsonrpc.interface";
+export type ErrorHandler = (error: Error, context: {
+    toolName?: string;
+    requestId?: string | number | null;
+    mcpContext?: McpContext;
+}) => JsonRpcError | Error | null;
+export interface ErrorHandlerConfig {
+    handler?: ErrorHandler;
+    logErrors?: boolean;
+}

package/dist/core/errors/error-handler.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=error-handler.interface.js.map

package/dist/core/errors/error-handler.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.interface.js","sourceRoot":"","sources":["../../../src/core/errors/error-handler.interface.ts"],"names":[],"mappings":""}

package/dist/core/health/health-check.service.d.ts

@@ -0,0 +1,33 @@
+import { ToolRegistryService } from "../../tooling/tool-registry/tool-registry.service";
+import { MetricsService } from "../observability/metrics.service";
+export interface HealthCheckResult {
+    status: "healthy" | "unhealthy" | "degraded";
+    checks: {
+        server: {
+            status: string;
+            uptime: number;
+        };
+        tools: {
+            status: string;
+            count: number;
+        };
+        metrics?: {
+            status: string;
+            activeRequests: number;
+        };
+    };
+    timestamp: string;
+}
+export declare class HealthCheckService {
+    private readonly toolRegistry;
+    private readonly metricsService?;
+    constructor(toolRegistry: ToolRegistryService, metricsService?: MetricsService | undefined);
+    checkHealth(): Promise<HealthCheckResult>;
+    checkReadiness(): Promise<{
+        ready: boolean;
+        reason?: string;
+    }>;
+    checkLiveness(): Promise<{
+        alive: boolean;
+    }>;
+}

package/dist/core/health/health-check.service.js

@@ -0,0 +1,71 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthCheckService = void 0;
+const common_1 = require("@nestjs/common");
+const tool_registry_service_1 = require("../../tooling/tool-registry/tool-registry.service");
+const metrics_service_1 = require("../observability/metrics.service");
+let HealthCheckService = class HealthCheckService {
+    toolRegistry;
+    metricsService;
+    constructor(toolRegistry, metricsService) {
+        this.toolRegistry = toolRegistry;
+        this.metricsService = metricsService;
+    }
+    async checkHealth() {
+        const tools = this.toolRegistry.getToolSchemasForLLM();
+        const toolCount = tools.length;
+        const checks = {
+            server: {
+                status: "healthy",
+                uptime: process.uptime(),
+            },
+            tools: {
+                status: toolCount > 0 ? "healthy" : "unhealthy",
+                count: toolCount,
+            },
+        };
+        if (this.metricsService) {
+            const serverMetrics = this.metricsService.getServerMetrics();
+            checks.metrics = {
+                status: serverMetrics.activeRequests < 100 ? "healthy" : "degraded",
+                activeRequests: serverMetrics.activeRequests,
+            };
+        }
+        const allHealthy = Object.values(checks).every((check) => check.status === "healthy" || check.status === "degraded");
+        return {
+            status: allHealthy ? "healthy" : "unhealthy",
+            checks,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async checkReadiness() {
+        const tools = this.toolRegistry.getToolSchemasForLLM();
+        if (tools.length === 0) {
+            return { ready: false, reason: "No tools registered" };
+        }
+        return { ready: true };
+    }
+    async checkLiveness() {
+        return { alive: true };
+    }
+};
+exports.HealthCheckService = HealthCheckService;
+exports.HealthCheckService = HealthCheckService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [tool_registry_service_1.ToolRegistryService,
+        metrics_service_1.MetricsService])
+], HealthCheckService);
+//# sourceMappingURL=health-check.service.js.map

package/dist/core/health/health-check.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.service.js","sourceRoot":"","sources":["../../../src/core/health/health-check.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8D;AAC9D,6FAAwF;AACxF,sEAAkE;AAmB3D,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAEV;IACY;IAF/B,YACmB,YAAiC,EACrB,cAA+B;QAD3C,iBAAY,GAAZ,YAAY,CAAqB;QACrB,mBAAc,GAAd,cAAc,CAAiB;IAC3D,CAAC;IAKJ,KAAK,CAAC,WAAW;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;QAE/B,MAAM,MAAM,GAAgC;YAC1C,MAAM,EAAE;gBACN,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;aACzB;YACD,KAAK,EAAE;gBACL,MAAM,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;gBAC/C,KAAK,EAAE,SAAS;aACjB;SACF,CAAC;QAEF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;YAC7D,MAAM,CAAC,OAAO,GAAG;gBACf,MAAM,EAAE,aAAa,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;gBACnE,cAAc,EAAE,aAAa,CAAC,cAAc;aAC7C,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAC5C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,CACrE,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YAC5C,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAKD,KAAK,CAAC,cAAc;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,CAAC;QACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAKD,KAAK,CAAC,aAAa;QACjB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;CACF,CAAA;AA5DY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;IAIR,WAAA,IAAA,iBAAQ,GAAE,CAAA;qCADoB,2CAAmB;QACJ,gCAAc;GAHnD,kBAAkB,CA4D9B"}

package/dist/core/mcp-server/mcp-server.service.d.ts

@@ -7,6 +7,12 @@ import { ResourceRegistryService } from "../../resources/resource-registry.servi
 import { PromptRegistryService } from "../../prompts/prompt-registry.service";
 import { ConfigHolderService } from "../../config/config-holder.service";
 import { ContextProviderService } from "../context/context-provider.service";
+import { ProgressNotifierService } from "../progress/progress-notifier.service";
+import { MetricsService } from "../observability/metrics.service";
+import { RateLimiterService } from "../rate-limiting/rate-limiter.service";
+import { RetryService } from "../resilience/retry.service";
+import { CircuitBreakerService } from "../resilience/circuit-breaker.service";
+import { BatchExecutorService } from "../batch/batch-executor.service";
 export declare class McpServerService implements OnModuleInit {
     private readonly toolRegistry;
     private readonly resourceRegistry;
@@ -15,9 +21,15 @@ export declare class McpServerService implements OnModuleInit {
     private readonly stdioGatewayService;
     private readonly configHolder;
     private readonly contextProvider;
+    private readonly progressNotifier?;
+    private readonly metricsService?;
+    private readonly rateLimiter?;
+    private readonly retryService?;
+    private readonly circuitBreaker?;
+    private readonly batchExecutor?;
     private clientIdentifier;
     private readonly cancellationTokens;
-    constructor(toolRegistry: ToolRegistryService, resourceRegistry: ResourceRegistryService, promptRegistry: PromptRegistryService, interfaceLayer: IInterfaceLayer, stdioGatewayService: StdioGatewayService, configHolder: ConfigHolderService, contextProvider: ContextProviderService);
+    constructor(toolRegistry: ToolRegistryService, resourceRegistry: ResourceRegistryService, promptRegistry: PromptRegistryService, interfaceLayer: IInterfaceLayer, stdioGatewayService: StdioGatewayService, configHolder: ConfigHolderService, contextProvider: ContextProviderService, progressNotifier?: ProgressNotifierService | undefined, metricsService?: MetricsService | undefined, rateLimiter?: RateLimiterService | undefined, retryService?: RetryService | undefined, circuitBreaker?: CircuitBreakerService | undefined, batchExecutor?: BatchExecutorService | undefined);
     private getServerInfo;
     private getActorIdentifier;
     onModuleInit(): void;
@@ -26,6 +38,7 @@ export declare class McpServerService implements OnModuleInit {
     private handleInitialize;
     private handleListTools;
     private handleCallTool;
+    private handleBatchTools;
     private handleCancelRequest;
     private handleListResources;
     private handleReadResource;