@nova-mind-cloud/server

v1.1.0

Published

22 days ago

Cloud-hosted MCP server for Nova-Mind AI coaching services

0High
0Medium
0Low

gdm-pixel

mcp ai coaching cloud anthropic

🌟 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

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

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 :

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

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)

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)

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)

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)

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

# 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

# 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

# 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

// 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 : [email protected]
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