Community研究&データ分析github.com

steipete/hopper-debugger

Hopper デバッグ: macOS/iOS バイナリ、ObjC/Swift シンボル、dyld、LLDB。

hopper-debugger とは?

このスキルは、`mcporter` を介して Hopper 逆アセンブラを MCP サーバーとして操作し、ローカルのソースコード、LLDB、ログ、再現テストと組み合わせて macOS/iOS バイナリの解析とデバッグを行うためのものです。ユーザーは Hopper を開かずとも、コマンドラインから手続きの検索、逆アセンブリ、擬似コードの取得、クロスリファレンスの確認が可能です。対応プラットフォームは macOS で、主に Claude Code や Cursor などの MCP 対応エージェントとの連携を想定しています。Apple フレームワーク(AppKit、SwiftUI)の dyld キャッシュから抽出したバイナリを直接開いて解析でき、ステータスバーメニューのクリック不具合など、具体的なバグ調査に役立ちます。Hopper のインポート中やモーダル表示時にはタイムアウトや接続エラーが発生する可能性があるため、タイムアウト設定、直列リクエスト、`mcporter` の再起動などの適切なエラーハンドリングが組み込まれています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/hopper-debugger

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 を識別します。

クエリワークフロー

  1. 説明しようとしているローカルソースパスまたはランタイムシンボルから始めます。
  2. 名前/手続き/文字列を検索:
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. 一度に 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
  1. 関連する制御フローを要約します。大きな逆コンパイル結果をそのまま貼り付けないでください。
  2. アプリコードを編集する前に、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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

関連スキル