Hopper Debugger은(는) 무엇을 하나요?
목표: mcporter를 통해 Hopper를 질의 가능한 디스어셈블러로 사용하고, 그 결과를 로컬 소스, LLDB, 로그, 집중된 재현과 결합합니다.
빠른 시작
MCP 서버 검증:
MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief
열려 있는 Hopper 문서 나열:
MCPORTER_CALL_TIMEOUT=20000 timeout 30 mcporter call hopper.list_documents --output json
문서가 열려 있지 않으면 먼저 Hopper에서 바이너리/프레임워크를 엽니다:
open -a "Hopper Disassembler" /path/to/Binary
Hopper가 첫 열기/가져오기 대화상자를 표시할 수 있습니다. 사용자가 확인 버튼을 클릭하게 한 후 MCP 호출을 재시도하세요. Hopper MCP 호출을 병렬로 실행하지 마십시오; 임포트가 안정화되는 동안 서버가 전송을 닫거나 Hopper가 충돌할 수 있습니다.
Apple 프레임워크
가능하면 이미 추출된 dyld-cache 프레임워크 바이너리를 선호합니다:
/tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
/tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
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
접근 확인:
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
문서 이름은 Untitled로 시작할 수 있습니다; Hopper가 가져오기를 완료한 후 재시도하세요. current_document, 심볼/문자열 검색, 창 제목 변경을 사용하여 AppKit과 SwiftUI를 식별합니다.
질의 워크플로우
- 설명하려는 로컬 소스 경로 또는 런타임 심볼에서 시작합니다.
- 이름/프로시저/문자열을 검색합니다:
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
- 한 번에 하나의 작은 대상을 검사합니다:
mcporter call hopper.procedure_info procedure='<symbol>' --output json
mcporter call hopper.procedure_assembly procedure='<symbol>' --output json
mcporter call hopper.procedure_pseudo_code procedure='<symbol>' --output json
mcporter call hopper.procedure_callers procedure='<symbol>' --output json
mcporter call hopper.procedure_callees procedure='<symbol>' --output json
mcporter call hopper.xrefs address=0x12345678 --output json
- 관련 제어 흐름을 요약합니다; 큰 역컴파일 결과를 붙여넣지 마십시오.
- 앱 코드를 편집하기 전에 LLDB/로깅/재현을 통해 가설을 검증합니다.
상태 항목 / 메뉴 클릭 버그
유용한 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
메뉴 막대 클릭이 작동하지 않을 때 검사할 가치가 있는 심볼:
-[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]-[NSStatusBarButtonCell _sendActionFrom:]-[NSStatusItem popUpStatusBarMenu:]-[NSApplication sendAction:to:from:]NSStatusItem_Private_ForSwiftUI를 참조하는 SwiftUI 상태/메뉴 심볼
디스어셈블리를 런타임 상태와 비교:
pgrep -af "App.app/Contents/MacOS/App"
lldb /path/to/debug/Binary
강화된 서명 앱의 경우 get-task-allow가 없으면 연결이 실패할 수 있습니다; 필요시 LLDB에서 원시 디버그 바이너리를 실행합니다.
실패 처리
- Hopper 호출에
timeout을 감싸십시오; 모달/가져오기 또는 닫힌 문서로 인해 전송이 멈출 수 있습니다. - 가져오기 중에 동시 Hopper MCP 요청을 보내지 마십시오. 질의가 무거우면 다른 질의를 시작하기 전에 완료될 때까지 기다리십시오.
- 호출이
Connection closed를 보고하면 Hopper 모달을 확인한 후 확인 후 재시도하십시오. - Hopper가 충돌하면 단일 문서를 다시 열고, 가져오기/분석이 완료될 때까지 기다린 후, 더 깊은 검색 전에
list_documents를 다시 실행하십시오. - mcporter가 멈춘 경우, 아무것도 종료하기 전에 프로세스를 검사하십시오:
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
- 광범위한 프로세스 종료보다 mcporter 데몬을 재시작하는 것을 선호합니다:
mcporter daemon stop
mcporter daemon start