apprecio-mcp-base 1.0.0

package/dist/src/database/mongodb.js

@@ -0,0 +1,85 @@
+import mongoose from 'mongoose';
+import { logger } from '#core/logger';
+/**
+ * Clase para manejar la conexión a MongoDB
+ */
+export class MongoDBConnector {
+    uri;
+    options;
+    isConnected = false;
+    constructor(config) {
+        this.uri = config.uri;
+        this.options = config.options || {
+            maxPoolSize: 10,
+            minPoolSize: 2,
+            socketTimeoutMS: 45000,
+            serverSelectionTimeoutMS: 5000,
+        };
+    }
+    /**
+     * Conectar a MongoDB
+     */
+    async connect() {
+        if (this.isConnected) {
+            logger.warn('MongoDB already connected');
+            return;
+        }
+        try {
+            await mongoose.connect(this.uri, this.options);
+            this.isConnected = true;
+            logger.info('✅ MongoDB connected successfully');
+            // Event listeners
+            mongoose.connection.on('error', (error) => {
+                logger.error('MongoDB connection error:', error);
+            });
+            mongoose.connection.on('disconnected', () => {
+                logger.warn('MongoDB disconnected');
+                this.isConnected = false;
+            });
+            mongoose.connection.on('reconnected', () => {
+                logger.info('MongoDB reconnected');
+                this.isConnected = true;
+            });
+        }
+        catch (error) {
+            logger.error('Failed to connect to MongoDB:', error);
+            throw error;
+        }
+    }
+    /**
+     * Desconectar de MongoDB
+     */
+    async disconnect() {
+        if (!this.isConnected) {
+            return;
+        }
+        try {
+            await mongoose.connection.close();
+            this.isConnected = false;
+            logger.info('MongoDB disconnected gracefully');
+        }
+        catch (error) {
+            logger.error('Error disconnecting from MongoDB:', error);
+            throw error;
+        }
+    }
+    /**
+     * Verificar estado de conexión
+     */
+    get connected() {
+        return this.isConnected && mongoose.connection.readyState === 1;
+    }
+    /**
+     * Obtener la instancia de conexión
+     */
+    getConnection() {
+        return mongoose;
+    }
+}
+/**
+ * Factory para crear conector MongoDB
+ */
+export function createMongoDBConnector(uri) {
+    return new MongoDBConnector({ uri });
+}
+//# sourceMappingURL=mongodb.js.map

package/dist/src/database/mongodb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.js","sourceRoot":"","sources":["../../../src/database/mongodb.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAOtC;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACjB,GAAG,CAAS;IACZ,OAAO,CAA0B;IACjC,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,MAAsB;QAC9B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI;YAC7B,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,CAAC;YACd,eAAe,EAAE,KAAK;YACtB,wBAAwB,EAAE,IAAI;SACjC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACzC,OAAO;QACX,CAAC;QAED,IAAI,CAAC;YACD,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YAEhD,kBAAkB;YAClB,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACtC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;gBACxC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;gBACpC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YAC7B,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;gBACvC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;gBACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YAC5B,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,OAAO;QACX,CAAC;QAED,IAAI,CAAC;YACD,MAAM,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,KAAK,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,aAAa;QACT,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAC9C,OAAO,IAAI,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,11 @@
+export { McpBaseServer } from './core/McpBaseServer.js';
+export { BaseConfig } from './core/config.js';
+export { logger, createChildLogger, setLogLevel } from './core/logger.js';
+export type * from './core/types.js';
+export { AuthMiddleware, createAuthMiddleware } from './middleware/auth.js';
+export { MongoDBConnector, createMongoDBConnector } from './database/mongodb.js';
+export type { MongoDBOptions } from './database/mongodb.js';
+export { createExpressServer } from './server/createExpressServer.js';
+export type { CreateServerOptions } from './server/createExpressServer.js';
+export { isPortAvailable, findAvailablePort, getRandomAvailablePort, } from './utils/portFinder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1E,mBAAmB,iBAAiB,CAAC;AAGrC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACjF,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,EACH,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,13 @@
+// Core exports
+export { McpBaseServer } from './core/McpBaseServer.js';
+export { BaseConfig } from './core/config.js';
+export { logger, createChildLogger, setLogLevel } from './core/logger.js';
+// Middleware exports
+export { AuthMiddleware, createAuthMiddleware } from './middleware/auth.js';
+// Database exports
+export { MongoDBConnector, createMongoDBConnector } from './database/mongodb.js';
+// Server exports
+export { createExpressServer } from './server/createExpressServer.js';
+// Utils exports
+export { isPortAvailable, findAvailablePort, getRandomAvailablePort, } from './utils/portFinder.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG1E,qBAAqB;AACrB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5E,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAGtE,gBAAgB;AAChB,OAAO,EACH,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/src/middleware/auth.d.ts

