@supersoniks/concorde 3.3.2 → 3.3.3

package/mcp-server/TECHNICAL-DOCS.md

@@ -1,269 +0,0 @@
-# Documentation Technique - Serveur MCP Concorde
-
-## Architecture
-
-Le serveur MCP Concorde est construit avec les technologies suivantes :
-- **Python 3.8+** : Langage principal
-- **MCP (Model Context Protocol)** : Protocole de communication avec l'IA
-- **asyncio** : Gestion asynchrone des requêtes
-- **re** : Analyse des expressions régulières pour extraire les propriétés
-- **pathlib** : Gestion des chemins de fichiers
-
-## Structure du code
-
-### Classe principale : `ConcordeMCPServer`
-
-```python
-class ConcordeMCPServer:
-    def __init__(self):
-        self.server = Server("concorde-mcp")
-        self.components: Dict[str, ComponentInfo] = {}
-        self.documentation: Dict[str, str] = {}
-        self._setup_handlers()
-        self._load_components()
-        self._load_documentation()
-```
-
-### Structure des données
-
-#### `ComponentInfo`
-```python
-@dataclass
-class ComponentInfo:
-    name: str                    # Nom du composant (ex: "button")
-    tag_name: str               # Nom de la balise (ex: "sonic-button")
-    category: str               # "ui" ou "functional"
-    file_path: Path             # Chemin vers le fichier .ts
-    doc_path: Optional[Path]    # Chemin vers le fichier .md
-    description: str            # Description du composant
-    props: List[Dict[str, Any]] # Propriétés du composant
-    examples: List[str]         # Exemples d'utilisation
-```
-
-## Analyse du code source
-
-### Extraction des propriétés
-
-Le serveur analyse les fichiers TypeScript pour extraire les propriétés des composants :
-
-```python
-def _extract_properties(self, content: str) -> List[Dict[str, Any]]:
-    """Extrait les propriétés du composant"""
-    props = []
-    
-    # Recherche les décorateurs @property
-    property_pattern = r'@property\([^)]*\)\s+(\w+)(?::\s*([^=]+))?'
-    matches = re.findall(property_pattern, content)
-    
-    for match in matches:
-        prop_name = match[0]
-        prop_type = match[1] if match[1] else "string"
-        
-        # Recherche les commentaires JSDoc
-        comment_pattern = rf'/\*\*\s*\n\s*\*\s*([^\n]+)'
-        comment_match = re.search(comment_pattern, content)
-        description = comment_match.group(1).strip() if comment_match else ""
-        
-        props.append({
-            "name": prop_name,
-            "type": prop_type,
-            "description": description
-        })
-    
-    return props
-```
-
-### Extraction des exemples
-
-Les exemples sont extraits des fichiers Markdown :
-
-```python
-def _extract_examples(self, doc_content: str) -> List[str]:
-    """Extrait les exemples de la documentation"""
-    examples = []
-    
-    # Recherche les blocs sonic-code
-    code_pattern = r'<sonic-code>(.*?)</sonic-code>'
-    matches = re.findall(code_pattern, doc_content, re.DOTALL)
-    
-    for match in matches:
-        example = match.strip()
-        if example:
-            examples.append(example)
-    
-    return examples
-```
-
-## Outils MCP
-
-### 1. `search_component`
-Recherche un composant par nom ou fonctionnalité.
-
-**Paramètres :**
-- `query` (string) : Terme de recherche
-
-**Retour :** Liste des composants correspondants
-
-### 2. `get_component_info`
-Obtient des informations détaillées sur un composant.
-
-**Paramètres :**
-- `component_name` (string) : Nom du composant
-
-**Retour :** Documentation complète du composant
-
-### 3. `generate_component_code`
-Génère du code HTML pour un composant.
-
-**Paramètres :**
-- `component_name` (string) : Nom du composant
-- `properties` (object) : Propriétés du composant
-- `content` (string, optionnel) : Contenu du composant
-
-**Retour :** Code HTML généré
-
-### 4. `get_form_example`
-Génère un exemple de formulaire.
-
-**Paramètres :**
-- `fields` (array) : Liste des champs du formulaire
-
-**Retour :** Code HTML du formulaire
-
-### 5. `get_theme_info`
-Obtient des informations sur les thèmes.
-
-**Paramètres :**
-- `theme` (string) : Nom du thème ("light", "dark", "auto")
-
-**Retour :** Informations sur le thème
-
-### 6. `get_icons_list`
-Liste les icônes disponibles.
-
-**Paramètres :**
-- `library` (string) : Bibliothèque d'icônes ("core", "iconoir", "fontAwesome")
-
-**Retour :** Liste des icônes
-
-## Ressources MCP
-
-### Composants
-- **URI :** `concorde://component/{component_name}`
-- **Type :** `text/markdown`
-- **Description :** Documentation complète d'un composant
-
-### Documentation
-- **URI :** `concorde://docs/{doc_name}`
-- **Type :** `text/markdown`
-- **Description :** Documentation générale
-
-### Exemples
-- **URI :** `concorde://examples/{category}`
-- **Type :** `text/markdown`
-- **Description :** Exemples d'utilisation
-
-## Configuration
-
-### Fichier de configuration Cursor
-
-```json
-{
-  "mcpServers": {
-    "concorde": {
-      "command": "python3",
-      "args": ["/usr2/sites/concorde/concorde-mcp-server.py"],
-      "env": {
-        "PYTHONPATH": "/usr2/sites/concorde"
-      }
-    }
-  }
-}
-```
-
-### Variables d'environnement
-
-- `PYTHONPATH` : Chemin vers le répertoire Concorde
-- `CONCORDE_ROOT` : Racine du projet (détectée automatiquement)
-
-## Développement
-
-### Ajout d'un nouveau composant
-
-1. Créer le composant dans `src/core/components/{category}/{name}/`
-2. Ajouter le fichier TypeScript avec les décorateurs `@property`
-3. Ajouter la documentation Markdown avec des exemples `<sonic-code>`
-4. Redémarrer le serveur MCP
-
-### Ajout d'un nouvel outil
-
-1. Ajouter l'outil dans `list_tools()`
-2. Implémenter la méthode dans `call_tool()`
-3. Créer la méthode de traitement correspondante
-4. Tester avec le script de test
-
-### Debugging
-
-Utiliser le script de test pour vérifier le fonctionnement :
-
-```bash
-python3 test-mcp.py
-```
-
-### Logs
-
-Le serveur MCP utilise le système de logging standard de Python. Pour activer les logs détaillés :
-
-```python
-import logging
-logging.basicConfig(level=logging.DEBUG)
-```
-
-## Performance
-
-### Optimisations
-
-- **Cache des composants** : Les composants sont chargés une seule fois au démarrage
-- **Analyse regex optimisée** : Utilisation de patterns compilés
-- **Lazy loading** : La documentation n'est chargée que si nécessaire
-
-### Métriques
-
-- **Temps de démarrage** : ~2-3 secondes
-- **Mémoire utilisée** : ~50-100 MB
-- **Temps de réponse** : <100ms pour la plupart des requêtes
-
-## Sécurité
-
-### Validation des entrées
-
-- Tous les paramètres sont validés avant traitement
-- Les chemins de fichiers sont vérifiés pour éviter les accès non autorisés
-- Les expressions regex sont échappées pour éviter les injections
-
-### Permissions
-
-- Le serveur ne peut lire que les fichiers du projet Concorde
-- Aucune écriture sur le système de fichiers
-- Communication uniquement via stdio avec Cursor
-
-## Maintenance
-
-### Mise à jour automatique
-
-Le serveur analyse automatiquement le code source à chaque démarrage, donc :
-- Les nouveaux composants sont détectés automatiquement
-- Les modifications de propriétés sont prises en compte
-- La documentation est mise à jour en temps réel
-
-### Monitoring
-
-Pour surveiller le fonctionnement du serveur :
-
-```bash
-# Vérifier que le processus est actif
-ps aux | grep concorde-mcp-server
-
-# Tester la connectivité
-python3 test-mcp.py
-```