Chatbot IA, Servidor MCP construido con Protocolo de Flujo de Trabajo Agéntico para demo en Checkatrade.com

---
header: MCP-in-Chat System Architecture
legend:
  - color: "#3B82F6"
    text: "External Systems"
  - color: "#8B5CF6"
    text: "MCP Protocol Layer"
  - color: "#10B981"
    text: "API & Security Layer"
  - color: "#F59E0B"
    text: "Business Services"
  - color: "#EF4444"
    text: "Data Layer"
---
graph TD
    subgraph "External Chatbots"
        A[Claude AI]
        B[ChatGPT]
        C[Cursor IDE]
    end
    
    subgraph "MCP Server Layer"
        D[MCP Server]
        E[Boiler Info Tool]
        F[Maintenance Tool]
        G[Purchase Tool]
        H[Email Tool]
    end
    
    subgraph "Backend API Layer"
        I[Express API Server]
        J[Authentication]
        K[Validation]
        L[Rate Limiting]
    end
    
    subgraph "Business Services"
        M[Customer Service]
        N[Boiler Service]
        O[Payment Service]
        P[Email Service]
    end
    
    subgraph "Mock Data Layer"
        Q[Customers JSON]
        R[Boilers JSON]
        S[Inventory JSON]
        T[Orders JSON]
    end
    
    A --> D
    B --> D
    C --> D
    D --> E
    D --> F
    D --> G
    D --> H
    E --> I
    F --> I
    G --> I
    H --> I
    I --> J
    J --> K
    K --> L
    L --> M
    L --> N
    L --> O
    L --> P
    M --> Q
    N --> R
    O --> S
    P --> T
    
    classDef external fill:#3B82F6,stroke:#1E40AF,stroke-width:2px,color:#fff
    classDef mcp fill:#8B5CF6,stroke:#7C3AED,stroke-width:2px,color:#fff
    classDef api fill:#10B981,stroke:#059669,stroke-width:2px,color:#fff
    classDef service fill:#F59E0B,stroke:#D97706,stroke-width:2px,color:#fff
    classDef data fill:#EF4444,stroke:#DC2626,stroke-width:2px,color:#fff
    
    class A,B,C external
    class D,E,F,G,H mcp
    class I,J,K,L api
    class M,N,O,P service
    class Q,R,S,T data

// Herramienta MCP: Obtener detalles de calderas del cliente e información de garantía
const boilerInfoTool = {
  name: "boiler-info",
  description: "Obtener información de calderas del cliente y detalles de garantía",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" }
    },
    required: ["customer_id"]
  }
}

// Herramienta MCP: Programar servicios de mantenimiento con consideración del clima
const maintenanceTool = {
  name: "maintenance",
  description: "Programar servicios de mantenimiento",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" },
      service_type: { type: "string", enum: ["routine", "emergency"] },
      preferred_date: { type: "string" }
    },
    required: ["customer_id", "service_type"]
  }
}

// Herramienta MCP: Procesar órdenes de compra de calderas
const purchaseTool = {
  name: "purchase",
  description: "Procesar órdenes de compra de calderas",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" },
      boiler_model: { type: "string" },
      installation_date: { type: "string" }
    },
    required: ["customer_id", "boiler_model"]
  }
}

// Herramienta MCP: Enviar emails de confirmación
const emailTool = {
  name: "email",
  description: "Enviar emails de confirmación",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" },
      email_type: { type: "string", enum: ["maintenance", "purchase", "reminder"] }
    },
    required: ["customer_id", "email_type"]
  }
}

Revisaré la información de tu caldera inmediatamente.

Según tus registros, tienes una Worcester Bosch 8000 Style instalada el 15 de marzo de 2023. 
Tu garantía es válida hasta el 15 de marzo de 2028 (garantía del fabricante de 5 años).

Detalles clave:
- Modelo: Worcester Bosch 8000 Style 30kW
- Fecha de Instalación: 15 de marzo de 2023
- Estado de Garantía: Activa (3 años restantes)
- Último Servicio: 12 de enero de 2024
- Próximo Servicio: 12 de enero de 2025

¿Te gustaría que programe tu servicio anual o verifique si hay reclamos de garantía?

Te ayudo a programar mantenimiento para tu caldera. Déjame revisar tu horario actual y espacios disponibles.

Según tu ubicación y preferencias, encontré estas citas disponibles:

Próxima Semana:
- Martes, 21 de enero: 9:00 AM - 11:00 AM
- Jueves, 23 de enero: 2:00 PM - 4:00 PM

El pronóstico del clima muestra condiciones claras para ambos días. Tu técnico preferido, John Smith (registrado Gas Safe), está disponible el martes.

