super-trouper

Super Trouper

Frida リバースエンジニアリングツールキット用の MCP サーバーです。

Super Trouper は、コーディングエージェント向けのツールとして Frida の機能を公開する MCP サーバーを STDIO 経由で実行します。ローカル、USB、リモートのデバイスに接続し、アプリケーションやプロセスを調査し、プロセスセッションを管理できます。また、JavaScript の計装スクリプトを読み込み、評価し、メッセージをやり取りできます。Frida CodeShare を検索して、コミュニティのスクリプトを見つけ、スクリプト用ツールで使用するために取得することもできます。デバイス接続、セッション、スクリプトはツール自体を通じて管理し、不透明なハンドルで参照します。

機能

• 単一の Go バイナリ — ホストに Python、Node、Frida CLI ツールをインストールする必要はありません
• Frida 17.x を搭載 — Frida Core DevKit v17.23.3 に静的リンクされています
• あらゆるデバイスに対応 — ローカル、USB、リモートのデバイスを一覧表示して接続し、アプリやプロセスにアタッチできます
• TypeScript と JavaScript の計装 — Frida スクリプトを作成して読み込み、ターゲット内で直接評価できます
• Frida CodeShare との統合 — コミュニティスクリプトの CodeShare カタログを検索、閲覧、取得できます
• どこでも実行可能 — macOS と Linux 向けのビルド済みバイナリがあり、Docker、Homebrew、npm 経由でインストールできます

インストール

Homebrew

プロジェクトの Homebrew tap 経由で macOS 版をインストールします。

brew install --cask crissyfield/tap/super-trouper

npm

npm 経由でランチャーパッケージをインストールします。オプションの依存関係を通じて、プラットフォーム固有のバイナリが取得されます。

npm install -g @crissyfield/super-trouper

リリースバイナリ

お使いのプラットフォーム用のバイナリをリリースページ からダウンロードします。

ソースからのビルド

まず、ビルドホストに適合する Frida Core DevKit をインストールします。その後、以下のコマンドで Super Trouper をビルドしてインストールします。

# Set flags if the Frida devkit is not in a standard location
export CGO_CFLAGS="-I/path/to/frida-core-devkit/include"
export CGO_LDFLAGS="-L/path/to/frida-core-devkit/lib"

# Build and install
export CGO_ENABLED=1
go install github.com/crissyfield/super-trouper@latest

使い方

コーディングエージェントで MCP サーバーを使用します。以下では Claude Code を例にしていますが、Codex、OpenCode、Pi、Crush などでも設定方法は同様です。

バイナリを使用する場合

Super Trouper バイナリが PATH にない場合は、MCP サーバーの設定でフルパスを指定します。

{
  "mcpServers": {
    "super-trouper": {
      "command": "super-trouper"
    }
  }
}

npx を使用する場合

npm ユーザーは、グローバルインストールせずに npx 経由で Super Trouper を直接実行できます。

{
  "mcpServers": {
    "super-trouper": {
      "command": "npx",
      "args": ["-y", "@crissyfield/super-trouper"]
    }
  }
}

Docker を使用する場合

Docker を使えば、ホストにインストールせずに Super Trouper を簡単に実行できます。

{
  "mcpServers": {
    "super-trouper": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/crissyfield/super-trouper"]
    }
  }
}

MCP ツール

Super Trouper は、以下の MCP ツールを公開します。

ツール	説明
app_list	Frida デバイスにインストールされているアプリケーションの一覧を表示します。
app_find	識別子または名前を指定して、Frida デバイス上のアプリケーションを検索します。
app_frontmost	Frida デバイスで最前面に表示されているアプリケーションを返します。
codeshare_search	Frida CodeShare で、指定したクエリに一致するプロジェクトを検索します。
codeshare_popular	Frida CodeShare の人気プロジェクトの一覧を表示します。
codeshare_project	Frida CodeShare から、他のスクリプトツールで実行できる JavaScript ソースを含むプロジェクトを返します。
device_list	ホストが検出した Frida デバイスの一覧を表示します。
device_connect	device_list が報告した ID、リモート Frida サーバーのアドレス、または種類を指定して Frida デバイスに接続します。他のデバイスツールで使用するデバイスハンドルを返します。同じデバイスに再接続すると、既存のハンドルが返されます。
device_disconnect	Frida デバイスとの接続を解除します。デバイスにアタッチされたセッションが残っている場合は失敗します。
device_params	Frida デバイスのパラメーターを返します。
device_spawn	Frida デバイス上でプロセスを一時停止状態で起動します。起動するには device_resume を使用します。
device_resume	Frida デバイス上の一時停止中のプロセスを再開します。
device_kill	プロセスを終了します。
memory_read	アタッチされたプロセスのメモリを最大 4096 バイト読み取り、16 進数、base64、UTF-8、または NUL 終端の C 文字列として返します。範囲内のいずれかのバイトを読み取れない場合は失敗します。
memory_write	エンコーディングパラメーターで選択した形式（デフォルトは 16 進数、または base64）で、アタッチされたプロセスのメモリに最大 4096 バイトを書き込みます。メモリに書き込めない場合は失敗します。コードのパッチ適用は対象外です。
module_list	アタッチされたプロセスにロードされているモジュールの一覧を表示します。名前またはパスで照合でき、ページネーションにも対応しています。
package_install	script_create のソースからインポートするために、共有 Frida ワークスペースに npm パッケージをインストールします。
package_list	Super Trouper の共有 Frida ワークスペースにインストールされている直接依存の npm パッケージの一覧を表示します。
pattern_create	.hexpat または .pat ソースファイルから、管理対象の Frida Pattern プロジェクトを作成します。
pattern_read	管理対象の Frida Pattern プロジェクトからソースファイルを返します。
pattern_list	管理対象の Frida Pattern プロジェクトの一覧を表示します。
pattern_delete	管理対象の Frida Pattern プロジェクトを削除します。
pattern_describe	アタッチされたターゲット用に Pattern プロジェクトをコンパイルし、診断情報、型、入力を返します。
pattern_decode	管理対象の Frida Pattern プロジェクトを使用して、範囲を限定したターゲットメモリのスナップショットを読み取り、デコードします。
process_list	Frida デバイス上で実行中のプロセスの一覧を表示します。
script_create	アタッチされたセッションで TypeScript ソースを使用する Frida スクリプトを作成します。スクリプトは未ロードの状態で作成されます。ロードするには script_load を使用します。
script_load	Frida スクリプトを対象プロセスにロードします。
script_unload	対象プロセスから Frida スクリプトをアンロードします。
script_close	Frida スクリプトがロード済みの場合はアンロードし、そのリソースを解放します。
script_post	Frida スクリプトに JSON メッセージを送信します。
script_messages	Frida スクリプトから送信されたメッセージを返します。メッセージは最大 256 件バッファーされるため、定期的に取り出してください。
script_bridge_list	script_create で作成したスクリプト内でグローバルとして公開できる言語ブリッジの一覧を返します。
session_attach	PID または名前を指定して、Frida デバイス上のプロセスにアタッチします。セッションツールで使用するセッションハンドルを返します。
session_detach	プロセスからデタッチし、そのすべてのスクリプトとセッションを終了します。
session_eval	アタッチされたプロセス内で JavaScript 文を評価し、その JSON 結果を返します。最初の呼び出し時に、セッション内に永続的な評価器をセットアップします。
frida_version	リンクされた Frida Core ライブラリのバージョンを返します。
frida_documentation	Frida JavaScript API のドキュメントリンクを返します。
thread_list	アタッチされたプロセスで実行中のスレッドについて、ID、状態、プログラムカウンターとともに一覧を表示します。