Étape 1 : Compiler la solution

Avant de configurer VS Code, vous devez compiler le serveur MCP :

1. Ouvrez MCPDebugger.sln dans Visual Studio.
2. Compilez la solution.
3. Confirmez que MCP.Server.exe existe dans votre sous-dossier \build\Release\x86 ou \build\Release\x64.

Étape 2 : Installer les extensions VS Code requises

Assurez-vous que les extensions suivantes sont installées et actives dans VS Code :

• GitHub Copilot
• GitHub Copilot Chat

Étape 3 : Ajouter le serveur MCP

1. Appuyez sur Ctrl + Shift + P pour ouvrir la palette de commandes.
2. Tapez > et sélectionnez "Ajouter un serveur MCP".
3. Choisissez commande (stdio) comme type de serveur.

Étape 4 : Configurer le chemin

Entrez le chemin complet vers MCP.Server.exe que vous avez compilé à l'étape 1.

[!ATTENTION] Une seule **architecture (x86 ou x64) doit être active en tant que serveur MCP à la fois. Si vous changez d'architecture, supprimez d'abord l'entrée du serveur précédent.

Étape 5 : Finaliser et utiliser

1. Nommer le serveur : Entrez un nom pour le serveur MCP et appuyez sur Entrée.
2. Vérifier : Ouvrez Copilot Chat (Ctrl + Alt + I), passez en Mode Agent et cliquez sur l'icône Outils. Vos outils MCP devraient maintenant apparaître et être prêts à l'emploi. Les outils MCP peuvent être activés/désactivés ici.

Captures d'écran VS Code

VS Code : Barre d'outils avec les extensions installées et le serveur MCP

VS Code : Fenêtre Copilot Chat

Recommandations de modèles

Pour les tâches complexes de débogage et de rétro-ingénierie utilisant ce débogueur MCP, Claude Opus 4.5 a donné de loin les meilleurs résultats en date de novembre 2025. Il a systématiquement géré les grandes traces d'exécution, le désassemblage détaillé et le raisonnement en plusieurs étapes de manière plus fiable que les autres modèles testés.

ChatGPT 4.1 et Gemini 2.5 Pro étaient suffisants pour des scénarios d'analyse plus simples, comme le pas à pas basique, l'inspection d'instructions et le raisonnement simple sur le flux de contrôle. Ces modèles ont bien fonctionné pour les exemples fournis dans les dossiers Example_x64 et Example_x86, mais ont montré des limites lorsqu'il s'agissait de sessions de débogage plus complexes ou de longue durée.

Les performances des modèles peuvent changer avec le temps, mais ce qui précède reflète le comportement observé au moment des tests.

Avertissement

Le débogage via MCP peut entraîner une utilisation élevée de tokens et des coûts accrus. Les interactions IA sont sans état, ce qui signifie que tout le contexte de débogage pertinent (registres, mémoire, désassemblage, modules, etc.) doit être transféré à plusieurs reprises avec chaque requête.

Les opérations qui arrêtent fréquemment l'exécution et renvoient un état détaillé – comme le pas à pas et les points d'arrêt temporaires – peuvent considérablement amplifier la consommation de tokens.

Si un faible coût de fonctionnement est nécessaire, il est fortement recommandé de se concentrer sur l'analyse statique et de désactiver les outils MCP suivants :

• Debugger_ContinueToBreakpoint
• Debugger_ContinueToApiBreakpoint
• Debugger_StepInto
• Debugger_StepOver

La désactivation de ces outils réduit la quantité de transfert d'état répété et aide à maîtriser l'utilisation des tokens.

Exemples

Le dépôt inclut des projets d'exemple pour aider à démarrer avec l'analyse statique et le débogage, situés dans les dossiers suivants :

• Example_x64 et Example_x86
  Les projets Example_x64 et Example_x86 fournissent une simple application console utilisée comme cible de débogage d'introduction. L'application invite l'utilisateur à saisir un mot de passe lors de l'exécution. Le mot de passe correct pour les deux exemples est secret.

• MCP_Debugging_Sessions
  Un dossier contenant des sessions de débogage plus complexes qui exploitent l'analyse dynamique et le débogage. Dans ces sessions, Claude Opus 4.5 a été utilisé. Les cibles peuvent être téléchargées ici. Veuillez noter que les cibles ont été décompressées avec UPX -d avant d'utiliser le débogueur MCP.

Outils MCP

Le serveur MCP expose les outils suivants pour interagir avec le débogueur :

Cycle de vie du débogueur

• Debugger_Start
  Démarre le débogueur pour l'exécutable spécifié et s'arrête sur le point d'arrêt système initial.

• Debugger_Stop
  Arrête le débogueur et termine le processus débogué.

Contrôle d'exécution

• Debugger_Continue
  Reprend l'exécution lorsque le débogué est arrêté sur un point d'arrêt.

• Debugger_ContinueToEntryPoint
  Reprend l'exécution depuis le point d'arrêt système jusqu'au point d'entrée du programme.

• Debugger_ContinueToBreakpoint
  Reprend l'exécution jusqu'à ce qu'un point d'arrêt temporaire à une adresse virtuelle spécifiée soit atteint.

• Debugger_ContinueToApiBreakpoint
  Reprend l'exécution jusqu'à ce qu'un point d'arrêt temporaire sur une fonction API spécifiée soit atteint.

• Debugger_StepInto
  Exécute pas à pas l'instruction suivante en entrant dans les appels de fonction.

• Debugger_StepOver
  Passe au-dessus des appels de fonction et continue jusqu'à l'instruction suivante.

Inspection du code et de la mémoire

• Debugger_Disassemble
  Désassemble la mémoire à une adresse virtuelle donnée et retourne les instructions incluant les informations de symbole.

• Debugger_TryResolveString
  Tente de résoudre et de lire une chaîne à partir de la mémoire du débogué.

• Debugger_ReadMemory
  Lit les octets bruts de la mémoire du processus débogué.

• Debugger_WriteMemory
  Écrit des octets arbitraires dans la mémoire du débogué.

Inspection des modules

• Debugger_GetModules
  Retourne une liste des modules actuellement chargés pour le processus débogué.

• Debugger_GetModuleImports
  Retourne les fonctions importées d'un module spécifié.

• Debugger_GetModuleExports
  Retourne les fonctions exportées d'un module spécifié.

• Debugger_GetModuleSections
  Retourne les informations de section d'un module spécifié.

Utilitaires

• Debugger_HexToDecConverter
  Convertit les valeurs hexadécimales en décimales pour éviter les erreurs de conversion de nombres.

Aperçu de la solution

La solution Visual Studio est organisée en projets suivants :

• MCP.Debugger
  Le débogueur principal implémenté en C++. Il inclut un pont C++/CLI pour exposer une interface managée aux clients .NET.

• MCP.Debugger.Tester
  Une simple application WinForms utilisée pour tester le débogueur via l'interface .NET managée.

• MCP.Debugger.Types
  Un assembly de types qui définit les structures et types de données partagés pour les transitions managées/natives entre le débogueur et les clients .NET.

• MCP.Server
  Le serveur MCP en C# qui expose les fonctionnalités du débogueur sous forme d'outils MCP pour les clients externes.