IDA ProおよびGhidra用のTCP JSONブリッジサーバーで、デコンパイル、クロスリファレンス、シンボル、vtable、RTTI、メモリパッチングを外部スクリプトや自動化パイプラインに公開します。
IDA Pro と Ghidra 向けの軽量な TCP JSON ブリッジサーバーで、リバースエンジニアリングのワークフローをシンプルなソケットプロトコル経由で公開します。
外部ツール、CLI スクリプト、Python ユーティリティ、自動化パイプラインが、GUI を手動で操作することなく、デコンパイル、xref、シンボル、仮想テーブル、RTTI、構造体、メモリパッチを問い合わせることができます。
複数のバイナリを同時に開いて大規模なリバースエンジニアリングプロジェクトに取り組む場合(例:ゲームクライアント、ランチャー、DLL プロキシ、スタブを同時に開く場合):
BASE_PORT = 5073 からスキャンを開始し、利用可能なポートが見つかるまで連番のポート(5073、5074、5075、5076...)を自動的にプローブします。IDA Pro では、Python インタプリタは複数回のスクリプト実行にわたって存続します:
ID_Server.py は実行中のサーバーハンドルを builtins._ida_bridge_prev に登録します。stop() が自動的に呼び出され、そのスレッドを join(join(3.0))して、新しいサーバーを起動する前にポートをクリーンに解放します。Address already in use が発生したり、スレッドが孤立したりすることはありません。QUIT、STOP、EXIT、または SHUTDOWN を送信します。サーバーは {"ok": true, "shutdown": true} で確認し、直ちにクローズします。ida_bridge_stop() を呼び出すか、単に IDA を閉じます(デーモンスレッドは自動的に終了します)。is_cancelled() はソケットタイムアウトにより 1 秒ごとにチェックされます)、QUIT を送信します。.idb / .i64)を開きます。File -> Script file... / Alt+F7 経由)で、次を実行します:
import ID_Server
127.0.0.1:5073(または次に利用可能なポート)でリッスンを開始します。ida_bridge_stop()
Window -> Script Manager)で、Ghidra_Server.py を含むフォルダを追加するか、Python インタプリタで直接実行します。127.0.0.1:5073(または次に空いているポート)にバインドします。コマンドは TCP(127.0.0.1:<PORT>)経由で送信される、改行区切りのプレーンな文字列です。サーバは JSON オブジェクト(またはレガシーコマンドの場合はタブ区切りテキスト)で応答します。
| コマンド | 構文 | 説明 |
|---|---|---|
PING | PING | ヘルスチェック。"pong" を返します。 |
CURRENT | CURRENT | 現在のカーソルアドレス、関数名、サイズ、アセンブリ命令、およびデコンパイルされたコードを返します。 |
NAME | NAME <ea> | <ea> に定義されているシンボル/関数名を返します。 |
FUNC | FUNC <addr> | 完全な関数メタデータ、エントリポイント、サイズ、シグネチャ、アセンブリ、および Hex-Rays/Ghidra のデコンパイル結果を返します。 |
DECOMP | DECOMP <addr> | FUNC のエイリアス。対象関数をデコンパイルします。 |
DISASM | DISASM <ea> [n] | <ea> から始まる [n] 命令分の逆アセンブリ行を返します(デフォルト: 40)。 |
FIND | FIND <substr> | <substr> に一致するすべてのシンボルと関数名を大文字小文字を区別せずに検索します(最大300件)。 |
EXPORT | EXPORT [filename] | すべての非ダミーシンボル、マングル名およびデマングル名をテキストファイルにエクスポートします(デフォルト: ida_names.txt)。 |
HELP | HELP | サーバがサポートするすべての利用可能なコマンドの JSON リストを返します。 |
QUIT | QUIT | クライアント接続を正常に閉じ、ブリッジサーバソケットを停止します。 |
| コマンド | 構文 | 説明 |
|---|---|---|
XREF | XREF <addr> | <addr> を対象とするすべての受信クロスリファレンス(コード呼び出し、データ読み取り/書き込み)を一覧表示します。 |
XFROM | XFROM <addr> | <addr> から発信されるすべての送信クロスリファレンスを一覧表示します。 |
CALLERS | CALLERS <addr> | 受信リファレンスをフィルタリングし、呼び出しサイトのみ(解決済みの間接呼び出しを含む)を返します。 |
READERS | READERS <addr> | 受信リファレンスをフィルタリングし、<addr> から読み取る命令のみを返します。 |
WRITERS | WRITERS <addr> | 受信リファレンスをフィルタリングし、<addr> に書き込む命令のみを返します。 |
DECOMP_XREF | DECOMP_XREF <addr> | <addr> のすべての呼び出し元関数を1回のリクエストで一括デコンパイルします。 |
IMPORTXREF | IMPORTXREF <name> | インポートされた Windows/C API について、バイナリ全体のすべての呼び出しサイトを特定します(例: IMPORTXREF WSASendTo)。 |
TRACE | TRACE <addr> | <addr> 周辺の実行フローと基本ブロックをトレースします。 |
| コマンド | 構文 | 説明 |
|---|---|---|
READPTR | READPTR <addr> [count] | メモリをポインタチェーン(32ビットまたは64ビット)として読み取り、各ターゲットを分類します(func、string、vtable)。 |
FINDPTR | FINDPTR <addr> | グローバルデータとテーブルをスキャンし、<addr> を参照するポインタを検索します(vtable、ディスパッチテーブルを発見)。 |
STRUCT | STRUCT <addr> [n] | 連続したメモリをヒューリスティックにダンプし、フィールドを int、float、ポインタ、文字列として解釈します。 |
DEFSTRUCT | DEFSTRUCT <name> [size] | データベースの型ライブラリに新しい名前付き構造体を作成します。 |
SETFIELD | SETFIELD <struct> <off> <type> [name] | <off> の位置に <type> と任意のフィールド名で構造体フィールドを定義または変更します。 |
MKPTRS | MKPTRS <addr> [count] | 生のデータベースバイトを型付きポインタに一括変換します。 |
NEARSTR | NEARSTR <addr> | 範囲内のコードまたはデータセクションで近傍にある文字列参照を検索します。 |
| コマンド | 構文 | 説明 |
|---|---|---|
VTABLE | VTABLE <funcaddr> | <funcaddr> を含む仮想テーブルを、隣接するメソッドスロットも含めて特定します。 |
VTDUMP | VTDUMP <addr> [count] | 仮想テーブル全体をダンプし、各スロットをメソッド名、オフセット、インデックスに解決します。 |
RTTI | RTTI <addr|Name> | MSVC C++ RTTI 構造 (TypeDescriptor -> CompleteObjectLocator -> vftable) をたどり、クラス階層と基底クラスを解決します。 |
| コマンド | 構文 | 説明 |
|---|---|---|
STR | STR <ascii> | 読み込まれたすべてのセグメントから ASCII 文字列を検索します。 |
WSTR | WSTR <utf16> | 読み込まれたすべてのセグメントから UTF-16 ワイド文字列を検索します。 |
BYTES | BYTES <hex> | 生のオペコードまたはデータバイト列を検索します (例: BYTES 55 8B EC 83 EC)。 |
| コマンド | 構文 | 説明 |
|---|---|---|
RENAME_FUNC | RENAME_FUNC <addr> <name> | <addr> にある関数を <name> に名前変更します。 |
RENAME_SYMBOL | RENAME_SYMBOL <addr> <name> | グローバルデータシンボルまたは変数を名前変更します。 |
RENAME_LABEL | RENAME_LABEL <addr> <name> | コードラベルまたはジャンプ先を名前変更します。 |
RENAME_LOCAL | RENAME_LOCAL <func> <old> <new> | デコンパイラビュー内のローカル変数を名前変更します。 |
RETYPE | RETYPE <func> <var> <type> | デコンパイラ内の変数またはパラメータのデータ型を変更します (例: RETYPE 00401000 a1 Player*)。 |
SETCONV | SETCONV <func> <convention> | 呼び出し規約 (__cdecl、__stdcall、__fastcall、__thiscall) を設定します。 |
MAKEFUNC | MAKEFUNC <addr> | <addr> に関数の境界を強制的に作成します。 |
PATCH | PATCH <addr> <hex> | データベース内のバイトを直接上書きします (例: PATCH 00401234 90 90)。 |
PCODE | PCODE <addr> | 詳細なコンパイラ解析のために Hex-Rays マイクロコードまたは Ghidra P-Code 中間表現をダンプします。 |
import socket
import json
class BridgeClient:
def __init__(self, host="127.0.0.1", port=5073):
self.host = host
self.port = port
def send(self, cmd: str) -> dict:
s = socket.socket()
s.connect((self.host, self.port))
s.sendall((cmd + "\n").encode("utf-8"))
chunks = []
while True:
chunk = s.recv(16384)
if not chunk:
break
chunks.append(chunk)
if b"\n" in chunk:
break
s.close()
raw = b"".join(chunks).decode("utf-8", errors="ignore").strip()
try:
return json.loads(raw)
except json.JSONDecodeError:
return {"raw": raw}
# Example usage:
client = BridgeClient(port=5074)
# Decompile target function
res = client.send("FUNC 007B11C0")
if res.get("ok"):
print("Function Name:", res.get("function_name"))
print(res["code"][:300])
# Trace incoming callers
callers = client.send("CALLERS 007B11C0")
print("Total callers:", callers.get("count"))
MIT