Recomiendo martes a las 9:00 AM. El servicio incluirá:
- Inspección completa del sistema
- Verificaciones de seguridad
- Pruebas de eficiencia
- Limpieza de filtros

Costo: £120 (incluye repuestos y mano de obra)

¿Reservo esta cita para ti?

¡Excelente elección! Déjame mostrarte los modelos más eficientes disponibles y ayudarte con la actualización.

Calderas de Alta Eficiencia Disponibles:

1. **Worcester Bosch 8000 Style** (Clasificación A)
   - Eficiencia: 94%
   - Precio: £2,800
   - Garantía de 10 años
   - Termostato inteligente incluido

2. **Vaillant ecoTEC plus** (Clasificación A)
   - Eficiencia: 92%
   - Precio: £2,600
   - Garantía de 7 años
   - Diseño compacto

3. **Ideal Logic+** (Clasificación A)
   - Eficiencia: 90%
   - Precio: £2,200
   - Garantía de 10 años
   - Certificado Quiet Mark

Basándome en tu sistema actual, recomiendo la Worcester Bosch 8000 Style para máxima eficiencia y confiabilidad.

¿Te gustaría que:
1. Muestre especificaciones detalladas
2. Verifique disponibilidad de instalación
3. Procese la compra
4. Compare con tu caldera actual

---
header: MCP Security Flow and Authentication
---
sequenceDiagram
    participant Chatbot as External Chatbot
    participant MCP as MCP Server
    participant API as Backend API
    participant Auth as Authentication
    participant Service as Business Service
    participant DB as Mock Database
    
    rect rgb(59, 130, 246)
    note right of Chatbot: External Systems
    Chatbot->>+MCP: Request with customer_id
    end
    
    rect rgb(139, 92, 246)
    note right of MCP: MCP Protocol Layer
    MCP->>+API: API call with validation
    end
    
    rect rgb(16, 185, 129)
    note right of API: Security & API Layer
    API->>+Auth: Verify authentication
    Auth-->>-API: Authentication result
    end
    
    rect rgb(245, 158, 11)
    note right of Service: Business Logic Layer
    API->>+Service: Process business logic
    Service->>+DB: Query with access controls
    end
    
    rect rgb(239, 68, 68)
    note right of DB: Data Storage Layer
    DB-->>-Service: Return filtered data
    end
    
    rect rgb(245, 158, 11)
    note right of Service: Business Logic Layer
    Service-->>-API: Processed response
    end
    
    rect rgb(16, 185, 129)
    note right of API: Security & API Layer
    API-->>-MCP: API response
    end
    
    rect rgb(139, 92, 246)
    note right of MCP: MCP Protocol Layer
    MCP-->>-Chatbot: Formatted result
    end
    
    Note over Chatbot,DB: Secure communication flow with<br/>authentication at each layer

{
  "customers": {
    "CUST001": {
      "name": "John Smith",
      "email": "john.smith@email.com",
      "address": "123 Main St, London",
      "phone": "+44 20 1234 5678",
      "preferences": {
        "contact_method": "email",
        "appointment_time": "morning",
        "technician_preference": "John Smith"
      }
    }
  },
  "boilers": {
    "BOIL001": {
      "customer_id": "CUST001",
      "model": "Worcester Bosch 8000 Style",
      "installation_date": "2023-03-15",
      "warranty_expiry": "2028-03-15",
      "last_service": "2024-01-12",
      "next_service_due": "2025-01-12"
    }
  }
}

📊 RESUMEN DE PRUEBAS
============================================================
Total de Pruebas: 5
Pasadas: 5 ✅
Fallidas: 0 ❌
Tasa de Éxito: 100.0%

📋 RESULTADOS DETALLADOS
------------------------------------------------------------
1. boiler-info: ✅ PASÓ
2. maintenance-get: ✅ PASÓ
3. maintenance-schedule: ✅ PASÓ
4. purchase: ✅ PASÓ
5. email: ✅ PASÓ

🎉 ¡Todas las pruebas pasaron! Las herramientas MCP están funcionando correctamente.

# Ejecutar todas las pruebas de herramientas MCP
npm test

# Probar componentes específicos
npm run test:api          # Pruebas de API backend
npm run test:mcp          # Integración MCP de Cursor
npm run test:protocol     # Validación de protocolo MCP
npm run test:compiled     # Prueba de versión compilada
npm run test:connection   # Prueba de conexión
npm run test:quick        # Verificación rápida de salud

# Clonar el repositorio
git clone https://github.com/michaelwybraniec/mcp-in-chat.git
cd mcp-in-chat

# Instalar dependencias
npm install

# Construir el proyecto
npm run build

# Iniciar el servidor API
npm run start:api

# Iniciar el servidor MCP (en otra terminal)
npm run start:mcp