Collegue, your daily co-developer
Overview
Collègue MCP
Un assistant de développement intelligent et serveur MCP (Model Context Protocol) fournissant des outils d'analyse, de refactoring, de documentation, d'analyse de risques, sécurité et bien plus.
🚀 Utilisation Rapide (Client NPM)
Configurez votre IDE pour utiliser Collègue via le wrapper NPM officiel. Cela connecte votre IDE au serveur public par défaut.
Windsurf / Cursor / Claude Desktop / Antigravity
Ajoutez ceci à votre configuration mcpServers (souvent dans ~/.codeium/windsurf/mcp_config.json ou équivalent) :
{
"mcpServers": {
"collegue": {
"command": "npx",
"args": ["-y", "@collegue/mcp@latest"]
}
}
}
✨ Fonctionnalités (Outils MCP)
🔧 Outils d'Analyse de Code
- 🛡️ IaC Guardrails Scan : Sécurisation de l'Infrastructure as Code (Terraform, Kubernetes, Dockerfile) contre les mauvaises configurations et privilèges excessifs.
- 🎯 Impact Analysis : Analyse prédictive des risques et impacts d'un changement de code avant son application.
- 🔍 Repo Consistency Check : Détection d'incohérences subtiles, code mort et hallucinations silencieuses dans le codebase.
- 📦 Dependency Guard : Audit de sécurité des dépendances (Supply Chain) pour éviter typosquatting et paquets malveillants/vulnérables.
- 🔐 Secret Scan : Détection proactive de secrets, clés API et tokens exposés dans le code.
- 🧪 Run Tests : Exécution de tests unitaires (Python/JS/TS) avec rapports structurés intégrés au contexte.
- ♻️ Refactoring : Outils automatisés pour nettoyer, optimiser et restructurer le code existant.
- 📚 Documentation : Génération automatique de documentation technique et docstrings.
- ⚡ Test Generation : Création intelligente de tests unitaires validés par exécution.
🔌 Outils d'Intégration (NEW)
- 🐘 PostgreSQL Database : Inspection de schéma, requêtes SQL (lecture seule), statistiques de tables, clés étrangères et index.
- 🐙 GitHub Operations : Gestion des repos, PRs, issues, branches, workflows CI/CD et recherche de code.
- 🚨 Sentry Monitor : Récupération des erreurs, stacktraces, statistiques de projet et releases pour prioriser le debugging.
- ☸️ Kubernetes Operations : Inspection des pods, logs, déploiements, services, événements et ressources du cluster.
🐳 Auto-hébergement (Docker)
Si vous souhaitez héberger votre propre instance du serveur Collègue (backend Python) :
-
Cloner le dépôt
git clone https://github.com/VynoDePal/Collegue.git cd Collegue -
Configuration Copiez le fichier d'exemple et configurez vos clés API (OpenRouter, etc.) :
cp .env.example .env -
Lancement
docker compose up -dLe serveur sera accessible sur le port configuré (par défaut
4121).
🛠️ Développement Local (Python)
Pour contribuer au développement du serveur backend :
# Installation
python -m venv .venv
source .venv/bin/activate # ou .venv\Scripts\activate sur Windows
pip install -r requirements.txt
# Lancement du serveur
python -m collegue.app
🔑 Configuration des Intégrations
Les outils d'intégration se configurent via le bloc env de la configuration MCP :
{
"mcpServers": {
"collegue": {
"command": "npx",
"args": ["-y", "@collegue/mcp@latest"],
"env": {
"POSTGRES_URL": "postgresql://user:password@host:5432/database",
"GITHUB_TOKEN": "ghp_xxxxxxxxxxxx",
"SENTRY_AUTH_TOKEN": "sntrys_xxxxxxxxxxxx",
"SENTRY_ORG": "my-organization"
}
}
}
}
Variables disponibles
| Variable | Description | Outil |
|---|---|---|
POSTGRES_URL | URI PostgreSQL (ou DATABASE_URL) | postgres_db |
GITHUB_TOKEN | Token GitHub (permissions: repo, read:org) | github_ops |
SENTRY_AUTH_TOKEN | Token d'authentification Sentry | sentry_monitor |
SENTRY_ORG | Slug de l'organisation Sentry | sentry_monitor |
SENTRY_URL | URL Sentry self-hosted (optionnel) | sentry_monitor |
KUBECONFIG | Chemin vers kubeconfig (optionnel) | kubernetes_ops |
🤖 Agent Autonome Watchdog (Self-Healing)
Le Watchdog est un agent autonome de Self-Healing qui surveille automatiquement vos erreurs Sentry et génère des correctifs via Pull Requests GitHub.
⚡ Fonctionnement
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Sentry │ ──► │ Watchdog │ ──► │ LLM │ ──► │ GitHub │
│ (erreurs) │ │ (analyse) │ │ (fix) │ │ (PR) │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
- Surveillance : Scan périodique des erreurs non résolues dans Sentry
- Context Pack : Extraction intelligente du code source via GitHub (AST-based)
- Analyse LLM : Génération de patchs minimaux avec recherche web
- Fuzzy Matching : Application robuste des correctifs (stratégie Aider/RooCode)
- Pull Request : Création automatique d'une PR avec explication détaillée
🛡️ Sécurités intégrées
- Validation syntaxique : Le code Python est vérifié via
ast.parse()avant commit - Protection anti-destruction : Les patchs réduisant le fichier de >50% sont rejetés
- Fuzzy matching : Tolérance aux variations d'indentation (score minimum: 0.6)
- Atomicité : Tous les patchs d'un fix doivent réussir ou aucun n'est appliqué
- Déduplication : Chaque issue n'est traitée qu'une seule fois par cycle
👥 Mode Multi-Utilisateurs
Le Watchdog supporte automatiquement plusieurs utilisateurs via le Config Registry :
- Les configurations sont enregistrées lors de chaque requête MCP
- Le watchdog itère sur toutes les configurations actives (< 24h)
- Les configurations inactives (> 48h) sont automatiquement nettoyées
Server Config
{
"mcpServers": {
"collegue": {
"url": "https://beta.collegue.dev/mcp/"
}
}
}Project Info
Created At
5 months agoUpdated At
4 months agoAuthor Name
VynoDePalStar
-Language
-License
-Recommend Servers
View AllFabric
@fabric-agent-plugins
8 hours ago