Chatbot IA, Serveur MCP construit avec le Protocole de Flux de Travail Agentique pour démo sur 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

// Outil MCP: Obtenir les détails de chaudières du client et informations de garantie
const boilerInfoTool = {
  name: "boiler-info",
  description: "Obtenir les informations de chaudières du client et détails de garantie",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" }
    },
    required: ["customer_id"]
  }
}

// Outil MCP: Planifier les services de maintenance avec considération météo
const maintenanceTool = {
  name: "maintenance",
  description: "Planifier les services de maintenance",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" },
      service_type: { type: "string", enum: ["routine", "emergency"] },
      preferred_date: { type: "string" }
    },
    required: ["customer_id", "service_type"]
  }
}

// Outil MCP: Traiter les commandes d'achat de chaudières
const purchaseTool = {
  name: "purchase",
  description: "Traiter les commandes d'achat de chaudières",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" },
      boiler_model: { type: "string" },
      installation_date: { type: "string" }
    },
    required: ["customer_id", "boiler_model"]
  }
}

// Outil MCP: Envoyer des emails de confirmation
const emailTool = {
  name: "email",
  description: "Envoyer des emails de confirmation",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" },
      email_type: { type: "string", enum: ["maintenance", "purchase", "reminder"] }
    },
    required: ["customer_id", "email_type"]
  }
}

Je vais vérifier les informations de votre chaudière immédiatement.

Selon vos dossiers, vous avez une Worcester Bosch 8000 Style installée le 15 mars 2023. 
Votre garantie est valide jusqu'au 15 mars 2028 (garantie fabricant de 5 ans).

Détails clés:
- Modèle: Worcester Bosch 8000 Style 30kW
- Date d'Installation: 15 mars 2023
- Statut de Garantie: Actif (3 ans restants)
- Dernier Service: 12 janvier 2024
- Prochain Service: 12 janvier 2025

Voulez-vous que je planifie votre service annuel ou vérifie s'il y a des réclamations de garantie?

Je vais vous aider à planifier la maintenance de votre chaudière. Laissez-moi vérifier votre planning actuel et les créneaux disponibles.

Selon votre localisation et préférences, j'ai trouvé ces rendez-vous disponibles:

Semaine Prochaine:
- Mardi 21 janvier: 9h00 - 11h00
- Jeudi 23 janvier: 14h00 - 16h00

Les prévisions météo montrent des conditions claires pour les deux jours. Votre technicien préféré, John Smith (enregistré Gas Safe), est disponible mardi.

Je recommande mardi à 9h00. Le service inclura:
- Inspection complète du système
- Vérifications de sécurité
- Tests d'efficacité
- Nettoyage des filtres

Coût: £120 (inclut pièces et main d'œuvre)

Dois-je réserver ce rendez-vous pour vous?

Excellent choix! Laissez-moi vous montrer les modèles les plus efficaces disponibles et vous aider avec la mise à niveau.

Chaudières Haute Efficacité Disponibles:

1. **Worcester Bosch 8000 Style** (Classe A)
   - Efficacité: 94%
   - Prix: £2,800
   - Garantie 10 ans
   - Thermostat intelligent inclus

2. **Vaillant ecoTEC plus** (Classe A)
   - Efficacité: 92%
   - Prix: £2,600
   - Garantie 7 ans
   - Design compact

3. **Ideal Logic+** (Classe A)
   - Efficacité: 90%
   - Prix: £2,200
   - Garantie 10 ans
   - Certifié Quiet Mark

Basé sur votre système actuel, je recommande la Worcester Bosch 8000 Style pour une efficacité et fiabilité maximales.

Voulez-vous que je:
1. Montre les spécifications détaillées
2. Vérifie la disponibilité d'installation
3. Traite l'achat
4. Compare avec votre chaudière actuelle

---
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"
    }
  }
}

📊 RÉSUMÉ DES TESTS
============================================================
Total des Tests: 5
Réussis: 5 ✅
Échoués: 0 ❌
Taux de Succès: 100.0%

📋 RÉSULTATS DÉTAILLÉS
------------------------------------------------------------
1. boiler-info: ✅ RÉUSSI
2. maintenance-get: ✅ RÉUSSI
3. maintenance-schedule: ✅ RÉUSSI
4. purchase: ✅ RÉUSSI
5. email: ✅ RÉUSSI

🎉 Tous les tests ont réussi! Les outils MCP fonctionnent correctement.

# Exécuter tous les tests d'outils MCP
npm test

# Tester des composants spécifiques
npm run test:api          # Tests API backend
npm run test:mcp          # Intégration MCP Cursor
npm run test:protocol     # Validation protocole MCP
npm run test:compiled     # Test version compilée
npm run test:connection   # Test connexion
npm run test:quick        # Vérification rapide santé

# Cloner le repository
git clone https://github.com/michaelwybraniec/mcp-in-chat.git
cd mcp-in-chat

# Installer les dépendances
npm install

# Construire le projet
npm run build

# Démarrer le serveur API
npm run start:api

# Démarrer le serveur MCP (dans un autre terminal)
npm run start:mcp