Débogueur Hopper
Objectif : utiliser Hopper via mcporter comme désassembleur interrogeable, puis combiner le résultat avec le code source local, LLDB, les logs et des reproductions ciblées.
Démarrage rapide
Valider le serveur MCP :
MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief
Lister les documents Hopper ouverts :
MCPORTER_CALL_TIMEOUT=20000 timeout 30 mcporter call hopper.list_documents --output json
Si aucun document n'est ouvert, ouvrir le binaire/framework dans Hopper d'abord :
open -a "Hopper Disassembler" /path/to/Binary
Hopper peut afficher une boîte de dialogue de première ouverture/importation. Laissez l'utilisateur cliquer sur le bouton de confirmation, puis réessayez l'appel MCP. Évitez les appels MCP Hopper parallèles ; le serveur peut fermer le transport ou faire planter Hopper pendant que l'importation est encore en cours.
Frameworks Apple
Privilégiez les binaires de framework déjà extraits du cache dyld lorsqu'ils sont présents :
/tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
/tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
Ouvrez-les un par un lors du débogage de problèmes à la frontière SwiftUI/AppKit :
open -a "Hopper Disassembler" /tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
mcporter call hopper.list_documents --output json
open -a "Hopper Disassembler" /tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
mcporter call hopper.list_documents --output json
Vérifier l'accès :
mcporter call hopper.list_documents --output json
mcporter call hopper.current_document --output json
mcporter call hopper.search_strings pattern=SwiftUI --output json
mcporter call hopper.search_strings pattern=NSStatusItem --output json
Les noms de document peuvent commencer par Untitled ; réessayez après la fin de l'importation par Hopper. Utilisez current_document, les recherches de symboles/chaînes et les changements de titre de fenêtre pour identifier AppKit par rapport à SwiftUI.
Flux de travail d'interrogation
- Commencez par le chemin source local ou le symbole d'exécution que vous essayez d'expliquer.
- Recherchez des noms/procédures/chaînes :
mcporter call hopper.search_procedures pattern='NSStatusBar' --output json
mcporter call hopper.search_name pattern='NSStatusBarButtonCell' --output json
mcporter call hopper.search_strings pattern='NSStatusItem' --output json
- Inspectez une petite cible à la fois :
mcporter call hopper.procedure_info procedure='<symbole>' --output json
mcporter call hopper.procedure_assembly procedure='<symbole>' --output json
mcporter call hopper.procedure_pseudo_code procedure='<symbole>' --output json
mcporter call hopper.procedure_callers procedure='<symbole>' --output json
mcporter call hopper.procedure_callees procedure='<symbole>' --output json
mcporter call hopper.xrefs address=0x12345678 --output json
- Résumez le flux de contrôle pertinent ; ne collez pas de grandes décompilations.
- Validez l'hypothèse avec LLDB/la journalisation/la reproduction avant de modifier le code de l'application.
Bugs d'élément de statut / clic de menu
Recherches AppKit/SwiftUI utiles :
mcporter call hopper.search_strings pattern='NSStatusItem_Private_ForSwiftUI' --output json
mcporter call hopper.search_procedures pattern='popUpStatusBarMenu' --output json
mcporter call hopper.search_procedures pattern='trackMouse' --output json
mcporter call hopper.search_name pattern='NSStatusBarButtonCell' --output json
mcporter call hopper.search_name pattern='NSStatusItem' --output json
Symboles intéressants à inspecter lorsque les clics de la barre de menu ne font rien :
-[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]-[NSStatusBarButtonCell _sendActionFrom:]-[NSStatusItem popUpStatusBarMenu:]-[NSApplication sendAction:to:from:]- Symboles SwiftUI statut/menu qui référencent
NSStatusItem_Private_ForSwiftUI
Comparez le désassemblage avec l'état d'exécution :
pgrep -af "App.app/Contents/MacOS/App"
lldb /path/to/debug/Binary
Pour les applications signées avec renforcement, l'attachement peut échouer sans get-task-allow ; lancez le binaire de débogage brut sous LLDB si nécessaire.
Gestion des échecs
- Encapsulez les appels Hopper avec
timeout; une fenêtre modale, une importation ou un document fermé peut bloquer le transport. - N'envoyez pas de requêtes MCP Hopper concurrentes pendant l'importation. Si une requête est coûteuse, attendez qu'elle se termine avant d'en lancer une autre.
- Si les appels signalent
Connection closed, vérifiez s'il y a une fenêtre modale Hopper, puis réessayez après confirmation. - Si Hopper plante, rouvrez un seul document, attendez l'importation/analyse, et relancez
list_documentsavant des recherches plus approfondies. - Si mcporter est bloqué, inspectez les processus avant de tuer quoi que ce soit :
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
- Préférez redémarrer le démon mcporter plutôt que de tuer des processus en masse :
mcporter daemon stop
mcporter daemon start