apprecio-mcp-base 1.1.0 → 1.1.1

package/cli/dist/generate-feature.js

@@ -6,17 +6,156 @@ import path from 'path';
 import fs from 'fs-extra';
 import { generateFeature } from './generators/feature-generator.js';
 import { updateMainFile } from './generators/main-updater.js';
+import { initProject } from './generators/init-generator.js';
 const program = new Command();
 program
     .name('mcp-generate')
-    .description('CLI para generar features MCP automáticamente')
-    .version('1.0.0');
+    .description('CLI para generar proyectos y features MCP automáticamente')
+    .version('1.2.0');
+// ==========================================
+// COMANDO: init
+// ==========================================
+program
+    .command('init')
+    .description('Inicializa un nuevo proyecto MCP con estructura completa')
+    .action(async () => {
+    console.log(chalk.blue.bold('\n🚀 Inicializar Nuevo Proyecto MCP\n'));
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: 'Nombre del proyecto:',
+            default: 'my-mcp-server',
+            validate: (input) => {
+                if (!input)
+                    return 'El nombre es requerido';
+                if (!/^[a-z][a-z0-9-]*$/.test(input)) {
+                    return 'El nombre debe ser kebab-case (solo minúsculas, números y guiones)';
+                }
+                return true;
+            }
+        },
+        {
+            type: 'input',
+            name: 'projectPath',
+            message: 'Ruta donde crear el proyecto:',
+            default: (answers) => `./${answers.projectName}`,
+            validate: async (input) => {
+                if (!input)
+                    return 'La ruta es requerida';
+                const exists = await fs.pathExists(input);
+                if (exists) {
+                    return `La ruta "${input}" ya existe. Elige otra ubicación.`;
+                }
+                return true;
+            }
+        },
+        {
+            type: 'input',
+            name: 'description',
+            message: 'Descripción del proyecto:',
+            default: (answers) => `MCP Server for ${answers.projectName}`
+        },
+        {
+            type: 'input',
+            name: 'author',
+            message: 'Autor:',
+            default: ''
+        },
+        {
+            type: 'confirm',
+            name: 'useDatabase',
+            message: '¿Usar MongoDB?',
+            default: false
+        },
+        {
+            type: 'input',
+            name: 'apiBaseUrl',
+            message: 'Base URL de tu API:',
+            default: 'https://api.example.com',
+            when: (answers) => !answers.useDatabase
+        }
+    ]);
+    try {
+        console.log(chalk.yellow('\n📦 Creando proyecto...\n'));
+        await initProject({
+            projectName: answers.projectName,
+            projectPath: answers.projectPath,
+            description: answers.description,
+            author: answers.author,
+            useDatabase: answers.useDatabase,
+            apiBaseUrl: answers.apiBaseUrl
+        });
+        console.log(chalk.green('\n✅ ¡Proyecto creado exitosamente!\n'));
+        console.log(chalk.blue.bold('📚 Próximos pasos:\n'));
+        console.log(chalk.white(`1. cd ${answers.projectPath}`));
+        console.log(chalk.white(`2. npm install`));
+        console.log(chalk.white(`3. Edita .env con tu configuración`));
+        console.log(chalk.white(`4. npm run dev\n`));
+        console.log(chalk.blue.bold('🔧 Comandos útiles:\n'));
+        console.log(chalk.white(`  npm run generate  - Generar nueva feature`));
+        console.log(chalk.white(`  npm run dev       - Ejecutar en desarrollo`));
+        console.log(chalk.white(`  npm run build     - Compilar proyecto\n`));
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Error creando proyecto:'), error.message);
+        process.exit(1);
+    }
+});
+program
+    .command('tool')
+    .description('Agrega un tool a una feature existente')
+    .action(async () => {
+    console.log(chalk.blue.bold('\n🔧 Agregar Tool a Feature\n'));
+    // Listar features existentes
+    const featuresPath = path.join(process.cwd(), 'src', 'features');
+    const features = await fs.readdir(featuresPath);
+    if (features.length === 0) {
+        console.log(chalk.red('No hay features disponibles. Crea una primero con: mcp-generate feature'));
+        process.exit(1);
+    }
+    const answers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'feature',
+            message: 'Selecciona la feature:',
+            choices: features
+        },
+        {
+            type: 'input',
+            name: 'toolName',
+            message: 'Nombre del tool (ej: approve_item):',
+            validate: (input) => {
+                if (!input)
+                    return 'El nombre es requerido';
+                if (!/^[a-z_]+$/.test(input)) {
+                    return 'El nombre debe ser snake_case';
+                }
+                return true;
+            }
+        },
+        {
+            type: 'input',
+            name: 'toolDescription',
+            message: 'Descripción del tool:',
+        },
+        {
+            type: 'confirm',
+            name: 'addToService',
+            message: '¿Agregar método al service?',
+            default: true
+        }
+    ]);
+    console.log(chalk.green(`\n✅ Tool ${answers.toolName} agregado a ${answers.feature}\n`));
+});
+// ==========================================
+// COMANDO: feature
+// ==========================================
 program
     .command('feature')
     .description('Genera una nueva feature completa (router, service, validation)')
     .action(async () => {
     console.log(chalk.blue.bold('\n🚀 Generador de Features MCP\n'));
-    // Preguntas interactivas
     const answers = await inquirer.prompt([
         {
             type: 'input',
@@ -90,9 +229,7 @@ program
     try {
         console.log(chalk.yellow('\n📝 Generando archivos...\n'));
         const featurePath = path.join(process.cwd(), 'src', 'features', answers.featureName);
-        // Crear directorio de la feature
         await fs.ensureDir(featurePath);
-        // Generar archivos
         const files = await generateFeature({
             featureName: answers.featureName,
             featureDescription: answers.featureDescription,
@@ -101,18 +238,15 @@ program
             serviceType: answers.needsService ? answers.serviceType : 'none',
             featurePath
         });
-        // Mostrar archivos generados
         console.log(chalk.green('✅ Archivos generados:\n'));
-        files.forEach(file => {
+        files.forEach((file) => {
             console.log(chalk.gray(`   ${file}`));
         });
-        // Actualizar main.ts si el usuario lo solicitó
         if (answers.updateMain) {
             console.log(chalk.yellow('\n🔄 Actualizando main.ts...\n'));
             await updateMainFile(answers.featureName, answers.entityName);
             console.log(chalk.green('✅ main.ts actualizado\n'));
         }
-        // Instrucciones finales
         console.log(chalk.blue.bold('\n📚 Próximos pasos:\n'));
         console.log(chalk.white(`1. Revisa los archivos generados en: ${chalk.cyan(`src/features/${answers.featureName}`)}`));
         console.log(chalk.white(`2. Implementa la lógica en: ${chalk.cyan(`${answers.featureName}.service.ts`)}`));
@@ -128,51 +262,5 @@ program
         process.exit(1);
     }
 });
-program
-    .command('tool')
-    .description('Agrega un tool a una feature existente')
-    .action(async () => {
-    console.log(chalk.blue.bold('\n🔧 Agregar Tool a Feature\n'));
-    // Listar features existentes
-    const featuresPath = path.join(process.cwd(), 'src', 'features');
-    const features = await fs.readdir(featuresPath);
-    if (features.length === 0) {
-        console.log(chalk.red('No hay features disponibles. Crea una primero con: mcp-generate feature'));
-        process.exit(1);
-    }
-    const answers = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'feature',
-            message: 'Selecciona la feature:',
-            choices: features
-        },
-        {
-            type: 'input',
-            name: 'toolName',
-            message: 'Nombre del tool (ej: approve_item):',
-            validate: (input) => {
-                if (!input)
-                    return 'El nombre es requerido';
-                if (!/^[a-z_]+$/.test(input)) {
-                    return 'El nombre debe ser snake_case';
-                }
-                return true;
-            }
-        },
-        {
-            type: 'input',
-            name: 'toolDescription',
-            message: 'Descripción del tool:',
-        },
-        {
-            type: 'confirm',
-            name: 'addToService',
-            message: '¿Agregar método al service?',
-            default: true
-        }
-    ]);
-    console.log(chalk.green(`\n✅ Tool ${answers.toolName} agregado a ${answers.feature}\n`));
-});
 program.parse();
 //# sourceMappingURL=generate-feature.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apprecio-mcp-base",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Base package for creating Apprecio MCP servers with consistency",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/cli/README.md

@@ -1,432 +0,0 @@
-# 🛠️ @apprecio/mcp-cli
-
-CLI para generar features MCP automáticamente siguiendo la estructura de Apprecio.
-
-## 🚀 Instalación
-
-```bash
-# Instalación global
-npm install -g @apprecio/mcp-cli
-
-# O usar npx directamente
-npx @apprecio/mcp-cli feature
-```
-
-## 📖 Uso
-
-### Generar una Feature Completa
-
-```bash
-mcp-generate feature
-```
-
-Este comando iniciará un asistente interactivo que te guiará paso a paso:
-
-```
-🚀 Generador de Features MCP
-
-? Nombre de la feature (ej: giftCards, users, products): products
-? Descripción de la feature: Manage products catalog
-? ¿Necesita un service (lógica de negocio)? Yes
-? Tipo de service: API Client (llamadas HTTP)
-? Selecciona los tools a generar:
-  ◉ list (listar items)
-  ◉ get (obtener un item)
-  ◉ create (crear item)
-  ◉ update (actualizar item)
-  ◯ delete (eliminar item)
-  ◉ search (buscar items)
-? Nombre de la entidad (singular, ej: giftCard, user): product
-? ¿Auto-registrar en main.ts? Yes
-```
-
-### Estructura Generada
-
-El CLI generará la siguiente estructura:
-
-```
-src/features/products/
-├── products.feature.ts       # Router con tools MCP
-├── products.service.ts       # Lógica de negocio
-└── products.validation.ts    # Schemas de validación Zod
-```
-
-#### Ejemplo: `products.feature.ts`
-
-```typescript
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from 'zod';
-import Products from "./products.service.js";
-
-export function registerProductsTools(server: McpServer, productsInstance: Products) {
-
-    server.registerTool(
-        'list_products',
-        {
-            description: 'List all products',
-            inputSchema: {
-                page: z.number().optional().describe('Page number (number, optional)'),
-                per_page: z.number().optional().describe('Results per page (number, optional)'),
-                filters: z.any().optional().describe('Additional filters (object, optional)'),
-            }
-        },
-        async (args, req: any) => {
-            try {
-                const result = await productsInstance.listProducts(args, req.requestInfo?.headers?.authorization);
-                return { 
-                    content: [{ 
-                        type: 'text', 
-                        text: JSON.stringify(result, null, 2) 
-                    }] 
-                };
-            } catch (error: any) {
-                return { 
-                    content: [{ 
-                        type: 'text', 
-                        text: `Error: ${error.message}` 
-                    }], 
-                    isError: true 
-                };
-            }
-        }
-    );
-
-    server.registerTool(
-        'get_product',
-        {
-            description: 'Get a specific product by ID',
-            inputSchema: {
-                id: z.string().describe('product ID (string, required)'),
-            }
-        },
-        async (args, req: any) => {
-            try {
-                const result = await productsInstance.getProduct(args, req.requestInfo?.headers?.authorization);
-                return { 
-                    content: [{ 
-                        type: 'text', 
-                        text: JSON.stringify(result, null, 2) 
-                    }] 
-                };
-            } catch (error: any) {
-                return { 
-                    content: [{ 
-                        type: 'text', 
-                        text: `Error: ${error.message}` 
-                    }], 
-                    isError: true 
-                };
-            }
-        }
-    );
-
-    // ... más tools
-}
-```
-
-#### Ejemplo: `products.service.ts`
-
-```typescript
-import ApiClient from '#services/api';
-import { sanitize } from '../../utils/sanitize.js';
-
-// --- Interfaces para Opciones de Métodos ---
-
-export interface ListProductOptions { page?: number; per_page?: number; filters?: any; }
-export interface GetProductOptions { id: string; }
-export interface CreateProductOptions { data: any; }
-export interface UpdateProductOptions { id: string; data: any; }
-export interface SearchProductOptions { query: string; filters?: any; }
-
-class Products extends ApiClient {
-
-    async listProducts(options: ListProductOptions, token?: string) {
-        const { page = 1, per_page = 10, ...params } = options;
-        return this.get('products', { page, per_page, ...params }, token || '');
-    }
-
-    async getProduct(options: GetProductOptions, token?: string) {
-        const { id } = options;
-        return this.get(`products/${id}`, {}, token || '');
-    }
-
-    async createProduct(options: CreateProductOptions, token?: string) {
-        const { data } = options;
-        // Sanitize data aquí si es necesario
-        return this.post('products', data, token || '');
-    }
-
-    async updateProduct(options: UpdateProductOptions, token?: string) {
-        const { id, data } = options;
-        return this.patch(`products/${id}`, data, token || '');
-    }
-
-    async searchProducts(options: SearchProductOptions, token?: string) {
-        const { query, filters } = options;
-        return this.get('search/products', { q: sanitize(query), ...filters }, token || '');
-    }
-}
-
-export default Products;
-```
-
-#### Ejemplo: `products.validation.ts`
-
-```typescript
-import { z } from 'zod';
-
-// --- Campos Comunes Reutilizables ---
-
-const id = z.string().min(1, "ID is required.");
-const name = z.string().min(1, "Name is required.");
-const description = z.string().optional();
-const page = z.number().int().positive().optional();
-const perPage = z.number().int().positive().optional();
-const query = z.string().min(1, "Query is required.");
-
-// --- Schemas de Validación por Tool ---
-
-export const listProductSchema = z.object({
-    page,
-    perPage,
-    // TODO: Agregar filtros específicos
-});
-
-export const getProductSchema = z.object({
-    id,
-});
-
-export const createProductSchema = z.object({
-    name,
-    description,
-    // TODO: Agregar campos específicos del product
-});
-
-export const updateProductSchema = z.object({
-    id,
-    name: z.string().optional(),
-    description,
-    // TODO: Agregar campos actualizables
-});
-
-export const searchProductSchema = z.object({
-    query,
-    page,
-    perPage,
-});
-```
-
-### Auto-registro en main.ts
-
-Si seleccionaste "Yes" en auto-registrar, el CLI actualizará automáticamente tu `main.ts`:
-
-```typescript
-// Services imports
-import Products from './features/products/products.service.js';
-
-// Feature imports
-import { registerProductsTools } from './features/products/products.feature.js';
-
-class ApprecioMcpServer extends McpBaseServer {
-    private productsInstance = new Products();
-
-    protected async registerFeatures(): Promise<void> {
-        registerProductsTools(this.mcpServer, this.productsInstance);
-        
-        logger.info('All Apprecio features registered successfully');
-    }
-}
-```
-
-## 📋 Comandos Disponibles
-
-### `mcp-generate feature`
-
-Genera una feature completa con router, service y validation.
-
-**Opciones interactivas:**
-- Nombre de la feature
-- Descripción
-- Tipo de service (API, Database, Mixed, Custom)
-- Tools a generar (list, get, create, update, delete, search)
-- Nombre de la entidad
-- Auto-registro en main.ts
-
-### `mcp-generate tool`
-
-Agrega un tool adicional a una feature existente.
-
-```bash
-mcp-generate tool
-```
-
-**Opciones interactivas:**
-- Seleccionar feature existente
-- Nombre del tool
-- Descripción
-- ¿Agregar método al service?
-
-## 🎨 Tipos de Service
-
-### API Client
-Genera un service que hereda de `ApiClient` para hacer llamadas HTTP.
-
-```typescript
-class Products extends ApiClient {
-    async listProducts(options, token) {
-        return this.get('products', { page: 1 }, token);
-    }
-}
-```
-
-### Database (MongoDB)
-Genera un service para operaciones directas con MongoDB.
-
-```typescript
-class Products {
-    constructor(db: MongoDBConnector) {
-        this.db = db;
-    }
-    
-    async listProducts(options) {
-        const collection = this.db.getCollection('products');
-        return collection.find({}).toArray();
-    }
-}
-```
-
-### Mixed (API + Database)
-Combina ambos tipos para casos híbridos.
-
-### Custom
-Genera un service vacío para implementación personalizada.
-
-## 🔧 Personalización
-
-### Modificar Templates
-
-Los generadores están en:
-```
-cli/generators/
-├── feature-generator.ts
-├── service-generator.ts
-├── router-generator.ts
-└── validation-generator.ts
-```
-
-Puedes modificarlos para ajustar la estructura generada.
-
-### Agregar Nuevos Tool Types
-
-Edita `router-generator.ts` y agrega tu tipo custom:
-
-```typescript
-const toolMap = {
-    'list': '...',
-    'get': '...',
-    'approve': 'Approve an item',  // ← Nuevo
-};
-```
-
-## 📝 Ejemplo Completo de Uso
-
-```bash
-# 1. Crear proyecto MCP
-mkdir my-mcp-server
-cd my-mcp-server
-npm init -y
-
-# 2. Instalar dependencias
-npm install @apprecio/mcp-base
-npm install -D @apprecio/mcp-cli
-
-# 3. Generar primera feature
-npx mcp-generate feature
-# Nombre: users
-# Tools: list, get, create, update
-# Service type: Database
-
-# 4. Generar segunda feature
-npx mcp-generate feature
-# Nombre: products
-# Tools: list, get, search
-# Service type: API Client
-
-# 5. Agregar tool custom a users
-npx mcp-generate tool
-# Feature: users
-# Tool: verify_email
-# Descripción: Send verification email
-
-# 6. Ejecutar servidor
-npm run dev
-```
-
-## 🎯 Best Practices
-
-1. **Nombres descriptivos**: Usa nombres claros en camelCase
-2. **Un feature por dominio**: No mezcles conceptos diferentes
-3. **Valida todo**: Las validaciones Zod son tu primera línea de defensa
-4. **Sanitiza inputs**: Siempre sanitiza datos de usuario
-5. **Maneja errores**: Cada tool debe tener try/catch
-
-## 🆘 Troubleshooting
-
-### Error: "Feature already exists"
-
-El directorio ya existe. Elimínalo o usa otro nombre.
-
-```bash
-rm -rf src/features/myfeature
-```
-
-### Error: "Cannot find main.ts"
-
-Asegúrate de ejecutar el CLI desde la raíz del proyecto.
-
-```bash
-cd /ruta/a/tu/proyecto
-npx mcp-generate feature
-```
-
-### Los imports no funcionan
-
-Verifica que tengas los path aliases configurados en `tsconfig.json`:
-
-```json
-{
-  "compilerOptions": {
-    "baseUrl": ".",
-    "paths": {
-      "#services/*": ["./src/services/*"],
-      "#features/*": ["./src/features/*"]
-    }
-  }
-}
-```
-
-## 📦 Publicación
-
-Para publicar el CLI en npm privado:
-
-```bash
-cd cli
-npm run build
-npm publish
-```
-
-## 🤝 Contribuir
-
-1. Fork el repositorio
-2. Crea una rama: `git checkout -b feature/nueva-funcionalidad`
-3. Commit: `git commit -am 'Add nueva funcionalidad'`
-4. Push: `git push origin feature/nueva-funcionalidad`
-5. Pull Request
-
-## 📄 Licencia
-
-MIT
-
----
-
-**Desarrollado por el equipo de Apprecio** 🚀