AI Chat, MCP Server build with Agentic Workflow Protocol for demo at 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

// MCP Tool: Get customer boiler details and warranty information
const boilerInfoTool = {
  name: "boiler-info",
  description: "Get customer boiler information and warranty details",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" }
    },
    required: ["customer_id"]
  }
}

// MCP Tool: Schedule maintenance services with weather consideration
const maintenanceTool = {
  name: "maintenance",
  description: "Schedule maintenance services",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" },
      service_type: { type: "string", enum: ["routine", "emergency"] },
      preferred_date: { type: "string" }
    },
    required: ["customer_id", "service_type"]
  }
}

// MCP Tool: Process boiler purchase orders
const purchaseTool = {
  name: "purchase",
  description: "Process boiler purchase orders",
  inputSchema: {
    type: "object",
    properties: {
      customer_id: { type: "string" },
      boiler_model: { type: "string" },
      installation_date: { type: "string" }
    },
    required: ["customer_id", "boiler_model"]
  }
}

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

I'll check your boiler information right away.

Based on your records, you have a Worcester Bosch 8000 Style installed on March 15, 2023. 
Your warranty is valid until March 15, 2028 (5-year manufacturer warranty).

Key details:
- Model: Worcester Bosch 8000 Style 30kW
- Installation Date: March 15, 2023
- Warranty Status: Active (3 years remaining)
- Last Service: January 12, 2024
- Next Service Due: January 12, 2025

Would you like me to schedule your annual service or check if there are any warranty claims?

I'll help you schedule maintenance for your boiler. Let me check your current schedule and available slots.

Based on your location and preferences, I found these available appointments:

Next Week:
- Tuesday, January 21: 9:00 AM - 11:00 AM
- Thursday, January 23: 2:00 PM - 4:00 PM

Weather forecast shows clear conditions for both days. Your preferred technician, John Smith (Gas Safe registered), is available on Tuesday.

I recommend Tuesday at 9:00 AM. The service will include:
- Full system inspection
- Safety checks
- Efficiency testing
- Filter cleaning

Cost: £120 (includes parts and labor)

Shall I book this appointment for you?

Great choice! Let me show you the most efficient models available and help you upgrade.

Available High-Efficiency Boilers:

1. **Worcester Bosch 8000 Style** (A-Rated)
   - Efficiency: 94%
   - Price: £2,800
   - 10-year warranty
   - Smart thermostat included

2. **Vaillant ecoTEC plus** (A-Rated)
   - Efficiency: 92%
   - Price: £2,600
   - 7-year warranty
   - Compact design

3. **Ideal Logic+** (A-Rated)
   - Efficiency: 90%
   - Price: £2,200
   - 10-year warranty
   - Quiet Mark certified

Based on your current system, I recommend the Worcester Bosch 8000 Style for maximum efficiency and reliability.

Would you like me to:
1. Show detailed specifications
2. Check installation availability
3. Process the purchase
4. Compare with your current boiler

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

📊 TEST SUMMARY
============================================================
Total Tests: 5
Passed: 5 ✅
Failed: 0 ❌
Success Rate: 100.0%

📋 DETAILED RESULTS
------------------------------------------------------------
1. boiler-info: ✅ PASS
2. maintenance-get: ✅ PASS
3. maintenance-schedule: ✅ PASS
4. purchase: ✅ PASS
5. email: ✅ PASS

🎉 All tests passed! MCP tools are working correctly.

# Run all MCP tool tests
npm test

# Test specific components
npm run test:api          # Backend API tests
npm run test:mcp          # Cursor MCP integration
npm run test:protocol     # MCP protocol validation
npm run test:compiled     # Compiled version test
npm run test:connection   # Connection test
npm run test:quick        # Quick health check

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

# Install dependencies
npm install

# Build the project
npm run build

# Start the API server
npm run start:api

# Start the MCP server (in another terminal)
npm run start:mcp