Collegue Toolkit

Collègue MCP Toolkit — Guide des outils

Tu as accès aux 12 outils du MCP Collègue via le protocole MCP. Ce guide t'explique quand et comment les utiliser pour chaque type de tâche.

Outils par catégorie

Analyse de code

Sécurité

DevOps & Infrastructure

Monitoring

Workflows recommandés

Audit de sécurité complet

1. secret_scan — scanner tous les fichiers pour secrets exposés
2. dependency_guard — vérifier les vulnérabilités des dépendances
3. iac_guardrails_scan — valider l'infrastructure as code
4. Consolider les résultats en un rapport unifié avec scoring de risque

Code review approfondi

1. repo_consistency_check — détecter les problèmes de cohérence
2. impact_analysis — évaluer l'impact du changement
3. code_refactoring (si nécessaire) — proposer des améliorations
4. test_generation — vérifier la couverture de tests

Onboarding sur un projet

1. github_ops (list_repos, repo_branches) — comprendre la structure
2. postgres_db (list_tables, describe_table) — comprendre le schéma de données
3. repo_consistency_check — identifier la dette technique
4. code_documentation — générer la documentation manquante

Debugging production

1. sentry_monitor (list_issues, issue_events) — identifier les erreurs récentes
2. kubernetes_ops (pod_logs, list_events) — vérifier les logs et événements
3. impact_analysis — trouver la cause probable dans le code
4. github_ops (repo_commits) — identifier le commit responsable

Préparation de déploiement

1. dependency_guard — vérifier qu'aucune vulnérabilité n'est présente
2. secret_scan — confirmer qu'aucun secret n'est exposé
3. iac_guardrails_scan — valider la configuration d'infrastructure
4. test_generation — s'assurer que les tests couvrent les changements

Combinaisons à éviter

• Ne pas appeler code_refactoring sans repo_consistency_check d'abord — il faut connaître les problèmes avant de refactoriser
• Ne pas appeler impact_analysis sans fournir le change_intent — l'outil a besoin de savoir quel changement est prévu
• Ne pas appeler kubernetes_ops sans vérifier que le cluster est accessible

Paramètres clés

repo_consistency_check

• files : liste de {path, content} — obligatoire
• checks : ['unused_imports', 'unused_vars', 'dead_code', 'duplication', 'signature_mismatch', 'unresolved_symbol']
• language : 'python', 'typescript', 'javascript', 'auto'
• mode : 'fast' (heuristiques) ou 'deep' (analyse complète)

secret_scan

• files : liste de {path, content} — recommandé pour scan batch
• content : contenu d'un seul fichier
• severity_threshold : 'low', 'medium', 'high', 'critical'

dependency_guard

• content : contenu du fichier de dépendances (package-lock.json, requirements.txt, pyproject.toml)
• language : 'python' ou 'typescript'/'javascript'
• check_vulnerabilities : true pour scanner les CVE via OSV

impact_analysis

• change_intent : description du changement en langage naturel — obligatoire
• files : liste de {path, content} — obligatoire
• analysis_depth : 'fast' (~10ms) ou 'deep' (+2-3s avec IA)

iac_guardrails_scan

• files : liste de {path, content} — obligatoire
• policy_profile : 'baseline' (recommandé) ou 'strict'
• analysis_depth : 'fast' ou 'deep' (scoring LLM)

Source: VynoDePal/Collegue — distributed by TomeVault.