easy-mcp-nest 0.2.1 → 0.4.0

package/README.md

@@ -29,12 +29,26 @@ EasyMCP requires the following peer dependencies to be installed:
 - `@nestjs/core` ^11.0.1
 - `@nestjs/platform-express` ^11.0.1
 
-Install them with:
+**Optional peer dependencies** (for specific features):
+- `express` ^4.18.0 (for Express adapter)
+- `zod` ^3.22.0 (for TypeScript-first validation)
+
+Install required dependencies with:
 
 ```bash
 npm install @nestjs/common@^11.0.1 @nestjs/core@^11.0.1 @nestjs/platform-express@^11.0.1
 ```
 
+Install optional dependencies as needed:
+
+```bash
+# For Express adapter
+npm install express@^4.18.0
+
+# For Zod validation
+npm install zod@^3.22.0
+```
+
 ## Quick Start
 
 ```typescript
@@ -193,6 +207,7 @@ process.on('SIGINT', async () => {
 
 ### Types
 
+**Core Types:**
 - `McpConfig` - Main configuration interface
 - `ToolRegistrationInput` - Tool definition interface
 - `ServerInfo` - Optional server information
@@ -207,6 +222,13 @@ process.on('SIGINT', async () => {
 - `VERSION`, `PACKAGE_NAME`, `getVersion()`, `getPackageName()` - Version information utilities
 - `INTERFACE_LAYER_TOKEN` - Token for accessing the interface layer (advanced use cases)
 
+**New Feature Types:**
+- `McpContext` - Context interface for user information
+- `CreateMcpExpressRouterOptions` - Express adapter options
+- `OAuthProviderConfig`, `OAuthConfig` - OAuth configuration
+- `CreateMcpServerOptions` - Standalone server options
+- `StandaloneTransport` - Transport type ('stdio' | 'http')
+
 ## Architecture
 
 EasyMCP uses a simplified architecture for standard MCP servers:
@@ -245,11 +267,11 @@ EasyMCP implements the following MCP protocol methods:
   - Validates client protocol version
   - Returns server capabilities (currently supports tools)
   - Returns server information (name and version)
-  
+
 - **`tools/list`** - Returns all registered tools with their JSON Schema 2020-12 definitions
   - Returns array of tool definitions in MCP format
   - Each tool includes name, description, inputSchema, and optional icon
-  
+
 - **`tools/call`** - Executes a tool with provided arguments and returns the result
   - Validates tool arguments against JSON Schema 2020-12
   - Executes tool function
@@ -310,7 +332,7 @@ This enables the MCP-specified Content-Length header format, which some clients
 
 ### Limitations
 
-- **Transport**: Currently only stdio transport is supported. WebSocket and HTTP transports are not available.
+- **Transport**: stdio transport is fully supported. HTTP transport is available via Express adapter. WebSocket transport is not available.
 - **Protocol Version**: Only protocol version 2025-11-25 is supported. Older or newer versions will be rejected.
 - **Resources Subscribe/Unsubscribe**: Basic resource subscription is not yet implemented (resources/list and resources/read are supported)
 
@@ -330,10 +352,10 @@ EasyMCP provides comprehensive error handling with custom error classes and clea
 ### Error Handling Examples
 
 ```typescript
