Skip to main content
Glama
mcp-10-code-splitter-auditor

mcp-10-code-splitter-auditor

by snorbik-ai
README.md
# mcp-10-code-splitter-auditor

[![Pôle Stratégique](https://img.shields.io/badge/P%C3%B4le-05_POLE_ARCHITECTURE_CODE_CLEAN-blue.svg)](#)
[![Nature](https://img.shields.io/badge/Nature-UTILITAIRE-orange.svg)](#)
[![Visibilité](https://img.shields.io/badge/Visibilit%C3%A9-PUBLIC-green.svg)](#)
[![Version](https://img.shields.io/badge/Version-1.0.0-purple.svg)](#)
[![Standard](https://img.shields.io/badge/Standard-V14.1%20Clean%20Architecture-teal.svg)](#)

> **UTILITAIRE OPEN-SOURCE DE RIGUEUR**  
> L'auditeur de budget de lignes qui traque les fichiers de plus de 350 lignes et génère des plans de découpage modulaires automatiques en sous-packages propres.

---

## 1. Carte d'Identité & Rôle Métier

| Champ Stratégique | Valeur Officielle |
| :--- | :--- |
| **Composant Officiel** | `mcp-10-code-splitter-auditor` |
| **Pôle d'Appartenance** | **Pôle 5 : L'Outillage de Notoriété, Code Clean & Pattern MCP** |
| **Modèle Business** | **UTILITAIRE OPEN-SOURCE DE RIGUEUR** |
| **Politique de Visibilité** | **PUBLIC OPEN-SOURCE (MIT)** |
| **Mission Principale** | L'auditeur de budget de lignes qui traque les fichiers de plus de 350 lignes et génère des plans de découpage modulaires automatiques en sous-packages propres. |
| **Architecture** | Clean Architecture Tri-Canal (STDIO / CLI / SDK In-Process) |

---

## 2. Guide d'Installation 1-Clic

### Option 0 : Extension VS Code / Cursor (recommandée pour distribution)
Dossier [`extension/`](extension/) — packagée en `.vsix` (v0.1.0).

```bash
cd extension
npm install
npm run bundle-mcp
npm test
npm run package
```

Puis : Command Palette → **Code Splitter: Install MCP (All Clients)** → Reload Window.  
Cible les 4 clients : Cursor, VS Code, Claude Desktop, Claude Code.

### Option A : Installation Automatisée 1-Clic (CLI)
Exécutez simplement le script `install.py` à la racine du dépôt :

```bash
python install.py
```

Ce script effectue automatiquement :
1. La vérification de votre environnement Python (>= 3.10).
2. L'installation des dépendances requises en mode éditable (`pip install -e .` ou `npm install`).
3. La détection et l'injection automatique du serveur dans la configuration de Cursor (`%USERPROFILE%/.cursor/mcp.json`) sans écraser vos autres outils.

### Option B : Installation Manuelle Développeur
```bash
pip install -e .
```

---

## 3. Configuration Manuelle (Cursor, Antigravity, Claude Desktop)

Si vous préférez déclarer manuellement ce serveur dans votre fichier `.cursor/mcp.json` ou `mcp_config.json`, ajoutez le bloc suivant :

```json
{
  "mcpServers": {
    "mcp-10-code-splitter-auditor": {
      "command": "python",
      "args": ["canal_mcp/mcp_server.py"],
      "env": { "PYTHONIOENCODING": "utf-8" },
      "type": "stdio"
    }
  }
}
```

---

## 4. Catalogue Sémantique des Outils (`tools`)

Ce composant expose des outils déterministes prêts à être invoqués par un modèle de langage (LLM) :

| Nom de l'Outil (`tool`) | Rôle & Fonction Technique | Déclencheur d'Action (*Quand l'IA DOIT-ELLE l'appeler ?*) | Paramètres Requis | Sortie Retournée |
| :--- | :--- | :--- | :--- | :--- |
| `mcp_scan_line_counts` | Scanne tous les fichiers sources (.py, .ts, .tsx, .mjs) et liste ceux qui dépassent le seuil d'alerte (350 lignes). | **Lors de l'audit de qualité ou avant d'intégrer une nouvelle fonctionnalité lourde.** | `max_lines (int, optionnel, défaut: 350), target_dir (str, optionnel)` | Tableau ordonné des fichiers lourds avec compteur exact de lignes. |
| `mcp_generate_split_plan` | Génère un plan de découpage modulaire sous forme de répertoire partials/ ou submodules/ avec index barrel export. | **Dès qu'un fichier monolithique (> 350 lignes) est détecté.** | `file_path (str, requis)` | Plan d'architecture découpée (responsabilités isolées, hooks contrôleurs et barrel index). |

---

## 5. Exemples Concrets de Prompts Utilisateur

Voici 3 exemples réels de requêtes que vous pouvez poser directement dans le chat de Cursor ou Claude Code pour faire travailler cet outil :

1. *« Scanne mon code pour trouver tous les fichiers qui dépassent 350 lignes. »*
2. *« Génère un plan de découpage modulaire pour le fichier mcp_server.py qui fait 520 lignes. »*
3. *« Vérifie que la Règle #5 de budget de lignes est respectée sur l'ensemble de mes composants. »*

---

## 🛡️ Propriété Intellectuelle & Sécurité
- **Éditeur :** SNORBIK AI © 2026.
- **Classification :** Conforme à la Directive Maîtresse V14.1 (Recettes d'architecture sanctuarisées dans le Pôle 06).
- **Zéro Régression :** Respect strict des budgets de lignes et des normes de sécurité.