Collegue, your daily co-developer

@VynoDePal

5 months ago

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 -d
```
Le 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

Try in Playground

Server Config

{
  "mcpServers": {
    "collegue": {
      "url": "https://beta.collegue.dev/mcp/"
    }
  }
}

Build with ShipAny.