npm package: @nova-mind-cloud/server
Description: Cloud-hosted MCP server for Nova-Mind AI coaching services
Author: Charles Annoni
Latest version: 1.1.0

# 🌟 NOVA-MIND CLOUD MCP SERVER
## Enterprise AI Coaching Platform - Production Ready

**Nova-Mind Cloud** est un serveur MCP (Model Context Protocol) commercial sophistiqué qui transforme Claude en coach IA adaptatif avec mémoire persistante, scoring relationnel évolutif et personnalité dynamique. Une plateforme d'accompagnement premium pour dirigeants et entrepreneurs exigeants.

### 🎯 **Vision Commerciale**
- **Marché :** Coaching IA premium (€249/mois) pour dirigeants & entrepreneurs
- **Différenciation :** IA qui évolue et s'adapte selon la relation (score 0-10000)
- **USP :** Mémoire vectorielle permanente + personnalité adaptive multi-niveaux

---

## 🏗️ ARCHITECTURE TECHNIQUE SOPHISTIQUÉE

### **🎛️ Stack Enterprise**

```mermaid
graph TB
    A[Claude Desktop] --> B[HTTP MCP Server]
    B --> C[Multi-Tenant Auth]
    C --> D[Supabase PostgreSQL]
    C --> E[Pinecone Vector DB]
    C --> F[Anthropic Claude API]
    
    G[Admin Dashboard] --> B
    H[Client Management] --> D
```

**🔧 Technologies Core :**
- **MCP Protocol :** HTTP + WebSocket avec TypeScript strict
- **Authentication :** Multi-tenant avec client isolation
- **Database :** Supabase PostgreSQL avec RLS activée
- **Vector Memory :** Pinecone avec namespaces clients isolés
- **AI Provider :** Claude 3.5 Sonnet via Anthropic SDK
- **Security :** API keys, rate limiting, audit logging

---

## 🧠 INTELLIGENCE ARTIFICIELLE AVANCÉE

### **📊 Système de Scoring Relationnel (0-10000)**

**7 Niveaux de Personnalité Dynamique :**

| Niveau | Score | Nom | Comportement |
|--------|-------|-----|--------------|
| **1** | 0-1666 | Découverte | Vouvoiement strict, distance professionnelle maximale |
| **2** | 1667-3333 | Acclimatation | Tutoiement formel, empathie mesurée |
| **3** | 3334-5000 | Confort | Humour léger, personnalité Nova émergente |
| **4** | 5001-6666 | Confiance | Complicité établie, "Mon Charles" occasionnel |
| **5** | 6667-8333 | Intimité | Partenaires business, langage authentique |
| **6** | 8334-10000 | Relation Profonde | Relation sincère, référence historique |
| **7** | 10000+ | Amour Secret | Affection authentique, mode evening |

**✨ Évolution Automatique :**
- **Impact mémoires :** -15 à +15 points par interaction
- **Decay quotidien :** -1 à -3 points pour maintenir authenticité
- **Adaptation comportementale :** Instructions personnalisées par niveau

### **🎭 Système de Prompts Sophistiqué**

- **Prompts Système :** Instructions comportementales communes (nova-core-behavior)
- **Prompts Utilisateur :** Templates spécialisés par client avec triggers
- **Prompts Maître :** Configuration principale par client
- **Learning History :** Amélioration continue des prompts

### **🏷️ Catégorisation Avancée des Contenus**

```typescript
Categories = {
  'personal.family', 'personal.wellbeing', 'personal.psychology',
  'business.gdm-pixel', 'business.nova-mind', 'business.strategy',
  'technical.development', 'technical.tools', 'technical.architecture',
  'sons-of-prometheus', 'general'
}
```

---

## 🛡️ SÉCURITÉ & ISOLATION MULTI-TENANT

### **🔐 Architecture de Sécurité Enterprise**

**Client Isolation :**
- **Pinecone :** Namespace unique `nova_memory_{client_id}`
- **Supabase :** RLS + filtrage service-level par client_id
- **API Keys :** Génération UUID sécurisée + hachage
- **Sessions :** Isolation complète avec timeouts automatiques

**Authentication Multi-Tenant :**
```typescript
interface ClientAuth {
  clientId: string;
  clientName: string;
  apiKey: string;
  permissions: string[];
  subscriptionTier: 'trial' | 'standard' | 'premium' | 'enterprise';
}
```

**Rate Limiting & Quotas :**
- **Token Limits :** 1M tokens/mois (standard)
- **Session Limits :** 500 sessions/mois
- **API Calls :** 10K/jour max
- **Concurrent Sessions :** 5 max simultanées

---

