Hopper Debugger
Objetivo: usar o Hopper através do mcporter como um desmontador consultável, combinando o resultado com código-fonte local, LLDB, logs e reproduções focadas.
Início Rápido
Validar o servidor MCP:
MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief
Listar documentos abertos no Hopper:
MCPORTER_CALL_TIMEOUT=20000 timeout 30 mcporter call hopper.list_documents --output json
Se nenhum documento estiver aberto, abra o binário/framework no Hopper primeiro:
open -a "Hopper Disassembler" /caminho/para/Binário
O Hopper pode exibir um diálogo de primeira abertura/importação. Deixe o usuário clicar no botão de confirmação e repita a chamada MCP. Evite chamadas MCP paralelas ao Hopper; o servidor pode fechar o transporte ou travar o Hopper enquanto a importação ainda está sendo finalizada.
Frameworks Apple
Prefira binários de framework já extraídos do cache dyld quando presentes:
/tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
/tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
Abra um de cada vez ao depurar problemas de limite 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 acesso:
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
Nomes de documentos podem começar como Untitled; repita após o Hopper terminar a importação. Use current_document, buscas por símbolos/strings e alterações no título da janela para identificar AppKit vs SwiftUI.
Fluxo de Consulta
- Comece pelo caminho do código-fonte local ou símbolo em tempo de execução que você está tentando explicar.
- Busque nomes/procedimentos/strings:
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
- Inspecione um alvo pequeno por 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
- Resuma o fluxo de controle relevante; não cole grandes descompilações.
- Valide a hipótese com LLDB/logging/reprodução antes de modificar o código do aplicativo.
Bugs de Item de Status / Clique em Menu
Buscas úteis em 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 valem a pena inspecionar quando cliques na barra de menu não fazem nada:
-[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]-[NSStatusBarButtonCell _sendActionFrom:]-[NSStatusItem popUpStatusBarMenu:]-[NSApplication sendAction:to:from:]- Símbolos de status/menu do SwiftUI que referenciam
NSStatusItem_Private_ForSwiftUI
Compare a desmontagem com o estado em tempo de execução:
pgrep -af "App.app/Contents/MacOS/App"
lldb /caminho/para/debug/Binário
Para aplicativos assinados com proteção, a anexação pode falhar sem get-task-allow; inicie o binário de depuração bruto sob LLDB quando necessário.
Tratamento de Falhas
- Envolva chamadas Hopper com
timeout; uma janela modal/importação ou documento fechado pode deixar o transporte travado. - Não envie requisições MCP Hopper concorrentes durante a importação. Se uma consulta for cara, aguarde sua conclusão antes de iniciar outra.
- Se as chamadas reportarem
Connection closed, verifique se há um modal do Hopper, depois repita após a confirmação. - Se o Hopper travar, reabra um único documento, aguarde a importação/análise e execute
list_documentsnovamente antes de buscas mais profundas. - Se o mcporter estiver travado, inspecione os processos antes de matar qualquer coisa:
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
- Prefira reiniciar o daemon do mcporter em vez de matar processos indiscriminadamente:
mcporter daemon stop
mcporter daemon start