product-catalog-mcp

The-Dave-Stack/product-catalog-mcp

3.1

If you are the rightful owner of product-catalog-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A sophisticated MCP server for comprehensive product catalog management, showcasing advanced Resources, Prompts, and Tools implementation patterns.

Tools
3
Resources
0
Prompts
0

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.