RAG MCP Server

# Documentation de Configuration RAG ## 📋 Vue d'ensemble Le système de configuration RAG centralisée permet de gérer tous les paramètres des outils RAG dans un seul endroit, avec validation des limites et valeurs par défaut. ## 🗂️ Structure des Fichiers ### Fichier de Configuration Principal - **`config/rag-config.json`** : Configuration JSON avec toutes les options - **`src/config/rag-config.ts`** : Gestionnaire TypeScript pour charger et valider ### Structure du Fichier JSON ```json { "version": "1.0.0", "description": "Configuration des paramètres RAG", "defaults": { "embedding_provider": "fake", "embedding_model": "nomic-embed-text", "chunk_size": 1000, "chunk_overlap": 200, "file_patterns": ["**/*.{js,ts,py,md,txt,json,yaml,yml,html,css,scss}"], "recursive": true, "search_limit": 10, "search_threshold": 0, "format_output": true }, "providers": { "fake": { "description": "Fournisseur factice pour tests", "models": ["nomic-embed-text"] }, "ollama": { "description": "Ollama pour embeddings locaux", "models": ["nomic-embed-text"] }, "sentence-transformers": { "description": "Sentence Transformers", "models": ["all-MiniLM-L6-v2"] } }, "limits": { "chunk_size": { "min": 100, "max": 10000, "default": 1000 }, "chunk_overlap": { "min": 0, "max": 1000, "default": 200 }, "search_limit": { "min": 1, "max": 50, "default": 10 }, "search_threshold": { "min": 0, "max": 1, "default": 0 } } } ``` ## 🔧 Utilisation dans les Outils ### index_project et update_project Ces outils utilisent automatiquement la configuration : ```typescript // Chargement de la configuration const configManager = getRagConfigManager(); const defaults = configManager.getDefaults(); // Utilisation des valeurs par défaut si non spécifiées const embedding_provider = args.embedding_provider || defaults.embedding_provider; const chunk_size = configManager.applyLimits('chunk_size', args.chunk_size || defaults.chunk_size); // Validation automatique des limites // Si chunk_size = 50 → devient 100 (minimum) // Si chunk_size = 20000 → devient 10000 (maximum) ``` ### search_code L'outil de recherche utilise également la configuration : ```typescript const limit = configManager.applyLimits('search_limit', args.limit || searchDefaults.limit); const threshold = configManager.applyLimits('search_threshold', args.threshold || searchDefaults.threshold); ``` ## 🧪 Tests de Configuration ### Script de Test d'Intégration ```bash # Exécuter tous les tests de configuration node test-config-integration.js ``` ### Tests Inclus 1. **Test de chargement** : Vérifie que la configuration est valide 2. **Test des limites** : Vérifie la validation min/max 3. **Test des outils** : Vérifie que chaque outil utilise la configuration 4. **Test des valeurs par défaut** : Vérifie les valeurs par défaut ### Exemple de Sortie de Test ``` 🚀 Démarrage des tests d'intégration RAG ============================================================ 🧪 Test 1: Configuration RAG ✅ Configuration RAG valide 📊 Version: 1.0.0 📊 Fournisseurs disponibles: fake, ollama, sentence-transformers 🧪 Test 2: Gestionnaire de configuration 📊 Limites chunk_size: 100-10000 📊 Validation chunk_size 500: ✅ 📊 Validation chunk_size 50000: ❌ (attendu: false) 🧪 Test 3: Outil index_project ✅ Test index_project réussi 🎉 TOUS LES TESTS ONT RÉUSSI ! ``` ## ⚙️ Personnalisation ### Modifier la Configuration 1. Éditez `config/rag-config.json` 2. Ajoutez de nouveaux fournisseurs dans la section `providers` 3. Ajustez les limites dans la section `limits` 4. Modifiez les valeurs par défaut dans la section `defaults` ### Ajouter un Nouveau Fournisseur ```json "providers": { "nouveau-fournisseur": { "description": "Description du fournisseur", "models": ["modele-1", "modele-2"], "requires_ollama": false, "endpoint": "http://localhost:8080" } } ``` ### Ajuster les Limites ```json "limits": { "chunk_size": { "min": 50, // Nouvelle valeur minimum "max": 20000, // Nouvelle valeur maximum "default": 1500 // Nouvelle valeur par défaut } } ``` ## 🔍 API du Gestionnaire de Configuration ### Méthodes Principales ```typescript // Charger la configuration const configManager = getRagConfigManager(); // Récupérer la configuration complète const config = configManager.getConfig(); // Récupérer les valeurs par défaut const defaults = configManager.getDefaults(); // Récupérer les limites d'un paramètre const limits = configManager.getLimits('chunk_size'); // Valider une valeur const isValid = configManager.validateValue('chunk_size', 500); // Appliquer les limites (ajuste automatiquement) const adjustedValue = configManager.applyLimits('chunk_size', 50); // → 100 // Récupérer les modèles d'un fournisseur const models = configManager.getProviderModels('ollama'); ``` ### Singleton Pattern Le gestionnaire utilise un pattern singleton pour éviter de charger plusieurs fois la configuration : ```typescript // Première utilisation : charge la configuration const manager1 = getRagConfigManager(); // Utilisations suivantes : réutilise l'instance existante const manager2 = getRagConfigManager(); // Même instance que manager1 ``` ## 🚀 Intégration avec Cline ### Configuration Cline MCP Ajoutez cette configuration à `~/.config/cline/cline_mcp_settings.json` : ```json { "mcpServers": { "rag-mcp-server": { "command": "node", "args": ["/chemin/absolu/vers/rag-mcp-server/build/index.js"], "disabled": false, "autoApprove": [] } } } ``` ### Vérification de l'Intégration 1. Redémarrez Cline 2. Vérifiez que rag-mcp-server apparaît dans les serveurs MCP 3. Testez avec un outil RAG : ```bash # Via l'interface Cline use_mcp_tool("rag-mcp-server", "index_project", { "project_path": "/chemin/vers/projet" }) ``` ## 🐛 Dépannage ### Problèmes Courants #### Configuration Non Chargée ``` ❌ Erreur lors du chargement de la configuration RAG ``` **Solution** : Vérifiez que `config/rag-config.json` existe et est un JSON valide. #### Valeurs Hors Limites ``` ⚠️ Valeur chunk_size (50) inférieure au minimum (100) ``` **Solution** : La valeur est automatiquement ajustée au minimum. Ajustez la valeur fournie. #### Fournisseur Inconnu ``` ❌ Fournisseur d'embeddings inconnu: 'inconnu' ``` **Solution** : Utilisez un fournisseur de la liste : `fake`, `ollama`, `sentence-transformers` ### Logs de Débogage Activez les logs détaillés dans la configuration : ```json "environments": { "development": { "verbose_logging": true, "cache_enabled": false } } ``` ## 📈 Métriques de Performance La configuration centralisée améliore : - **Maintenabilité** : Un seul endroit pour modifier les paramètres - **Cohérence** : Tous les outils utilisent les mêmes valeurs - **Sécurité** : Validation automatique des limites - **Testabilité** : Tests d'intégration complets ## 🔄 Mises à Jour ### Procédure de Mise à Jour 1. Sauvegardez l'ancienne configuration 2. Copiez la nouvelle configuration 3. Exécutez les tests d'intégration 4. Vérifiez la rétrocompatibilité ### Versioning - **Version majeure** : Changements incompatibles - **Version mineure** : Nouvelles fonctionnalités - **Patch** : Corrections de bugs --- **Dernière mise à jour** : 28/12/2025 **Auteur** : Système de Configuration RAG **Statut** : Production Ready ✅