@@ -0,0 +1,26 @@
+import type { Request, Response, NextFunction } from 'express';
+/**
+ * Middleware de autenticación para servidores MCP
+ */
+export declare class AuthMiddleware {
+    private apiKey;
+    private allowPublicPrivateAuth;
+    constructor(apiKey: string, allowPublicPrivateAuth?: boolean);
+    /**
+     * Middleware para validar API Key
+     */
+    authenticate: (req: Request, res: Response, next: NextFunction) => Promise<void>;
+    /**
+     * Validar tokens público/privado
+     */
+    private validatePublicPrivateTokens;
+    /**
+     * Middleware opcional - requiere autenticación solo para ciertas rutas
+     */
+    optionalAuth: (req: Request, res: Response, next: NextFunction) => Promise<void>;
+}
+/**
+ * Factory para crear middleware de autenticación
+ */
+export declare function createAuthMiddleware(apiKey: string, allowPublicPrivateAuth?: boolean): AuthMiddleware;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/middleware/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI/D;;GAEG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,sBAAsB,CAAU;gBAE5B,MAAM,EAAE,MAAM,EAAE,sBAAsB,UAAQ;IAK1D;;OAEG;IACI,YAAY,GACf,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,MAAM,YAAY,KACnB,OAAO,CAAC,IAAI,CAAC,CAsEd;IAEF;;OAEG;YACW,2BAA2B;IAQzC;;OAEG;IACI,YAAY,GACf,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,MAAM,YAAY,KACnB,OAAO,CAAC,IAAI,CAAC,CAUd;CACL;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,MAAM,EACd,sBAAsB,UAAQ,GAC/B,cAAc,CAEhB"}

package/dist/src/middleware/auth.js

