mcp-10-code-splitter-auditor
by snorbik-ai
README.md
# mcp-10-code-splitter-auditor
[](#)
[](#)
[](#)
[](#)
[](#)
> **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é.
This server cannot be deployed
Maintenance
ActivityNo data
ResponsivenessOutdated data