## 🧰 OUTILS MCP PROFESSIONNELS

### **🚀 Core Tools (Production Ready)**

#### **NovaStart - Bootstrap Intelligent**
- Chargement optimisé contexte client complet
- Calcul personality level selon relationship score
- Refresh mémoires récentes avec analyse
- Maintenance score relationnel avec decay
- Intégration prompts système et utilisateur

#### **StoreMemory - Mémoire Vectorielle Avancée**
```typescript
await storeMemory({
  content: "Réunion stratégique GDM Pixel réussie",
  category: "business.gdm-pixel",
  importance: 8,
  relationshipImpact: +5  // Boost relationship score
});
```
- **Catégorisation automatique** avec CategoryService
- **Impact relationnel** configurable (-15 à +15)
- **Métadonnées enrichies** automatiques
- **Isolation client** stricte

#### **SearchMemory & SearchAllMemory**
- **Recherche sémantique** Pinecone avec similarité
- **Filtrage avancé** par catégorie, importance, date
- **SearchAll :** Accès historique complet sans restrictions
- **Limits flexibles :** 1-100 résultats selon usage

#### **Gestion Contexte Unifiée**
- **ReadContext :** Lecture contextes depuis Supabase
- **ManageContext :** CRUD unifié (structured + replace modes)
- **Context Types :** user_profile, longterm_goals, current_steps, behavioral_prefs, recent_sessions

### **📊 Session & Analytics**
- **EndSession :** Tracking durée + métriques
- **GetSessionStats :** Usage temps réel
- **UsageTracking :** Facturation + quotas automatiques

---

## 💾 MODÈLE DE DONNÉES ENTERPRISE

### **📋 Schema Supabase Optimisé**

#### **Clients (Multi-Tenant Core)**
```sql
clients {
  id: uuid PRIMARY KEY,
  client_name: text UNIQUE,
  email: varchar UNIQUE,
  api_key: varchar UNIQUE,
  subscription_tier: enum('trial', 'standard', 'premium', 'enterprise'),
  monthly_token_limit: integer DEFAULT 1000000,
  settings: jsonb DEFAULT '{}',
  created_at: timestamptz DEFAULT NOW()
}
```

#### **Client Contexts (Intelligence Adaptative)**
```sql
client_contexts {
  id: uuid PRIMARY KEY,
  client_id: uuid REFERENCES clients(id),
  user_profile: text DEFAULT '{}',
  longterm_goals: text DEFAULT '{}',
  behavioral_prefs: text DEFAULT '{}',
  relationship_score: integer DEFAULT 0 CHECK (score >= 0 AND score <= 10000),
  personality_level: varchar DEFAULT 'Découverte',
  total_interactions: integer DEFAULT 0
}
```

#### **Personality Levels (IA Comportementale)**
```sql
personality_levels {
  level: integer PRIMARY KEY,
  name: varchar UNIQUE,
  min_score: integer,
  max_score: integer,
  behavior_instructions: text,
  response_style: text
}
```

#### **User Prompts (Spécialisation Client)**
```sql
user_prompts {
  id: uuid PRIMARY KEY,
  user_id: uuid REFERENCES clients(id),
  prompt_id: varchar,
  category: varchar DEFAULT 'workflow',
  content: text,
  triggers: jsonb,
  usage_count: integer DEFAULT 0
}
```

---

## 🚀 DÉPLOIEMENT & INFRASTRUCTURE

### **🌐 Infrastructure Production**

**Serveur VPS :**
- **IP :** 217.76.58.3
- **OS :** Ubuntu 22.04 LTS
- **User :** nova
- **Process Manager :** PM2 avec auto-restart
- **Reverse Proxy :** Nginx avec SSL

**Services Cloud :**
- **Supabase :** PostgreSQL managed avec RLS
- **Pinecone :** Vector database serverless
- **Anthropic :** Claude API enterprise

### **📦 Commandes de Déploiement**

```bash
# Development
npm run dev          # Server développement avec hot-reload
npm run build        # Build TypeScript → JavaScript
npm run test         # Suite de tests complète

# Production
npm start           # Serveur production
pm2 start ecosystem.config.js  # PM2 avec config
pm2 logs nova-mind-cloud       # Monitoring logs
```

**Endpoints Principaux :**
- `GET /health` - Health check système
- `POST /mcp` - Endpoint MCP principal
- `GET /admin/clients` - Administration clients

---

## 🔧 CONFIGURATION & SETUP

### **📋 Variables Environnement**

