Product Catalog MCP Server / Servidor MCP de Catálogo de Productos

English

A sophisticated MCP (Model Context Protocol) server for comprehensive product catalog management, showcasing advanced Resources, Prompts, and Tools implementation patterns.

🎯 Purpose

This server demonstrates professional MCP development patterns with emphasis on Resources and Prompts over simple Tools. Perfect for:

• Blog posts and tutorials about advanced MCP patterns
• E-commerce catalog management with AI integration
• Learning complex MCP workflows with real business scenarios
• International development with English-standard terminology

🏗️ Architecture

Built around the three MCP pillars:

📊 Resources (Primary Focus)

Advanced resource patterns with URI templates and intelligent data aggregation:

catalog://categories              - Complete category hierarchy
product://details/{productId}    - Detailed product information
inventory://stock/{category}     - Category-based inventory status
analytics://sales/{period}       - Sales analytics by period
catalog://products/{category}/{subcategory} - Filtered product lists
analytics://comparison/{id1}/vs/{id2}       - Product comparisons
supplier://portfolio/{supplierId}           - Supplier performance
catalog://insights                           - Intelligent catalog analysis

🤖 Prompts (Business Workflows)

Sophisticated business process automation:

• priceOptimization: Comprehensive pricing strategy analysis with competitive intelligence
• inventoryReview: Multi-phase inventory management with urgency protocols
• competitorAnalysis: Deep competitive analysis with strategic recommendations

🛠️ Tools (Supporting Actions)

Essential catalog management operations:

• updateProductPrice: Price updates with business validations
• createProduct: Product creation with comprehensive validation
• manageInventory: Inventory operations with full traceability

🚀 Quick Start

1. Install dependencies:

   npm install

2. Build the server:

   npm run build

3. Run the server:

   npm start

📝 Usage Examples

Resource Queries

// Get complete category structure
await client.readResource('catalog://categories');

// Get specific product details
await client.readResource('product://details/prod_001');

// Get sales analytics for monthly period
await client.readResource('analytics://sales/monthly');

// Compare two products
await client.readResource('analytics://comparison/prod_001/vs/prod_002');

Prompt Workflows

// Price optimization analysis
await client.getPrompt('priceOptimization', {
  category: 'electronics',
  strategy: 'competitive',
  timeframe: 'quarterly'
});

// Inventory review with critical urgency
await client.getPrompt('inventoryReview', {
  urgency: 'critical',
  includeRecommendations: true
});

Tool Operations

// Update product price with validation
await client.callTool('updateProductPrice', {
  productId: 'prod_001',
  newPrice: 299.99,
  reason: 'competitor_match'
});

🔧 Development

• Language: TypeScript v5.9.2 with strict configuration
• Validation: Zod v4.0.1 schemas with native JSON Schema generation (14.7x performance improvement)
• Architecture: Class-based with clean separation of concerns
• Testing: npm test (ensure you have test framework configured)
• Linting: npm run lint (if available)

---

Español

Un servidor MCP (Model Context Protocol) sofisticado para gestión integral de catálogos de productos, que demuestra patrones avanzados de implementación de Resources, Prompts y Tools.

🎯 Propósito

Este servidor demuestra patrones profesionales de desarrollo MCP con énfasis en Resources y Prompts por encima de Tools simples. Perfecto para:

• Artículos de blog y tutoriales sobre patrones MCP avanzados
• Gestión de catálogos e-commerce con integración de IA
• Aprender workflows MCP complejos con escenarios de negocio reales
• Desarrollo internacional con terminología estándar en inglés

🏗️ Arquitectura

Construido alrededor de los tres pilares MCP:

📊 Resources (Enfoque Principal)

Patrones avanzados de recursos con plantillas URI y agregación inteligente de datos:

