Collègue

What is Collègue MCP?

Collègue est un serveur Model Context Protocol (MCP) destiné aux développeurs. Il fournit un ensemble d’outils avancés pour analyser, générer, refactorer, documenter le code et créer des tests unitaires. Construit avec FastMCP, il s’intègre facilement à des clients MCP comme Windsurf, Cursor, Claude Desktop et d’autres IDE compatibles.

Points forts:

• Outils de productivité orientés développeurs (analyse, génération, refactoring, doc, tests)
• Gestion centralisée du LLM
• Endpoints de santé et métadonnées OAuth
• Intégration possible avec Keycloak et scopes fins

Key features of Collègue MCP

• Analyse de code multi-langages (Python, JS/TS)
• Génération de code guidée par description avec contraintes et contexte
• Refactoring (rename, extract, simplify, optimize, clean, modernize) avec métriques
• Génération automatique de documentation (Markdown, RST, HTML, docstring, JSON)
• Génération de tests unitaires (pytest, unittest, Jest, etc.) avec estimation de couverture
• Système de prompts amélioré, A/B testing, optimisation par langage
• Intégration LLM flexible (OpenRouter recommandé)
• Endpoints de santé et découverte OAuth pour intégration SSO

Use cases of Collègue MCP

1. Revue de code assistée: comprendre rapidement un module inconnu
2. Démarrage rapide: générer un squelette de service/API/algorithme
3. Amélioration continue: refactorer pour lisibilité et performance
4. Documentation vivante: produire/mettre à jour la doc et docstrings
5. Qualité logicielle: générer une base de tests pour augmenter la couverture

Tools

Collègue expose les outils MCP suivants (via collegue/tools/):

• code_explanation

  • Description: Analyse et explique du code multi-langages
  • Paramètres clés: code, language?, detail_level?, focus_on?, session_id?

• code_generation

  • Description: Génère du code à partir d’une description textuelle
  • Paramètres clés: description, language, context?, constraints?, file_path?, session_id?

• code_documentation

  • Description: Génère automatiquement de la documentation (Markdown, RST, HTML, docstring, JSON)
  • Paramètres clés: code, language, doc_style?, doc_format?, include_examples?, focus_on?, file_path?, session_id?

• code_refactoring

  • Description: Refactorise le code (rename/extract/simplify/optimize/clean/modernize) et calcule des métriques d’amélioration
  • Paramètres clés: code, language, refactoring_type, parameters?, file_path?, session_id?

• test_generation

  • Description: Génère des tests unitaires et estime la couverture
  • Paramètres clés: code, language, test_framework?, include_mocks?, coverage_target?, file_path?, output_dir?, session_id?

FAQ from Collègue MCP

• Quels clients MCP sont compatibles?
  • Windsurf (recommandé), Cursor, Claude Desktop et autres agents MCP avec transport HTTP.

Examples

• Explication de code (Python):

{ "tool": "code_explanation", "request": { "code": "def fibonacci(n):\n    if n <= 1: return n\n    return fibonacci(n-1) + fibonacci(n-2)", "language": "python", "detail_level": "detailed" } }

• Génération de code (TypeScript):

{ "tool": "code_generation", "request": { "description": "Contrôleur REST pour gérer les utilisateurs (CRUD)", "language": "typescript", "constraints": ["types stricts", "gestion d'erreurs"] } }

• Refactoring (simplify):

{ "tool": "code_refactoring", "request": { "code": "if (user.age > 18) { if (user.hasLicense) { if (user.hasInsurance) { return true } } } return false", "language": "javascript", "refactoring_type": "simplify" } }

• Documentation (Markdown):

{ "tool": "code_documentation", "request": { "code": "class Calculator {\n  add(x, y) { return x + y }\n}", "language": "javascript", "doc_format": "markdown", "doc_style": "standard", "include_examples": true } }

• Génération de tests (pytest):

{ "tool": "test_generation", "request": { "code": "class Calculator:\n    def add(self, a, b):\n        return a + b", "language": "python", "test_framework": "pytest", "coverage_target": 0.9 } }