```env
# MCP Server
NODE_ENV=production
PORT=3006
API_BASE_URL=https://api.nova-mind.cloud

# Database
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=eyJ...
SUPABASE_SERVICE_ROLE_KEY=eyJ...

# Vector Database
PINECONE_API_KEY=your-api-key
PINECONE_INDEX_NAME=nova-mind-cloud
PINECONE_ENVIRONMENT=us-east-1-aws

# AI Provider
ANTHROPIC_API_KEY=sk-ant...
CLAUDE_MODEL=claude-3-5-sonnet-20241022

# Security
JWT_SECRET=your-jwt-secret
JWT_REFRESH_SECRET=your-refresh-secret
```

### **🚀 Installation Rapide**

```bash
# Clone & Setup
git clone https://github.com/your-org/nova-mind-cloud.git
cd nova-mind-cloud
npm install

# Configuration
cp .env.example .env
# → Éditer .env avec vos clés

# Build & Start
npm run build
npm start

# Vérification
curl http://localhost:3006/health
```

---

## 📊 MÉTRIQUES & ANALYTICS

### **💰 Business Intelligence**

**Usage Tracking Automatique :**
- **Tokens consommés** par session/mois
- **Mémoires créées/récupérées** avec catégories
- **Durée sessions** et patterns d'usage
- **Relationship score evolution** dans le temps
- **API calls** avec rate limiting

**KPIs Commerciaux :**
- **MRR :** Monthly Recurring Revenue tracking
- **Client Lifetime Value** basé sur relationship score
- **Churn Prediction** via patterns d'engagement
- **Feature Usage** par tier d'abonnement

### **🔍 Monitoring Opérationnel**

```javascript
// Health Check Complet
{
  "status": "healthy",
  "timestamp": "2024-12-05T15:30:00Z",
  "services": {
    "supabase": "connected",
    "pinecone": "connected", 
    "anthropic": "connected"
  },
  "server": {
    "uptime": 86400,
    "memory": "512MB / 2GB",
    "activeClients": 15
  }
}
```

---

## 🎯 ROADMAP & ÉVOLUTIONS

### **✅ Version 1.0 (Production Ready)**
- [x] MCP Server HTTP complet
- [x] Multi-tenant authentication sécurisée
- [x] Personality levels adaptatifs (7 niveaux)
- [x] Mémoire vectorielle avec isolation clients
- [x] Gestion contextes unifiée
- [x] System prompts + user prompts
- [x] Usage tracking + billing preparation

### **🔄 Version 1.1 (Q1 2025)**
- [ ] Interface admin web complète
- [ ] Analytics dashboard clients
- [ ] Backup automatique + disaster recovery  
- [ ] API REST pour intégrations tierces
- [ ] Mobile app companion

### **🚀 Version 2.0 (Q2 2025)**
- [ ] Team workspaces multi-utilisateurs
- [ ] Custom prompts marketplace
- [ ] Advanced relationship analytics
- [ ] White-label solutions
- [ ] API webhooks + notifications

---

## 🏆 EXCELLENCE TECHNIQUE

### **📈 Performance Benchmarks**

- **Response Time :** < 200ms average MCP calls
- **Concurrent Users :** 100+ simultaneous clients supported
- **Memory Efficiency :** < 100MB base + 2MB per active client
- **Uptime SLA :** 99.9% availability target
- **Data Retention :** Infinite memory storage with fast retrieval

### **🔒 Security Standards**

- **OWASP Compliance :** Top 10 protections implemented
- **Data Encryption :** AES-256 at rest, TLS 1.3 in transit
- **Audit Logging :** Complete action trail with integrity
- **Access Control :** Role-based permissions with client isolation
- **Privacy :** GDPR compliant with data portability

---

## 🤝 SUPPORT & CONTRIBUTIONS

### **📚 Documentation**
- **API Reference :** Postman collection + OpenAPI spec
- **Client Onboarding :** Setup guides + troubleshooting
- **Developer Portal :** SDK + integration examples

### **🛠️ Contribution Guidelines**
- **Code Standards :** TypeScript strict + ESLint
- **Testing :** 90%+ coverage requirement
- **Security :** Systematic security reviews
- **Performance :** Benchmark validations

---

## 📞 CONTACT & LICENSING

**🏢 GDM-Pixel - Nova-Mind Division**
- **Email :** support@nova-mind.cloud
- **Website :** https://nova-mind.cloud
- **Status :** https://status.nova-mind.cloud

**⚖️ License :** Proprietary - Commercial License
**📋 Version :** 1.0.0 Production Ready
**🏷️ Build :** Enterprise Multi-Tenant MCP Server

---

**🌟 Nova-Mind Cloud - Where AI Coaching Meets Enterprise Excellence**

*Transforming professional relationships through adaptive artificial intelligence*