catalog://categories              - Jerarquía completa de categorías
product://details/{productId}    - Información detallada del producto
inventory://stock/{category}     - Estado de inventario por categoría
analytics://sales/{period}       - Analytics de ventas por período
catalog://products/{category}/{subcategory} - Listas de productos filtradas
analytics://comparison/{id1}/vs/{id2}       - Comparaciones de productos
supplier://portfolio/{supplierId}           - Rendimiento de proveedores
catalog://insights                           - Análisis inteligente del catálogo

🤖 Prompts (Workflows de Negocio)

Automatización sofisticada de procesos empresariales:

• priceOptimization: Análisis integral de estrategia de precios con inteligencia competitiva
• inventoryReview: Gestión de inventario multi-fase con protocolos de urgencia
• competitorAnalysis: Análisis competitivo profundo con recomendaciones estratégicas

🛠️ Tools (Acciones de Soporte)

Operaciones esenciales de gestión de catálogo:

• updateProductPrice: Actualizaciones de precios con validaciones de negocio
• createProduct: Creación de productos con validación integral
• manageInventory: Operaciones de inventario con trazabilidad completa

🚀 Inicio Rápido

1. Instalar dependencias:

   npm install

2. Construir el servidor:

   npm run build

3. Ejecutar el servidor:

   npm start

📝 Ejemplos de Uso

Consultas de Resources

// Obtener estructura completa de categorías
await client.readResource('catalog://categories');

// Obtener detalles específicos del producto
await client.readResource('product://details/prod_001');

// Obtener analytics de ventas para período mensual
await client.readResource('analytics://sales/monthly');

// Comparar dos productos
await client.readResource('analytics://comparison/prod_001/vs/prod_002');

Workflows de Prompts

// Análisis de optimización de precios
await client.getPrompt('priceOptimization', {
  category: 'electronics',
  strategy: 'competitive',
  timeframe: 'quarterly'
});

// Revisión de inventario con urgencia crítica
await client.getPrompt('inventoryReview', {
  urgency: 'critical',
  includeRecommendations: true
});

Operaciones de Tools

// Actualizar precio del producto con validación
await client.callTool('updateProductPrice', {
  productId: 'prod_001',
  newPrice: 299.99,
  reason: 'competitor_match'
});

🔧 Desarrollo

• Lenguaje: TypeScript v5.9.2 con configuración estricta
• Validación: Esquemas Zod v4.0.1 con generación nativa de JSON Schema (mejora de rendimiento 14.7x)
• Arquitectura: Basada en clases con separación limpia de responsabilidades
• Testing: npm test (asegúrate de tener configurado el framework de testing)
• Linting: npm run lint (si está disponible)

---

Features / Características

✨ Advanced MCP Patterns / Patrones MCP Avanzados

• Dynamic URI Templates: Flexible resource addressing with parameter extraction
• Business Process Prompts: Complex workflows with multi-step analysis
• Intelligent Data Aggregation: Smart resource composition and insights
• Professional Validation: Comprehensive Zod schemas with business rules
• Scalable Architecture: Clean separation for enterprise-ready deployment

🔍 Technical Excellence / Excelencia Técnica

• TypeScript Strict Mode: Maximum type safety and code quality
• Error Handling: Comprehensive validation and user-friendly error messages
• Documentation: Extensive inline documentation and usage examples
• Industry Standards: Professional English terminology throughout
• Extensibility: Modular design for easy feature addition

🎓 Learning Resource / Recurso de Aprendizaje

Perfect for understanding:

• Advanced MCP server development patterns
• Business process automation with AI
• Professional TypeScript development
• E-commerce domain modeling
• International software development practices

Perfecto para entender:

• Patrones avanzados de desarrollo de servidores MCP
• Automatización de procesos empresariales con IA
• Desarrollo profesional en TypeScript
• Modelado de dominio e-commerce
• Prácticas de desarrollo de software internacional

License / Licencia

MIT License - Feel free to use this code as a learning resource and foundation for your own MCP servers.

Licencia MIT - Siéntete libre de usar este código como recurso de aprendizaje y base para tus propios servidores MCP.