@@ -0,0 +1,100 @@
+import { logger } from '#core/logger';
+/**
+ * Middleware de autenticación para servidores MCP
+ */
+export class AuthMiddleware {
+    apiKey;
+    allowPublicPrivateAuth;
+    constructor(apiKey, allowPublicPrivateAuth = false) {
+        this.apiKey = apiKey;
+        this.allowPublicPrivateAuth = allowPublicPrivateAuth;
+    }
+    /**
+     * Middleware para validar API Key
+     */
+    authenticate = async (req, res, next) => {
+        try {
+            const authHeader = req.headers.authorization;
+            const publicToken = req.headers['publictoken'];
+            const privateToken = req.headers['privatetoken'];
+            let isValid = false;
+            const authContext = {
+                isAuthenticated: false,
+            };
+            // Verificar Bearer token
+            if (authHeader && authHeader.startsWith('Bearer ')) {
+                const token = authHeader.substring(7);
+                if (token === this.apiKey) {
+                    isValid = true;
+                    authContext.metadata = { authMethod: 'bearer' };
+                }
+            }
+            // Verificar Public/Private tokens (si está habilitado)
+            if (!isValid &&
+                this.allowPublicPrivateAuth &&
+                publicToken &&
+                privateToken) {
+                // Aquí podrías implementar validación adicional de tokens
+                isValid = await this.validatePublicPrivateTokens(publicToken, privateToken);
+                if (isValid) {
+                    authContext.metadata = {
+                        authMethod: 'public-private',
+                        publicToken
+                    };
+                }
+            }
+            if (!isValid) {
+                logger.warn('Authentication failed', {
+                    ip: req.ip,
+                    path: req.path,
+                });
+                res.status(401).json({
+                    error: 'Unauthorized',
+                    message: 'Invalid or missing authentication credentials',
+                });
+                return;
+            }
+            authContext.isAuthenticated = true;
+            // Adjuntar contexto de autenticación al request
+            req.authContext = authContext;
+            logger.debug('Authentication successful', {
+                method: authContext.metadata?.authMethod,
+                path: req.path,
+            });
+            next();
+        }
+        catch (error) {
+            logger.error('Authentication error:', error);
+            res.status(500).json({
+                error: 'Internal Server Error',
+                message: 'Authentication failed',
+            });
+        }
+    };
+    /**
+     * Validar tokens público/privado
+     */
+    async validatePublicPrivateTokens(publicToken, privateToken) {
+        // Implementación básica - override en subclases si necesitas lógica personalizada
+        return publicToken.length > 0 && privateToken.length > 0;
+    }
+    /**
+     * Middleware opcional - requiere autenticación solo para ciertas rutas
+     */
+    optionalAuth = async (req, res, next) => {
+        const authHeader = req.headers.authorization;
+        if (!authHeader) {
+            req.authContext = { isAuthenticated: false };
+            next();
+            return;
+        }
+        await this.authenticate(req, res, next);
+    };
+}
+/**
+ * Factory para crear middleware de autenticación
+ */
+export function createAuthMiddleware(apiKey, allowPublicPrivateAuth = false) {
+    return new AuthMiddleware(apiKey, allowPublicPrivateAuth);
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/middleware/auth.js.map

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

package/dist/src/server/createExpressServer.d.ts

@@ -0,0 +1,13 @@
+import type { Server as HttpServer } from 'http';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BaseConfig } from '#core/config';
+export interface CreateServerOptions {
+    mcpServer: McpServer;
+    config: BaseConfig;
+    port: number;
+}
+/**
+ * Crea y configura el servidor Express con todos los middlewares
+ */
+export declare function createExpressServer(options: CreateServerOptions): Promise<HttpServer>;
+//# sourceMappingURL=createExpressServer.d.ts.map

package/dist/src/server/createExpressServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExpressServer.d.ts","sourceRoot":"","sources":["../../../src/server/createExpressServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAIjD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,UAAU,CAAC,CA4GrB"}

package/dist/src/server/createExpressServer.js

