Depurador Hopper
Objetivo: usar Hopper a través de mcporter como un desensamblador consultable, luego combinar el resultado con código fuente local, LLDB, registros y reproducciones enfocadas.
Inicio Rápido
Validar el servidor MCP:
MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief
Listar documentos abiertos en Hopper:
MCPORTER_CALL_TIMEOUT=20000 timeout 30 mcporter call hopper.list_documents --output json
Si no hay ningún documento abierto, abre el binario/framework en Hopper primero:
open -a "Hopper Disassembler" /ruta/al/Binario
Es posible que Hopper muestre un diálogo de primera apertura/importación. Deja que el usuario haga clic en el botón de confirmación y luego reintenta la llamada MCP. Evita llamadas MCP paralelas a Hopper; el servidor puede cerrar el transporte o hacer que Hopper se bloquee mientras la importación aún se está estabilizando.
Frameworks de Apple
Prefiere los binarios de framework ya extraídos de dyld-cache cuando estén presentes:
/tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
/tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
Abre uno a la vez al depurar problemas en el límite de 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
Verificar acceso:
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
Los nombres de documentos pueden comenzar como Untitled; reintenta después de que Hopper termine de importar. Usa current_document, búsquedas de símbolos/cadenas y cambios en el título de la ventana para identificar AppKit vs SwiftUI.
Flujo de Trabajo de Consulta
- Comienza desde la ruta del código fuente local o el símbolo en tiempo de ejecución que intentas explicar.
- Busca nombres/procedimientos/cadenas:
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
- Inspecciona un objetivo pequeño a la vez:
mcporter call hopper.procedure_info procedure='<símbolo>' --output json
mcporter call hopper.procedure_assembly procedure='<símbolo>' --output json
mcporter call hopper.procedure_pseudo_code procedure='<símbolo>' --output json
mcporter call hopper.procedure_callers procedure='<símbolo>' --output json
mcporter call hopper.procedure_callees procedure='<símbolo>' --output json
mcporter call hopper.xrefs address=0x12345678 --output json
- Resume el flujo de control relevante; no pegues descompilaciones grandes.
- Valida la hipótesis con LLDB/registros/reproducción antes de modificar el código de la aplicación.
Errores de Elemento de Estado / Clic en Menú
Búsquedas útiles en AppKit/SwiftUI:
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
Símbolos que vale la pena inspeccionar cuando los clics en la barra de menú no hacen nada:
-[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]-[NSStatusBarButtonCell _sendActionFrom:]-[NSStatusItem popUpStatusBarMenu:]-[NSApplication sendAction:to:from:]- Símbolos de estado/menú de SwiftUI que referencian
NSStatusItem_Private_ForSwiftUI
Compara el desensamblado con el estado en tiempo de ejecución:
pgrep -af "App.app/Contents/MacOS/App"
lldb /ruta/al/Binario/debug
Para aplicaciones con firma reforzada, el adjuntar puede fallar sin get-task-allow; lanza el binario de depuración sin procesar bajo LLDB cuando sea necesario.
Manejo de Fallos
- Envuelve las llamadas a Hopper con
timeout; un modal/importación o documento cerrado puede dejar el transporte atascado. - No envíes solicitudes MCP concurrentes a Hopper durante la importación. Si una consulta es costosa, espera a que termine antes de iniciar otra.
- Si las llamadas informan
Connection closed, verifica si hay un modal en Hopper, luego reintenta después de la confirmación. - Si Hopper se bloquea, vuelve a abrir un solo documento, espera la importación/análisis, y vuelve a ejecutar
list_documentsantes de búsquedas más profundas. - Si mcporter está atascado, inspecciona los procesos antes de matar algo:
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
- Prefiere reiniciar el daemon de mcporter en lugar de matar procesos de forma amplia:
mcporter daemon stop
mcporter daemon start