-import { 
-  EasyMCP, 
-  ConfigurationError, 
-  ToolExecutionError, 
+import {
+  EasyMCP,
+  ConfigurationError,
+  ToolExecutionError,
   ToolNotFoundError
 } from 'easy-mcp-nest';
 
@@ -438,6 +460,318 @@ Debug mode provides detailed information about:
 
 **Note**: The `DEBUG` environment variable accepts either `'1'` or `'true'` (case-sensitive) to enable debug logging.
 
+## High-Value Framework Features
+
+EasyMCP provides production-ready features out of the box:
+
+### 1. Declarative Tool Registration with @McpTool
+
+Define tools using decorators for automatic discovery and registration:
+
+```typescript
+import { McpTool, McpParam, McpContext } from 'easy-mcp-nest';
+import { z } from 'zod';
+
+const CreateBuildingSchema = z.object({
+  name: z.string(),
+  address: z.string(),
+});
+
+@McpTool({
+  name: 'create_building',
+  description: 'Creates a new building',
+  requiredScopes: ['building:write'],
+  rateLimit: { max: 10, window: '1m' },
+  retry: { maxAttempts: 3, backoff: 'exponential' }
+})
+async createBuilding(
+  @McpParam(CreateBuildingSchema) params: z.infer<typeof CreateBuildingSchema>,
+  @McpContext() context: McpContext
+) {
+  return this.service.createBuilding(context.userId, params);
+}
+```
+
+### 2. Automatic Scope Checking
+
+Declarative scope validation - framework handles security automatically:
+
+```typescript
+@McpTool({
+  name: 'delete_building',
+  requiredScopes: ['building:write', 'building:delete']
+})
+```
+
+### 3. Progress Notifications
+
+Report progress for long-running operations:
+
+```typescript
+@McpTool({ name: 'analyze_debts' })
+async analyzeDebts(
+  args: any,
+  cancellationToken?: CancellationToken,
+  context?: McpContext,
+  progress?: ProgressCallback
+) {
+  progress?.({ progress: 0.1, message: 'Fetching payment data...' });
+  // ... work ...
+  progress?.({ progress: 0.5, message: 'Processing 5/10 apartments...' });
+  // ... work ...
+  progress?.({ progress: 1.0, message: 'Complete!' });
+}
+```
+
+### 4. Built-in Observability
+
+Automatic metrics collection and Prometheus-compatible endpoints:
+
+- Tool execution count
+- Average execution time
+- Error rate by tool
+- Request tracing
+- Performance monitoring
+
+Access metrics at `/metrics` endpoint (Prometheus format).
+
+### 5. Rate Limiting
+
+Per-tool rate limiting with configurable limits:
+
+```typescript
+@McpTool({
+  name: 'create_building',
+  rateLimit: { max: 10, window: '1m' } // 10 requests per minute
+})
+```
+
+### 6. Retry Logic
+
+Automatic retry with exponential backoff:
+
+```typescript
+@McpTool({
+  name: 'create_building',
+  retry: {
+    maxAttempts: 3,
+    backoff: 'exponential',
+    initialDelay: 100,
+    maxDelay: 10000
+  }
+})
+```
+
+### 7. Circuit Breaker
+
+Automatic circuit breaking when error rate exceeds threshold:
+
+- Prevents overwhelming system during outages
+- Automatic recovery with half-open state
+- Per-tool circuit breakers
+
+### 8. Error Handling Hooks
+
+Centralized error handling with decorators:
+
+```typescript
+@McpErrorHandler((error, context) => {
+  logErrorSecurely('MCP error', error, context);
+  return sanitizeError(error);
+})
+export class MyErrorHandler {}
+```
+
+### 9. Middleware System
+
+Pre/post execution hooks for cross-cutting concerns:
+
+```typescript
+@McpMiddleware(async (req, context, next) => {
+  const start = Date.now();
+  const result = await next();
+  logPerformance(req.method, Date.now() - start);
+  return result;
+})
+export class PerformanceMiddleware {}
+```
+
+### 10. Batch Tool Execution
+
+Execute multiple tools in parallel:
+
+```typescript
+// JSON-RPC request
+{
+  "jsonrpc": "2.0",
+  "method": "tools/batch",
+  "params": {
+    "tools": [
+      { "name": "create_building", "arguments": {...} },
+      { "name": "add_apartment", "arguments": {...} }
+    ]
+  }
+}
+```
+
+### 11. Health Check Endpoints
+
+Production-ready health checks:
+
+- `GET /health` - Basic health check
+- `GET /health/ready` - Readiness probe
+- `GET /health/live` - Liveness probe
+- `GET /metrics` - Prometheus metrics
+
+### 12. Testing Utilities
+
+Easy testing with test helpers:
+
+```typescript
+import { createMcpTestApp, mockMcpContext } from 'easy-mcp-nest';
+
+const app = await createMcpTestApp([BuildingTools]);
+const context = mockMcpContext({ userId: '123', scopes: ['read', 'write'] });
+const result = await app.callTool('create_building', params, context);
+await app.close();
+```
+
+## New Features
+
+### Express Adapter
+
+Use EasyMCP in Express applications without requiring NestJS for the HTTP layer:
+
+```typescript
+import express from 'express';
+import { createMcpExpressRouter } from 'easy-mcp-nest';
+
+const app = express();
+app.use(express.json());
+
+const mcpRouter = createMcpExpressRouter({
+  tools: [BuildingTools, PaymentTools],
+  resources: [BuildingResources],
+  auth: mcpAuthMiddleware, // Optional
+});
+
+app.use('/mcp', mcpRouter);
+app.listen(3000);
+```
+
+### Context Injection
+
+Inject user context into tools using the `@McpContext()` decorator:
+
+```typescript
+import { McpContext, McpContextDecorator } from 'easy-mcp-nest';
+
+@McpTool({ name: 'create_building' })
+async createBuilding(
+  @McpParam() params: CreateBuildingDto,
+  @McpContextDecorator() context: McpContext
+) {
+  return this.service.createBuilding(context.userId, params);
+}
+```
+
+### Factory Pattern Support
+
+Use factory functions instead of dependency injection:
+
+```typescript
+import { McpService } from 'easy-mcp-nest';
+
+@McpTool({ name: 'create_building' })
+export class BuildingTools {
+  constructor(
+    @McpService(() => getBuildingService())
+    private buildingService: BuildingService
+  ) {}
+}
+```
+
+### OAuth Integration
+
+Standardize OAuth integration across MCP servers:
+
+```typescript
+import { createOAuthMiddleware, OAuthProviderConfig } from 'easy-mcp-nest';
+
+const oauthConfig: OAuthProviderConfig = {
+  provider: 'custom',
+  validateToken: async (token) => {
+    // Validate token and return payload
+    return jwt.verify(token, secret);
+  },
+  extractContext: (payload) => ({
+    userId: payload.sub,
+    scopes: payload.scopes,
+    buildingIds: payload.buildingIds,
+  }),
+};
+
+const oauthMiddleware = createOAuthMiddleware(oauthProviderService);
+app.use('/mcp', oauthMiddleware, mcpRouter);
+```
+
+### TypeScript-First Validation with Zod
+
+Use Zod schemas for type-safe validation:
+
+```typescript
+import { z } from 'zod';
+import { McpParam } from 'easy-mcp-nest';
+
+const CreateBuildingSchema = z.object({
+  name: z.string(),
+  address: z.string(),
+  floors: z.number().int().min(1).max(100),
+});
+
+@McpTool({ name: 'create_building' })
+async createBuilding(
+  @McpParam(CreateBuildingSchema) params: z.infer<typeof CreateBuildingSchema>
+) {
+  // params is fully typed and validated
+  return this.service.createBuilding(params);
+}
+```
+
+### Standalone Mode
+
+Use EasyMCP without NestJS:
+
+```typescript
+import { createMcpServer } from 'easy-mcp-nest';
+
+const server = createMcpServer({
+  tools: [BuildingTools, PaymentTools],
+  resources: [BuildingResources],
+  transport: 'http', // or 'stdio'
+  auth: validateMcpToken, // Optional
+  port: 3000,
+});
+
+await server.start();
+```
+
+### Testing Utilities
+
+Test MCP tools easily:
+
+```typescript
+import { createMcpTestApp, mockMcpContext } from 'easy-mcp-nest';
+
+const app = await createMcpTestApp([BuildingTools]);
+const context = mockMcpContext({
+  userId: '123',
+  scopes: ['read', 'write'],
+});
+const result = await app.callTool('create_building', params, context);
+await app.close();
+```
+
 ## Examples
 
 See the `examples/` directory for complete working examples.

package/dist/EasyMCP.js

@@ -35,7 +35,6 @@ class EasyMCP {
                     toolRegistry.registerToolFromConfig(tool);
                 }
                 catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : String(error);
                     const sanitizedToolName = (0, sanitize_util_1.sanitizeName)(tool.name);
                     logger_util_1.logger.error("EasyMCP", "Failed to register tool", {
                         component: "EasyMCP",
@@ -57,7 +56,6 @@ class EasyMCP {
                     resourceRegistry.registerResourceFromConfig(resource);
                 }
                 catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : String(error);
                     const sanitizedUri = (0, sanitize_util_1.sanitizeUri)(resource.uri);
                     logger_util_1.logger.error("EasyMCP", "Failed to register resource", {
                         component: "EasyMCP",
@@ -79,7 +77,6 @@ class EasyMCP {
                     promptRegistry.registerPromptFromConfig(prompt);
                 }
                 catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : String(error);
                     const sanitizedPromptName = (0, sanitize_util_1.sanitizeName)(prompt.name);
                     logger_util_1.logger.error("EasyMCP", "Failed to register prompt", {
                         component: "EasyMCP",

package/dist/EasyMCP.js.map

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

package/dist/adapters/express/express-adapter.d.ts

@@ -0,0 +1,3 @@
+import { Router } from "express";
+import { CreateMcpExpressRouterOptions } from "./types";
+export declare function createMcpExpressRouter(options: CreateMcpExpressRouterOptions): Router;

package/dist/adapters/express/express-adapter.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpExpressRouter = createMcpExpressRouter;
+const express_1 = require("express");
+const constants_1 = require("../../config/constants");
+const EasyMCP_1 = require("../../EasyMCP");
+const http_gateway_service_1 = require("./http-gateway.service");
+const logger_util_1 = require("../../core/utils/logger.util");
+const sanitize_util_1 = require("../../core/utils/sanitize.util");
+const mcp_server_service_1 = require("../../core/mcp-server/mcp-server.service");
+const oauth_provider_service_1 = require("../../auth/oauth/oauth-provider.service");
+const oauth_middleware_1 = require("../../auth/oauth/oauth-middleware");
+function createMcpExpressRouter(options) {
+    const router = (0, express_1.Router)();
+    const pathPrefix = options.pathPrefix || "/mcp";
+    const tools = (options.tools || []).map((tool) => {
+        if (tool && typeof tool === "object" && "name" in tool && "function" in tool) {
+            return tool;
+        }
+        if (typeof tool === "function") {
+            throw new Error("Class-based tools are not directly supported in createMcpExpressRouter. Please convert them to ToolRegistrationInput format or register them via NestJS modules.");
+        }
+        throw new Error("Tools must be in ToolRegistrationInput format or a class constructor. Use the config-based or decorator-based approach.");
+    });
+    const config = {
+        tools,
+        resources: options.resources || [],
+        prompts: options.prompts || [],
+        serverInfo: options.serverInfo,
+    };
+    let mcpServerService = null;
+    let httpGateway = null;
+    const initPromise = (async () => {
+        await EasyMCP_1.EasyMCP.initialize(config);
+        const appContext = EasyMCP_1.EasyMCP.app;
+        mcpServerService = appContext.get(mcp_server_service_1.McpServerService);
+        httpGateway = new http_gateway_service_1.HttpGatewayService();
+        if (mcpServerService) {
+            httpGateway.setMcpServerService(mcpServerService);
+        }
+    })();
+    router.use(async (req, res, next) => {
+        try {
+            await initPromise;
+            next();
+        }
+        catch (error) {
+            logger_util_1.logger.error("ExpressAdapter", "Failed to initialize EasyMCP", {
+                error: (0, sanitize_util_1.sanitizeErrorMessage)(error),
+            });
+            res.status(500).json({
+                jsonrpc: "2.0",
+                id: null,
+                error: {
+                    code: -32603,
+                    message: "Internal error",
+                },
+            });
+        }
+    });
+    if (options.auth) {
+        router.use(options.auth);
+    }
+    else if (options.oauth) {
+        const oauthProvider = new oauth_provider_service_1.OAuthProviderService();
+        oauthProvider.setConfig(options.oauth);
+        router.use((0, oauth_middleware_1.createOAuthMiddleware)(oauthProvider));
+    }
+    const extractContext = (req) => {
+        if (req.mcpContext) {
+            return req.mcpContext;
+        }
+        if (options.auth || options.oauth) {
+            return undefined;
+        }
+        const context = {};
+        if (req.headers["x-user-id"]) {
+            context.userId = String(req.headers["x-user-id"]);
+        }
+        if (req.headers["x-scopes"]) {
+            const scopes = req.headers["x-scopes"];
+            context.scopes = Array.isArray(scopes)
+                ? scopes.map(String)
+                : String(scopes).split(",").map(s => s.trim());
+        }
+        if (req.headers["x-building-ids"]) {
+            const buildingIds = req.headers["x-building-ids"];
+            context.buildingIds = Array.isArray(buildingIds)
+                ? buildingIds.map(String)
+                : String(buildingIds).split(",").map(s => s.trim());
+        }
+        if (Object.keys(context).length > 0) {
+            logger_util_1.logger.warn("ExpressAdapter", "Using unauthenticated headers for context extraction", {
+                component: "ExpressAdapter",
+                warning: "Headers are not authenticated and can be spoofed. Use auth middleware in production.",
+            });
+            return context;
+        }
+        return undefined;
+    };
+    router.post("/", (0, express_1.json)({ limit: constants_1.MAX_MESSAGE_SIZE_BYTES }), async (req, res) => {
+        if (!httpGateway || !mcpServerService) {
+            res.status(500).json({
+                jsonrpc: "2.0",
+                id: null,
+                error: {
+                    code: -32603,
+                    message: "Internal error",
+                },
+            });
+            return;
+        }
+        const context = extractContext(req);
+        await httpGateway.handleHttpRequest(req, res, context);
+    });
+    router.get(`${pathPrefix}/health`, (req, res) => {
+        res.json({
+            status: "ok",
+            service: "mcp-server",
+            version: config.serverInfo?.version || "unknown",
+        });
+    });
+    router.get(`${pathPrefix}/health/ready`, (req, res) => {
+        const ready = tools.length > 0;
+        res.status(ready ? 200 : 503).json({ ready });
+    });
+    router.get(`${pathPrefix}/health/live`, (req, res) => {
+        res.status(200).json({ alive: true });
+    });
+    router.get(`${pathPrefix}/metrics`, (req, res) => {
+        res.status(200).set("Content-Type", "text/plain").send("# Metrics endpoint - implement with MetricsService");
+    });
+    return router;
+}
+//# sourceMappingURL=express-adapter.js.map

package/dist/adapters/express/express-adapter.js.map

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

package/dist/adapters/express/http-gateway.service.d.ts

@@ -0,0 +1,13 @@
+import { Request, Response } from "express";
+import { IInterfaceLayer } from "../../interface/interface.interface";
+import { McpServerService } from "../../core/mcp-server/mcp-server.service";
+import { McpContext } from "../../core/context/mcp-context.interface";
+export declare class HttpGatewayService implements IInterfaceLayer {
+    private mcpServerService;
+    private requestContextMap;
+    constructor();
+    setMcpServerService(service: McpServerService): void;
+    start(): Promise<void>;
+    sendMessage(sessionId: string, output: unknown): Promise<void>;
+    handleHttpRequest(req: Request, res: Response, context?: McpContext): Promise<void>;
+}