@@ -0,0 +1,98 @@
+import express from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import rateLimit from 'express-rate-limit';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import rawBody from 'raw-body';
+import { logger } from '#core/logger';
+import { createAuthMiddleware } from '#middleware/auth';
+/**
+ * Crea y configura el servidor Express con todos los middlewares
+ */
+export async function createExpressServer(options) {
+    const { mcpServer, config, port } = options;
+    const app = express();
+    // Security middlewares
+    app.use(helmet());
+    app.use(cors({
+        origin: config.corsAllowOrigin,
+        credentials: true,
+    }));
+    // Rate limiting
+    const limiter = rateLimit({
+        windowMs: config.rateLimitWindowMs,
+        max: config.rateLimitMaxRequests,
+        message: 'Too many requests from this IP, please try again later.',
+    });
+    app.use(limiter);
+    // Auth middleware
+    const authMiddleware = createAuthMiddleware(config.apiKey);
+    // Health check endpoint (sin autenticación)
+    app.get('/health', (req, res) => {
+        res.json({
+            status: 'healthy',
+            timestamp: new Date().toISOString(),
+        });
+    });
+    // SSE endpoint para MCP
+    app.get('/sse', authMiddleware.authenticate, async (req, res) => {
+        logger.info('New SSE connection established');
+        const transport = new SSEServerTransport('/message', res);
+        await mcpServer.connect(transport);
+        // Cleanup cuando se cierra la conexión
+        req.on('close', () => {
+            logger.info('SSE connection closed');
+        });
+    });
+    // Message endpoint para MCP (legacy)
+    app.post('/message', authMiddleware.authenticate, async (req, res) => {
+        try {
+            const body = await rawBody(req, {
+                length: req.headers['content-length'],
+                limit: '10mb',
+            });
+            const message = JSON.parse(body.toString('utf-8'));
+            logger.debug('Received MCP message', {
+                method: message.method,
+                id: message.id,
+            });
+            // Aquí se procesaría el mensaje MCP
+            // Por ahora solo respondemos OK
+            res.json({
+                jsonrpc: '2.0',
+                id: message.id,
+                result: {},
+            });
+        }
+        catch (error) {
+            logger.error('Error processing message:', error);
+            res.status(500).json({
+                jsonrpc: '2.0',
+                error: {
+                    code: -32603,
+                    message: 'Internal server error',
+                },
+            });
+        }
+    });
+    // Error handling middleware
+    app.use((err, req, res, next) => {
+        logger.error('Express error:', err);
+        res.status(500).json({
+            error: 'Internal Server Error',
+            message: process.env.NODE_ENV === 'development' ? err.message : undefined,
+        });
+    });
+    // Start server
+    return new Promise((resolve, reject) => {
+        const server = app.listen(port, () => {
+            logger.info(`Express server listening on port ${port}`);
+            resolve(server);
+        });
+        server.on('error', (error) => {
+            logger.error('Server error:', error);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=createExpressServer.js.map

package/dist/src/server/createExpressServer.js.map

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

package/dist/src/utils/portFinder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Verifica si un puerto está disponible
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/**
+ * Encuentra un puerto disponible empezando desde startPort
+ */
+export declare function findAvailablePort(startPort: number, maxAttempts?: number): Promise<number>;
+/**
+ * Obtiene un puerto aleatorio disponible
+ */
+export declare function getRandomAvailablePort(): Promise<number>;
+//# sourceMappingURL=portFinder.d.ts.map

package/dist/src/utils/portFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portFinder.d.ts","sourceRoot":"","sources":["../../../src/utils/portFinder.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBpE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,SAAK,GACjB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAM9D"}

package/dist/src/utils/portFinder.js

@@ -0,0 +1,43 @@
+import net from 'net';
+import { logger } from '#core/logger';
+/**
+ * Verifica si un puerto está disponible
+ */
+export async function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => {
+            resolve(false);
+        });
+        server.once('listening', () => {
+            server.close(() => {
+                resolve(true);
+            });
+        });
+        server.listen(port);
+    });
+}
+/**
+ * Encuentra un puerto disponible empezando desde startPort
+ */
+export async function findAvailablePort(startPort, maxAttempts = 10) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = startPort + i;
+        if (await isPortAvailable(port)) {
+            logger.info(`Found available port: ${port}`);
+            return port;
+        }
+        logger.debug(`Port ${port} is not available, trying next...`);
+    }
+    throw new Error(`Could not find an available port after ${maxAttempts} attempts starting from ${startPort}`);
+}
+/**
+ * Obtiene un puerto aleatorio disponible
+ */
+export async function getRandomAvailablePort() {
+    const minPort = 3000;
+    const maxPort = 65535;
+    const randomPort = Math.floor(Math.random() * (maxPort - minPort + 1)) + minPort;
+    return findAvailablePort(randomPort, 100);
+}
+//# sourceMappingURL=portFinder.js.map

