apprecio-mcp-base 1.0.0

package/README.md

@@ -0,0 +1,301 @@
+# @apprecio/mcp-base
+
+Base package para crear servidores MCP (Model Context Protocol) de Apprecio con consistencia y reutilización de código.
+
+## 🚀 Características
+
+- **Servidor Base Abstracto**: Clase `McpBaseServer` que encapsula toda la lógica común
+- **Configuración Centralizada**: Sistema de configuración con validación Zod
+- **Logger Unificado**: Winston logger con niveles configurables y rotación de archivos
+- **Middlewares Reutilizables**: Autenticación, Rate Limiting, CORS, Helmet
+- **Conectores Database**: MongoDB y Redis pre-configurados
+- **Port Management**: Búsqueda automática de puertos disponibles
+- **Graceful Shutdown**: Manejo automático de señales SIGINT/SIGTERM
+- **TypeScript First**: Completamente tipado con soporte para path aliases
+
+## 📦 Instalación
+
+```bash
+npm install @apprecio/mcp-base
+# o
+pnpm add @apprecio/mcp-base
+```
+
+## 🎯 Uso Básico
+
+### 1. Crear un nuevo servidor MCP
+
+```typescript
+import { 
+    McpBaseServer, 
+    createExpressServer, 
+    findAvailablePort,
+    createMongoDBConnector 
+} from '@apprecio/mcp-base';
+import type { FeatureModule } from '@apprecio/mcp-base';
+
+// Definir tu servidor MCP personalizado
+class MyCustomMcpServer extends McpBaseServer {
+    private dbConnector?: MongoDBConnector;
+
+    protected async registerFeatures(): Promise<void> {
+        // Registrar tus features personalizadas
+        this.registerFeature('myFeature', myFeatureModule);
+    }
+
+    protected async onBeforeStart(): Promise<void> {
+        // Conectar a MongoDB si es necesario
+        if (this.config.mongodbUri) {
+            this.dbConnector = createMongoDBConnector(this.config.mongodbUri);
+            await this.dbConnector.connect();
+        }
+    }
+
+    protected async onBeforeShutdown(): Promise<void> {
+        // Cleanup
+        if (this.dbConnector) {
+            await this.dbConnector.disconnect();
+        }
+    }
+}
+
+// Iniciar el servidor
+async function main() {
+    const server = new MyCustomMcpServer({
+        name: 'my-custom-mcp',
+        version: '1.0.0',
+    });
+
+    const port = await findAvailablePort(server.getConfig().ssePort);
+    
+    const httpServer = await createExpressServer({
+        mcpServer: server.getMcpServer(),
+        config: server.getConfig(),
+        port,
+    });
+
+    await server.start(httpServer, port);
+}
+
+main();
+```
+
+### 2. Crear un Feature Module
+
+```typescript
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FeatureModule } from '@apprecio/mcp-base';
+
+export const myFeatureModule: FeatureModule = {
+    name: 'myFeature',
+
+    register(mcpServer: McpServer): void {
+        // Registrar tools
+        mcpServer.tool(
+            'my_tool',
+            'Description of my tool',
+            {
+                type: 'object',
+                properties: {
+                    param: { type: 'string' }
+                },
+                required: ['param']
+            },
+            async (params) => {
+                // Implementación del tool
+                return {
+                    content: [{
+                        type: 'text',
+                        text: `Result: ${params.param}`
+                    }]
+                };
+            }
+        );
+    },
+
+    async initialize(): Promise<void> {
+        // Inicialización opcional
+        console.log('Feature initialized');
+    },
+
+    async cleanup(): Promise<void> {
+        // Cleanup opcional
+        console.log('Feature cleaned up');
+    }
+};
+```
+
+### 3. Configuración (.env)
+
+```env
+# Authentication
+API_KEY=your-secret-api-key
+
+# Database
+MONGODB_URI=mongodb://localhost:27017/mydb
+
+# Server
+MCP_SSE_PORT=3200
+
+# Timeouts (ms)
+MCP_TIMEOUT=180000
+SSE_TIMEOUT=1800000
+
+# Logging
+LOG_LEVEL=info
+
+# CORS
+CORS_ALLOW_ORIGIN=*
+
+# Rate Limiting
+RATE_LIMIT_WINDOW_MS=900000
+RATE_LIMIT_MAX_REQUESTS=100
+```
+
+## 📚 API Reference
+
+### McpBaseServer
+
+Clase abstracta base para servidores MCP.
+
+```typescript
+abstract class McpBaseServer {
+    constructor(options: ServerOptions)
+    
+    // Métodos abstractos (deben implementarse)
+    protected abstract registerFeatures(): Promise<void>
+    
+    // Hooks opcionales
+    protected async onBeforeStart?(): Promise<void>
+    protected async onBeforeShutdown?(): Promise<void>
+    
+    // Métodos públicos
+    public getMcpServer(): McpServer
+    public getConfig(): BaseConfig
+    public getFeatures(): Map<string, FeatureModule>
+    
+    // Método para iniciar el servidor
+    async start(httpServer: HttpServer, port: number): Promise<void>
+}
+```
+
+### BaseConfig
+
+Sistema de configuración con validación.
+
+```typescript
+class BaseConfig {
+    constructor(envPath?: string)
+    
+    // Getters
+    get apiKey(): string
+    get mongodbUri(): string | undefined
+    get ssePort(): number
+    get logLevel(): 'debug' | 'info' | 'warn' | 'error'
+    // ... más getters
+    
+    // Métodos
+    getAll(): BaseConfigType
+    extend<T>(customConfig: T): BaseConfigType & T
+}
+```
+
+### Logger
+
+Logger centralizado con Winston.
+
+```typescript
+import { logger, createChildLogger, setLogLevel } from '@apprecio/mcp-base';
+
+// Uso básico
+logger.info('Message');
+logger.error('Error', error);
+logger.debug('Debug info', { metadata });
+
+// Logger con contexto
+const childLogger = createChildLogger('MyFeature');
+childLogger.info('Feature message');
+
+// Cambiar nivel dinámicamente
+setLogLevel('debug');
+```
+
+### Middlewares
+
+```typescript
+import { createAuthMiddleware } from '@apprecio/mcp-base';
+
+const authMiddleware = createAuthMiddleware(apiKey);
+
+app.use('/protected', authMiddleware.authenticate);
+app.use('/optional', authMiddleware.optionalAuth);
+```
+
+### Database Connectors
+
+```typescript
+import { createMongoDBConnector } from '@apprecio/mcp-base';
+
+const db = createMongoDBConnector('mongodb://localhost:27017/db');
+await db.connect();
+
+// Usar mongoose normalmente
+const connection = db.getConnection();
+
+await db.disconnect();
+```
+
+## 🔧 Desarrollo
+
+### Estructura del proyecto base
+
+```
+@apprecio/mcp-base/
+├── src/
+│   ├── core/                 # Núcleo del framework
+│   │   ├── McpBaseServer.ts  # Clase base
+│   │   ├── config.ts         # Configuración
+│   │   ├── logger.ts         # Logger
+│   │   └── types.ts          # Tipos compartidos
+│   ├── middleware/           # Middlewares Express
+│   ├── database/             # Conectores DB
+│   ├── server/               # Server builders
+│   ├── utils/                # Utilidades
+│   └── index.ts              # Exports principales
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+### Desarrollo
+
+```bash
+npm run dev
+```
+
+## 🎨 Ejemplos Completos
+
+Ver el directorio `examples/` para ejemplos completos de:
+
+- Servidor MCP simple
+- Servidor con MongoDB
+- Servidor con múltiples features
+- Servidor con autenticación personalizada
+
+## 📝 Licencia
+
+MIT
+
+## 🤝 Contribuir
+
+1. Fork el proyecto
+2. Crea una branch para tu feature
+3. Commit tus cambios
+4. Push a la branch
+5. Abre un Pull Request

package/dist/core/McpBaseServer.d.ts

@@ -0,0 +1,59 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Express } from 'express';
+import type { Server as HttpServer } from 'http';
+import { HttpTerminator } from 'http-terminator';
+import { BaseConfig } from './config.js';
+import type { FeatureModule, ServerOptions } from './types.js';
+/**
+ * Clase base abstracta para servidores MCP de Apprecio
+ * Proporciona funcionalidad común para todos los servidores MCP
+ */
+export declare abstract class McpBaseServer {
+    protected mcpServer: McpServer;
+    protected httpServer?: HttpServer;
+    protected httpTerminator?: HttpTerminator;
+    protected config: BaseConfig;
+    protected features: Map<string, FeatureModule>;
+    constructor(options: ServerOptions);
+    /**
+     * Registra un feature module (debe implementar cada servidor MCP)
+     */
+    protected abstract registerFeatures(): Promise<void>;
+    /**
+     * Hook para inicialización personalizada
+     */
+    protected onBeforeStart?(): Promise<void>;
+    /**
+     * Hook para cleanup personalizado
+     */
+    protected onBeforeShutdown?(): Promise<void>;
+    /**
+     * Registra una feature genérica
+     */
+    protected registerFeature(name: string, feature: FeatureModule): void;
+    /**
+     * Configura el servidor Express con middlewares base
+     */
+    protected setupHttpServer(app: Express): Promise<void>;
+    /**
+     * Inicia el servidor MCP
+     */
+    start(httpServer: HttpServer, port: number): Promise<void>;
+    /**
+     * Configura el apagado graceful del servidor
+     */
+    private setupGracefulShutdown;
+    /**
+     * Obtiene la instancia del MCP Server
+     */
+    getMcpServer(): McpServer;
+    /**
+     * Obtiene la configuración
+     */
+    getConfig(): BaseConfig;
+    /**
+     * Obtiene las features registradas
+     */
+    getFeatures(): Map<string, FeatureModule>;
+}
+//# sourceMappingURL=McpBaseServer.d.ts.map

package/dist/core/McpBaseServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpBaseServer.d.ts","sourceRoot":"","sources":["../../src/core/McpBaseServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,EAAwB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGvE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;;;GAGG;AACH,8BAAsB,aAAa;IAC/B,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;IAC/B,SAAS,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IAClC,SAAS,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC;IAC7B,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAa;gBAE/C,OAAO,EAAE,aAAa;IAWlC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpD;;OAEG;cACa,aAAa,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/C;;OAEG;cACa,gBAAgB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAElD;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAUrE;;OAEG;cACa,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBhE;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;OAEG;IACI,YAAY,IAAI,SAAS;IAIhC;;OAEG;IACI,SAAS,IAAI,UAAU;IAI9B;;OAEG;IACI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;CAGnD"}

package/dist/core/McpBaseServer.js

@@ -0,0 +1,113 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { createHttpTerminator } from 'http-terminator';
+import { logger } from './logger.js';
+import { BaseConfig } from './config.js';
+/**
+ * Clase base abstracta para servidores MCP de Apprecio
+ * Proporciona funcionalidad común para todos los servidores MCP
+ */
+export class McpBaseServer {
+    mcpServer;
+    httpServer;
+    httpTerminator;
+    config;
+    features = new Map();
+    constructor(options) {
+        this.config = new BaseConfig(options.envPath);
+        this.mcpServer = new McpServer({
+            name: options.name,
+            version: options.version,
+        });
+        logger.info(`Initializing ${options.name} v${options.version}`);
+    }
+    /**
+     * Registra una feature genérica
+     */
+    registerFeature(name, feature) {
+        if (this.features.has(name)) {
+            logger.warn(`Feature ${name} ya está registrada. Sobrescribiendo...`);
+        }
+        feature.register(this.mcpServer);
+        this.features.set(name, feature);
+        logger.info(`Feature '${name}' registered successfully`);
+    }
+    /**
+     * Configura el servidor Express con middlewares base
+     */
+    async setupHttpServer(app) {
+        // Implementado en el server builder
+    }
+    /**
+     * Inicia el servidor MCP
+     */
+    async start(httpServer, port) {
+        try {
+            // Hook pre-start
+            if (this.onBeforeStart) {
+                await this.onBeforeStart();
+            }
+            // Registrar features
+            await this.registerFeatures();
+            // Guardar referencia al servidor HTTP
+            this.httpServer = httpServer;
+            this.httpTerminator = createHttpTerminator({ server: httpServer });
+            logger.info(`MCP Server started successfully on port ${port}`);
+            // Setup graceful shutdown
+            this.setupGracefulShutdown();
+        }
+        catch (error) {
+            logger.error('Failed to start MCP server:', error);
+            throw error;
+        }
+    }
+    /**
+     * Configura el apagado graceful del servidor
+     */
+    setupGracefulShutdown() {
+        const shutdown = async (signal) => {
+            logger.info(`Received ${signal} signal. Starting graceful shutdown...`);
+            // Pequeño delay para completar requests en curso
+            await new Promise(resolve => setTimeout(resolve, 500));
+            try {
+                // Hook pre-shutdown
+                if (this.onBeforeShutdown) {
+                    await this.onBeforeShutdown();
+                }
+                // Terminar servidor HTTP
+                if (this.httpTerminator) {
+                    await this.httpTerminator.terminate();
+                }
+                logger.info('Server terminated successfully. Exiting.');
+                process.exit(0);
+            }
+            catch (error) {
+                logger.error('Error during server termination:', error);
+                process.exit(1);
+            }
+        };
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        process.on('unhandledRejection', (reason) => {
+            logger.error('Unhandled promise rejection:', reason);
+        });
+    }
+    /**
+     * Obtiene la instancia del MCP Server
+     */
+    getMcpServer() {
+        return this.mcpServer;
+    }
+    /**
+     * Obtiene la configuración
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Obtiene las features registradas
+     */
+    getFeatures() {
+        return this.features;
+    }
+}
+//# sourceMappingURL=McpBaseServer.js.map

package/dist/core/McpBaseServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpBaseServer.js","sourceRoot":"","sources":["../../src/core/McpBaseServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,oBAAoB,EAAkB,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;GAGG;AACH,MAAM,OAAgB,aAAa;IACrB,SAAS,CAAY;IACrB,UAAU,CAAc;IACxB,cAAc,CAAkB;IAChC,MAAM,CAAa;IACnB,QAAQ,GAA+B,IAAI,GAAG,EAAE,CAAC;IAE3D,YAAY,OAAsB;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE9C,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC;YAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;SAC3B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAiBD;;OAEG;IACO,eAAe,CAAC,IAAY,EAAE,OAAsB;QAC1D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,yCAAyC,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,2BAA2B,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,eAAe,CAAC,GAAY;QACxC,oCAAoC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,UAAsB,EAAE,IAAY;QAC5C,IAAI,CAAC;YACD,iBAAiB;YACjB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC/B,CAAC;YAED,qBAAqB;YACrB,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE9B,sCAAsC;YACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAC7B,IAAI,CAAC,cAAc,GAAG,oBAAoB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAEnE,MAAM,CAAC,IAAI,CAAC,2CAA2C,IAAI,EAAE,CAAC,CAAC;YAE/D,0BAA0B;YAC1B,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAEjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACK,qBAAqB;QACzB,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YACtC,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,wCAAwC,CAAC,CAAC;YAExE,iDAAiD;YACjD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YAEvD,IAAI,CAAC;gBACD,oBAAoB;gBACpB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACxB,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAClC,CAAC;gBAED,yBAAyB;gBACzB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACtB,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;gBAC1C,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;YACxC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,YAAY;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,SAAS;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;CACJ"}

package/dist/core/config.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+/**
+ * Schema de validación para la configuración base
+ */
+declare const baseConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    mongodbUri: z.ZodOptional<z.ZodString>;
+    redisUri: z.ZodOptional<z.ZodString>;
+    ssePort: z.ZodDefault<z.ZodNumber>;
+    mcpTimeout: z.ZodDefault<z.ZodNumber>;
+    sseTimeout: z.ZodDefault<z.ZodNumber>;
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    corsAllowOrigin: z.ZodDefault<z.ZodString>;
+    rateLimitWindowMs: z.ZodDefault<z.ZodNumber>;
+    rateLimitMaxRequests: z.ZodDefault<z.ZodNumber>;
+    rateLimitSseMax: z.ZodDefault<z.ZodNumber>;
+    rateLimitMessagesMax: z.ZodDefault<z.ZodNumber>;
+    defaultUserRateLimit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    apiKey: string;
+    ssePort: number;
+    mcpTimeout: number;
+    sseTimeout: number;
+    logLevel: "info" | "error" | "debug" | "warn";
+    corsAllowOrigin: string;
+    rateLimitWindowMs: number;
+    rateLimitMaxRequests: number;
+    rateLimitSseMax: number;
+    rateLimitMessagesMax: number;
+    defaultUserRateLimit: number;
+    mongodbUri?: string | undefined;
+    redisUri?: string | undefined;
+}, {
+    apiKey: string;
+    mongodbUri?: string | undefined;
+    redisUri?: string | undefined;
+    ssePort?: number | undefined;
+    mcpTimeout?: number | undefined;
+    sseTimeout?: number | undefined;
+    logLevel?: "info" | "error" | "debug" | "warn" | undefined;
+    corsAllowOrigin?: string | undefined;
+    rateLimitWindowMs?: number | undefined;
+    rateLimitMaxRequests?: number | undefined;
+    rateLimitSseMax?: number | undefined;
+    rateLimitMessagesMax?: number | undefined;
+    defaultUserRateLimit?: number | undefined;
+}>;
+export type BaseConfigType = z.infer<typeof baseConfigSchema>;
+/**
+ * Clase de configuración base para servidores MCP
+ */
+export declare class BaseConfig {
+    private config;
+    constructor(envPath?: string);
+    /**
+     * Obtiene toda la configuración
+     */
+    getAll(): BaseConfigType;
+    /**
+     * Getters individuales
+     */
+    get apiKey(): string;
+    get mongodbUri(): string | undefined;
+    get redisUri(): string | undefined;
+    get ssePort(): number;
+    get mcpTimeout(): number;
+    get sseTimeout(): number;
+    get logLevel(): 'debug' | 'info' | 'warn' | 'error';
+    get corsAllowOrigin(): string;
+    get rateLimitWindowMs(): number;
+    get rateLimitMaxRequests(): number;
+    get rateLimitSseMax(): number;
+    get rateLimitMessagesMax(): number;
+    get defaultUserRateLimit(): number;
+    /**
+     * Permite extender la configuración con valores personalizados
+     */
+    extend<T extends Record<string, any>>(customConfig: T): BaseConfigType & T;
+}
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BpB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE9D;;GAEG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,OAAO,CAAC,EAAE,MAAM;IAmC5B;;OAEG;IACI,MAAM,IAAI,cAAc;IAI/B;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAElD;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAED,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAED;;OAEG;IACI,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,cAAc,GAAG,CAAC;CAGpF"}

package/dist/core/config.js

@@ -0,0 +1,122 @@
+import { config as dotenvConfig } from 'dotenv';
+import { z } from 'zod';
+import { logger } from './logger.js';
+/**
+ * Schema de validación para la configuración base
+ */
+const baseConfigSchema = z.object({
+    // Authentication
+    apiKey: z.string().min(1, 'API_KEY is required'),
+    // Database
+    mongodbUri: z.string().optional(),
+    redisUri: z.string().optional(),
+    // Server
+    ssePort: z.coerce.number().min(1000).max(65535).default(3200),
+    // Timeouts
+    mcpTimeout: z.coerce.number().default(180000),
+    sseTimeout: z.coerce.number().default(1800000),
+    // Logging
+    logLevel: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+    // CORS
+    corsAllowOrigin: z.string().default('*'),
+    // Rate Limiting
+    rateLimitWindowMs: z.coerce.number().default(900000),
+    rateLimitMaxRequests: z.coerce.number().default(100),
+    rateLimitSseMax: z.coerce.number().default(5),
+    rateLimitMessagesMax: z.coerce.number().default(30),
+    defaultUserRateLimit: z.coerce.number().default(1000),
+});
+/**
+ * Clase de configuración base para servidores MCP
+ */
+export class BaseConfig {
+    config;
+    constructor(envPath) {
+        // Cargar variables de entorno
+        dotenvConfig({ path: envPath });
+        // Parsear y validar configuración
+        const rawConfig = {
+            apiKey: process.env.API_KEY,
+            mongodbUri: process.env.MONGODB_URI,
+            redisUri: process.env.REDIS_URI,
+            ssePort: process.env.MCP_SSE_PORT,
+            mcpTimeout: process.env.MCP_TIMEOUT,
+            sseTimeout: process.env.SSE_TIMEOUT,
+            logLevel: process.env.LOG_LEVEL,
+            corsAllowOrigin: process.env.CORS_ALLOW_ORIGIN,
+            rateLimitWindowMs: process.env.RATE_LIMIT_WINDOW_MS,
+            rateLimitMaxRequests: process.env.RATE_LIMIT_MAX_REQUESTS,
+            rateLimitSseMax: process.env.RATE_LIMIT_SSE_MAX,
+            rateLimitMessagesMax: process.env.RATE_LIMIT_MESSAGES_MAX,
+            defaultUserRateLimit: process.env.DEFAULT_USER_RATE_LIMIT,
+        };
+        try {
+            this.config = baseConfigSchema.parse(rawConfig);
+            logger.info('Configuration loaded and validated successfully');
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                logger.error('Configuration validation failed:');
+                error.errors.forEach(err => {
+                    logger.error(`  - ${err.path.join('.')}: ${err.message}`);
+                });
+            }
+            throw new Error('Invalid configuration');
+        }
+    }
+    /**
+     * Obtiene toda la configuración
+     */
+    getAll() {
+        return this.config;
+    }
+    /**
+     * Getters individuales
+     */
+    get apiKey() {
+        return this.config.apiKey;
+    }
+    get mongodbUri() {
+        return this.config.mongodbUri;
+    }
+    get redisUri() {
+        return this.config.redisUri;
+    }
+    get ssePort() {
+        return this.config.ssePort;
+    }
+    get mcpTimeout() {
+        return this.config.mcpTimeout;
+    }
+    get sseTimeout() {
+        return this.config.sseTimeout;
+    }
+    get logLevel() {
+        return this.config.logLevel;
+    }
+    get corsAllowOrigin() {
+        return this.config.corsAllowOrigin;
+    }
+    get rateLimitWindowMs() {
+        return this.config.rateLimitWindowMs;
+    }
+    get rateLimitMaxRequests() {
+        return this.config.rateLimitMaxRequests;
+    }
+    get rateLimitSseMax() {
+        return this.config.rateLimitSseMax;
+    }
+    get rateLimitMessagesMax() {
+        return this.config.rateLimitMessagesMax;
+    }
+    get defaultUserRateLimit() {
+        return this.config.defaultUserRateLimit;
+    }
+    /**
+     * Permite extender la configuración con valores personalizados
+     */
+    extend(customConfig) {
+        return { ...this.config, ...customConfig };
+    }
+}
+//# sourceMappingURL=config.js.map