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 キャッシュフレームワークバイナリを優先して使用:
/tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
/tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
SwiftUI/AppKit 境界の問題をデバッグする際は、一度に 1 つずつ開いてください:
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
- 一度に 1 つの小さなターゲットを調査:
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