package/dist/src/utils/portFinder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portFinder.js","sourceRoot":"","sources":["../../../src/utils/portFinder.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBACd,OAAO,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,SAAiB,EACjB,WAAW,GAAG,EAAE;IAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC;QAE3B,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,mCAAmC,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,IAAI,KAAK,CACX,0CAA0C,WAAW,2BAA2B,SAAS,EAAE,CAC9F,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC;IACrB,MAAM,OAAO,GAAG,KAAK,CAAC;IACtB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAEjF,OAAO,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/dist/utils/portFinder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Verifica si un puerto está disponible
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/**
+ * Encuentra un puerto disponible empezando desde startPort
+ */
+export declare function findAvailablePort(startPort: number, maxAttempts?: number): Promise<number>;
+/**
+ * Obtiene un puerto aleatorio disponible
+ */
+export declare function getRandomAvailablePort(): Promise<number>;
+//# sourceMappingURL=portFinder.d.ts.map

package/dist/utils/portFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portFinder.d.ts","sourceRoot":"","sources":["../../src/utils/portFinder.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBpE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,SAAK,GACjB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAM9D"}

package/dist/utils/portFinder.js

@@ -0,0 +1,43 @@
+import net from 'net';
+import { logger } from '../core/logger';
+/**
+ * Verifica si un puerto está disponible
+ */
+export async function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => {
+            resolve(false);
+        });
+        server.once('listening', () => {
+            server.close(() => {
+                resolve(true);
+            });
+        });
+        server.listen(port);
+    });
+}
+/**
+ * Encuentra un puerto disponible empezando desde startPort
+ */
+export async function findAvailablePort(startPort, maxAttempts = 10) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = startPort + i;
+        if (await isPortAvailable(port)) {
+            logger.info(`Found available port: ${port}`);
+            return port;
+        }
+        logger.debug(`Port ${port} is not available, trying next...`);
+    }
+    throw new Error(`Could not find an available port after ${maxAttempts} attempts starting from ${startPort}`);
+}
+/**
+ * Obtiene un puerto aleatorio disponible
+ */
+export async function getRandomAvailablePort() {
+    const minPort = 3000;
+    const maxPort = 65535;
+    const randomPort = Math.floor(Math.random() * (maxPort - minPort + 1)) + minPort;
+    return findAvailablePort(randomPort, 100);
+}
+//# sourceMappingURL=portFinder.js.map

package/dist/utils/portFinder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portFinder.js","sourceRoot":"","sources":["../../src/utils/portFinder.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBACd,OAAO,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,SAAiB,EACjB,WAAW,GAAG,EAAE;IAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC;QAE3B,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,mCAAmC,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,IAAI,KAAK,CACX,0CAA0C,WAAW,2BAA2B,SAAS,EAAE,CAC9F,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC;IACrB,MAAM,OAAO,GAAG,KAAK,CAAC;IACtB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAEjF,OAAO,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "apprecio-mcp-base",
+  "version": "1.0.0",
+  "description": "Base package for creating Apprecio MCP servers with consistency",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "apprecio-mcp": "dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "node -r tsconfig-paths/register --loader tsx src/index.ts",
+    "prepare": "npm run build",
+    "test": "jest --coverage"
+  },
+  "keywords": [
+    "mcp",
+    "apprecio",
+    "server",
+    "base",
+    "typescript"
+  ],
+  "author": "Apprecio Team",
+  "license": "MIT",
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.21.2",
+    "express": "^5.1.0"
+  },
+  "dependencies": {
+    "axios": "^1.9.0",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.5.0",
+    "express-rate-limit": "^8.1.0",
+    "helmet": "^8.1.0",
+    "http-terminator": "^3.2.0",
+    "inquirer": "^9.2.12",
+    "mongoose": "^8.18.0",
+    "winston": "^3.11.0",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.1",
+    "@types/express-rate-limit": "^5.1.3",
+    "@types/helmet": "^0.0.48",
+    "@types/inquirer": "^9.0.7",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.14.1",
+    "jest": "^30.0.5",
+    "ts-jest": "^29.4.1",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.2"
+  }
+}